Lewati ke konten utama

Token

TokenFormatMasa berlakuKegunaan
Authorization codeAcak10 menit, sekali pakaiDitukar di endpoint token
Access tokenAcak (buram, bukan JWT)1 jamMemanggil userinfo
ID tokenJWT ES25610 jamBukti identitas pengguna untuk aplikasi Anda
Refresh tokenAcak30 hari, sekali pakaiMendapatkan access token baru
Access token bersifat buram

Jangan mencoba membaca isi access token. Untuk mengetahui apakah masih berlaku, pakai introspeksi.

Memverifikasi ID token​

ID token adalah JWT yang ditandatangani dengan ES256 (ECDSA P-256). Contoh isi:

{
"iss": "https://athena.akropolis.my.id",
"sub": "lUV6xHS9qzY2vHFWsDe3y9mQqHEoB2Pm",
"aud": "CLIENT_ID_ANDA",
"nonce": "n-0S6_WzA2Mj",
"iat": 1795008486,
"exp": 1795044486,
"auth_time": 1795008486,
"at_hash": "uSX2zP7hhrmlkhIi-BCx7Q",
"acr": "0",
"sid": "WEkdukbCYObhPT90c57X68rIk1GmcFKc"
}

Pemeriksaan wajib:

  1. Tanda tangan valid terhadap kunci di jwks_uri dengan kid di header. Tolak alg selain ES256.
  2. iss sama dengan https://athena.akropolis.my.id.
  3. aud sama dengan client_id Anda.
  4. exp belum lewat (beri toleransi jam maksimal 60 detik).
  5. nonce sama dengan yang Anda kirim di authorize.
KlaimArti
subID pengguna yang stabil. Pakai ini sebagai kunci akun, bukan email (email bisa berubah).
sidID sesi MyJNE. Dipakai untuk mencocokkan back-channel logout.
auth_timeWaktu pengguna terakhir benar-benar login.
at_hashHash access token yang terbit bersamaan.

Pustaka JWT yang umum (jose, firebase/php-jwt, golang-jwt, nimbus-jose-jwt) dapat mengambil JWKS dan memeriksa semua poin di atas. Simpan JWKS di cache; bila menemukan kid yang belum dikenal, ambil ulang JWKS karena kunci diputar berkala.

Refresh token​

Tersedia bila scope offline_access disetujui.

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d grant_type=refresh_token \
-d refresh_token=vGIksssdEpIALYkxNtWHRMWsOscDoEqG
  • Setiap pemakaian menghasilkan refresh token baru; yang lama langsung tidak berlaku (invalid_grant). Selalu simpan refresh token terbaru.
  • Bila dua proses memperbarui token bersamaan, hanya satu yang berhasil. Lindungi pembaruan dengan lock per pengguna.
  • invalid_grant saat refresh berarti pengguna harus login ulang (refresh token kedaluwarsa, sudah dipakai, persetujuan dicabut, sesi dicabut, atau akun dinonaktifkan).

Introspeksi​

Memeriksa apakah sebuah token masih berlaku. Dipakai bila server API Anda menerima access token MyJNE dari aplikasi lain milik Anda.

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/introspect \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d token=cTpylaDwOVKXhSbFwGzpZYpatPIhSCZF \
-d token_type_hint=access_token
{
"active": true,
"client_id": "CLIENT_ID_ANDA",
"sub": "lUV6xHS9qzY2vHFWsDe3y9mQqHEoB2Pm",
"scope": "openid profile email",
"token_type": "Bearer",
"iat": 1795008486,
"exp": 1795012086
}

Token yang tidak dikenal, kedaluwarsa, atau dicabut dijawab {"active": false}. Simpan hasil introspeksi di cache singkat (mis. 60 detik) untuk mengurangi beban.

Pencabutan​

Cabut token saat pengguna keluar dari aplikasi Anda atau memutus hubungan akun.

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/revoke \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d token=vGIksssdEpIALYkxNtWHRMWsOscDoEqG \
-d token_type_hint=refresh_token

Selalu menjawab 200 bila autentikasi client berhasil, termasuk untuk token yang sudah tidak berlaku, sehingga aman dipanggil ulang.

Menyimpan token dengan aman​

LingkunganSimpan di
ServerDatabase/secret store terenkripsi, tidak pernah di log
SPAMemori JavaScript; jangan localStorage
AndroidEncryptedSharedPreferences / Keystore
iOSKeychain