Token
| Token | Format | Masa berlaku | Kegunaan |
|---|---|---|---|
| Authorization code | Acak | 10 menit, sekali pakai | Ditukar di endpoint token |
| Access token | Acak (buram, bukan JWT) | 1 jam | Memanggil userinfo |
| ID token | JWT ES256 | 10 jam | Bukti identitas pengguna untuk aplikasi Anda |
| Refresh token | Acak | 30 hari, sekali pakai | Mendapatkan access token baru |
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:
- Tanda tangan valid terhadap kunci di
jwks_uridengankiddi header. TolakalgselainES256. isssama denganhttps://athena.akropolis.my.id.audsama denganclient_idAnda.expbelum lewat (beri toleransi jam maksimal 60 detik).noncesama dengan yang Anda kirim di authorize.
| Klaim | Arti |
|---|---|
sub | ID pengguna yang stabil. Pakai ini sebagai kunci akun, bukan email (email bisa berubah). |
sid | ID sesi MyJNE. Dipakai untuk mencocokkan back-channel logout. |
auth_time | Waktu pengguna terakhir benar-benar login. |
at_hash | Hash 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_grantsaat 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
| Lingkungan | Simpan di |
|---|---|
| Server | Database/secret store terenkripsi, tidak pernah di log |
| SPA | Memori JavaScript; jangan localStorage |
| Android | EncryptedSharedPreferences / Keystore |
| iOS | Keychain |