Lewati ke konten utama

Alur login (Authorization Code + PKCE)

Ini satu-satunya alur login pengguna yang didukung. PKCE wajib untuk semua client, termasuk client rahasia.

Langkah 1: Buat PKCE, state, dan nonce​

Buat tiga nilai acak per percobaan login dan simpan di sesi pengguna (cookie sesi server, atau sessionStorage untuk SPA):

NilaiCara membuatKegunaan
code_verifier32 byte acak, base64url (43 karakter)Dibuktikan saat menukar code
code_challengeBASE64URL(SHA256(code_verifier))Dikirim ke authorize
state16+ byte acakMencegah CSRF di callback
nonce16+ byte acakMencegah replay ID token
import { createHash, randomBytes } from "node:crypto";

const codeVerifier = randomBytes(32).toString("base64url");
const codeChallenge = createHash("sha256").update(codeVerifier).digest("base64url");
const state = randomBytes(16).toString("base64url");
const nonce = randomBytes(16).toString("base64url");

Langkah 2: Arahkan pengguna ke authorize​

GET https://athena.akropolis.my.id/auth/v1/oauth2/authorize
?response_type=code
&client_id=CLIENT_ID_ANDA
&redirect_uri=https%3A%2F%2Ftoko.example.com%2Fauth%2Fcallback
&scope=openid%20profile%20email
&state=af0ifjsldkj
&nonce=n-0S6_WzA2Mj
&code_challenge=YfqFYaSH8nInOCEOSVyfp31nKmjyoMhXj0-Ohio-3HA
&code_challenge_method=S256
ParameterWajibKeterangan
response_typeYaSelalu code.
client_idYaDari pendaftaran.
redirect_uriYaHarus sama persis dengan yang terdaftar (skema, host, port, path, trailing slash).
scopeDisarankanDipisah spasi, wajib memuat openid. Lihat Scope.
stateYaDicocokkan kembali di callback.
nonceDisarankanMuncul kembali di klaim nonce ID token.
code_challengeYaHasil langkah 1.
code_challenge_methodYaHanya S256.
promptTidaknone, login, consent, atau select_account. Lihat di bawah.

Pakai redirect penuh halaman, bukan iframe atau popup yang disematkan. Di aplikasi mobile, buka di browser sistem (Custom Tabs / ASWebAuthenticationSession), bukan WebView.

Langkah 3: Terima callback​

Setelah login berhasil, browser kembali ke redirect URI Anda:

https://toko.example.com/auth/callback?code=XLf7Q7J4qokV2EqAychtikUqsHTIVBko&state=af0ifjsldkj&iss=https%3A%2F%2Fathena.akropolis.my.id

Wajib diperiksa sebelum melanjutkan:

  1. state sama dengan yang Anda simpan. Bila tidak, hentikan.
  2. iss sama dengan https://athena.akropolis.my.id. Bila tidak, hentikan (mencegah mix-up attack).
  3. Bila ada parameter error, tampilkan pesan yang ramah dan jangan tukar code. Lihat Kode error.

Contoh pengguna menolak persetujuan:

https://toko.example.com/auth/callback?error=access_denied&error_description=User+denied+access&state=af0ifjsldkj&iss=https%3A%2F%2Fathena.akropolis.my.id

Langkah 4: Tukar code dengan token (dari server)​

code berlaku 10 menit dan sekali pakai. Menukar code yang sama dua kali menyebabkan semua token dari code tersebut dicabut.

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d grant_type=authorization_code \
-d code=XLf7Q7J4qokV2EqAychtikUqsHTIVBko \
-d redirect_uri=https://toko.example.com/auth/callback \
-d code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk

Client publik (SPA/mobile) tidak memakai -u, tetapi mengirim client_id di body.

{
"access_token": "cTpylaDwOVKXhSbFwGzpZYpatPIhSCZF",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "vGIksssdEpIALYkxNtWHRMWsOscDoEqG",
"scope": "openid profile email offline_access",
"id_token": "eyJhbGciOiJFUzI1NiIsImtpZCI6Ii4uLiJ9.eyJ..."
}

Langkah 5: Verifikasi ID token dan buat sesi​

Verifikasi ID token (lihat Token), lalu pakai klaim sub sebagai ID pengguna di sistem Anda. Buat sesi aplikasi Anda sendiri; jangan menyimpan token MyJNE di cookie yang bisa dibaca JavaScript.

Parameter prompt​

NilaiPerilaku
(kosong)Bila pengguna sudah login di MyJNE dan sudah menyetujui scope, langsung kembali dengan code tanpa interaksi.
noneTanpa interaksi sama sekali. Bila pengguna belum login, kembali dengan error=login_required; bila belum menyetujui, error=consent_required. Cocok untuk memeriksa sesi diam-diam.
loginPaksa pengguna memasukkan kredensial ulang, misalnya sebelum tindakan sensitif.
consentPaksa tampilkan halaman persetujuan lagi.
select_accountMinta pengguna memilih akun.