Logout
Ada tiga tingkat logout. Pilih sesuai kebutuhan aplikasi Anda.
| Tingkat | Yang terjadi | Cara |
|---|---|---|
| Keluar dari aplikasi Anda saja | Sesi aplikasi berakhir, pengguna tetap login di MyJNE | Hapus sesi aplikasi + cabut token |
| Keluar dari MyJNE juga | Sesi MyJNE berakhir | Arahkan ke endpoint end-session |
| Diberi tahu saat pengguna keluar di MyJNE | Server Anda menerima pemberitahuan | Back-channel logout |
Keluar dari MyJNE (RP-Initiated Logout)
Hapus sesi aplikasi Anda, lalu arahkan browser ke:
GET https://athena.akropolis.my.id/auth/v1/oauth2/end-session
?client_id=CLIENT_ID_ANDA
&id_token_hint=eyJhbGciOiJFUzI1NiIs...
&post_logout_redirect_uri=https%3A%2F%2Ftoko.example.com%2F
&state=xyz
| Parameter | Wajib | Keterangan |
|---|---|---|
client_id | Ya | |
id_token_hint | Disarankan | ID token terakhir pengguna. Tanpa ini, pengguna diminta mengonfirmasi logout. |
post_logout_redirect_uri | Tidak | Harus sama persis dengan yang didaftarkan. Bila kosong atau tidak terdaftar, pengguna melihat halaman "Anda telah keluar" di MyJNE. |
state | Tidak | Dikembalikan apa adanya ke post_logout_redirect_uri. |
Back-channel logout
Bila Anda mendaftarkan back-channel logout URI, MyJNE mengirim POST dari server ke server setiap kali sesi MyJNE pengguna diakhiri (logout atau sesi dicabut).
POST /auth/backchannel-logout HTTP/1.1
Host: toko.example.com
Content-Type: application/x-www-form-urlencoded
logout_token=eyJhbGciOiJFUzI1NiIs...
Isi logout_token (JWT ES256, berlaku 2 menit):
{
"iss": "https://athena.akropolis.my.id",
"aud": "CLIENT_ID_ANDA",
"sub": "lUV6xHS9qzY2vHFWsDe3y9mQqHEoB2Pm",
"sid": "WEkdukbCYObhPT90c57X68rIk1GmcFKc",
"iat": 1795010000,
"exp": 1795010120,
"jti": "5b2c6f0e-8f8a-4d7f-9a7e-2f1d2c3b4a5e",
"events": { "http://schemas.openid.net/event/backchannel-logout": {} }
}
Yang harus dilakukan server Anda:
- Verifikasi tanda tangan dengan JWKS,
iss,aud, danexp, seperti ID token. - Pastikan klaim
eventsmemuathttp://schemas.openid.net/event/backchannel-logoutdan tidak ada klaimnonce. - Tolak
jtiyang pernah diterima (simpan selama 2 menit). - Akhiri semua sesi aplikasi yang terkait
sidtersebut (atausubbila Anda tidak menyimpansid). - Jawab
200dengan cepat. Endpoint harus dapat diakses publik melalui HTTPS dan tidak memerlukan cookie.
Agar bisa mencocokkan sid, simpan klaim sid dari ID token saat membuat sesi aplikasi.