Lewati ke konten utama

Server ke server (Client Credentials)

Untuk sistem backend yang memanggil API MyJNE atas nama aplikasinya sendiri, tanpa pengguna. Membutuhkan client jenis Layanan.

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-u "CLIENT_ID_ANDA:CLIENT_SECRET_ANDA" \
-d grant_type=client_credentials \
-d scope=shipment.read
{
"access_token": "Q1x8pV0mXk3tR9aZ...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "shipment.read"
}

Aturan:

  • Hanya scope API yang diberikan tim MyJNE untuk client Anda. Scope data pengguna (openid, profile, email, phone, offline_access) tidak berlaku dan akan ditolak dengan invalid_scope.
  • Tidak ada refresh token dan ID token. Minta token baru saat yang lama mendekati kedaluwarsa, dan pakai ulang token selama masih berlaku (jangan meminta token per request).
  • Client layanan dapat dibatasi ke daftar IP server Anda dan dibatasi jumlah permintaan per menit. Permintaan dari IP lain ditolak 403; melebihi batas ditolak 429 dengan header Retry-After.

Autentikasi dengan private_key_jwt​

Sebagai pengganti secret, Anda dapat mendaftarkan kunci publik dan menandatangani assertion JWT dengan kunci privat:

curl -X POST https://athena.akropolis.my.id/auth/v1/oauth2/token \
-d grant_type=client_credentials \
-d scope=shipment.read \
-d client_id=CLIENT_ID_ANDA \
-d client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer \
-d client_assertion=eyJhbGciOiJFUzI1NiIs...

Isi assertion: iss dan sub = client_id, aud = alamat endpoint token, jti acak, exp maksimal 5 menit ke depan.