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):
| Nilai | Cara membuat | Kegunaan |
|---|---|---|
code_verifier | 32 byte acak, base64url (43 karakter) | Dibuktikan saat menukar code |
code_challenge | BASE64URL(SHA256(code_verifier)) | Dikirim ke authorize |
state | 16+ byte acak | Mencegah CSRF di callback |
nonce | 16+ byte acak | Mencegah 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
| Parameter | Wajib | Keterangan |
|---|---|---|
response_type | Ya | Selalu code. |
client_id | Ya | Dari pendaftaran. |
redirect_uri | Ya | Harus sama persis dengan yang terdaftar (skema, host, port, path, trailing slash). |
scope | Disarankan | Dipisah spasi, wajib memuat openid. Lihat Scope. |
state | Ya | Dicocokkan kembali di callback. |
nonce | Disarankan | Muncul kembali di klaim nonce ID token. |
code_challenge | Ya | Hasil langkah 1. |
code_challenge_method | Ya | Hanya S256. |
prompt | Tidak | none, 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:
statesama dengan yang Anda simpan. Bila tidak, hentikan.isssama denganhttps://athena.akropolis.my.id. Bila tidak, hentikan (mencegah mix-up attack).- 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
| Nilai | Perilaku |
|---|---|
| (kosong) | Bila pengguna sudah login di MyJNE dan sudah menyetujui scope, langsung kembali dengan code tanpa interaksi. |
none | Tanpa interaksi sama sekali. Bila pengguna belum login, kembali dengan error=login_required; bila belum menyetujui, error=consent_required. Cocok untuk memeriksa sesi diam-diam. |
login | Paksa pengguna memasukkan kredensial ulang, misalnya sebelum tindakan sensitif. |
consent | Paksa tampilkan halaman persetujuan lagi. |
select_account | Minta pengguna memilih akun. |