Memulai
1. Daftarkan aplikasi Anda
Pendaftaran client dilakukan oleh tim MyJNE. Kirimkan informasi berikut kepada kontak integrasi Anda:
| Informasi | Contoh | Keterangan |
|---|---|---|
| Nama aplikasi | Toko Mitra | Tampil di halaman persetujuan pengguna. |
| Jenis aplikasi | Aplikasi web dengan server | Lihat tabel jenis aplikasi di bawah. |
| Redirect URI | https://toko.example.com/auth/callback | Wajib https, tanpa wildcard dan tanpa fragmen #. Boleh lebih dari satu (maksimal 10). |
| Post-logout redirect URI | https://toko.example.com/ | Opsional, untuk kembali ke aplikasi setelah logout. |
| Scope yang dibutuhkan | openid profile email | Minta hanya yang benar-benar dipakai. |
| Back-channel logout URI | https://toko.example.com/auth/backchannel-logout | Opsional. Lihat Logout. |
| Origin CORS | https://toko.example.com | Hanya untuk aplikasi browser (SPA) yang memanggil endpoint token langsung. |
| URL kebijakan privasi dan syarat layanan | Tampil di halaman persetujuan. | |
| Kontak teknis | email tim Anda | Untuk pemberitahuan rotasi secret dan insiden. |
Anda akan menerima:
client_idclient_secret(hanya untuk aplikasi server). Secret ditampilkan satu kali. Simpan di secret manager, jangan di repository kode.
2. Pilih jenis aplikasi yang tepat
| Jenis | Contoh | Client rahasia? | Autentikasi ke endpoint token |
|---|---|---|---|
| Aplikasi web dengan server | Laravel, Spring, Express, Next.js (server) | Ya | client_secret_basic (disarankan) atau client_secret_post |
| Aplikasi browser (SPA) | React, Vue tanpa backend | Tidak | Hanya client_id + PKCE |
| Aplikasi mobile/desktop | Android, iOS, Flutter | Tidak | Hanya client_id + PKCE |
| Layanan (server ke server) | Sistem backend yang memanggil API MyJNE | Ya | client_secret_basic atau private_key_jwt |
Rekomendasi
Bila aplikasi Anda punya server, pakai jenis aplikasi web dengan server. Token tidak pernah sampai ke browser sehingga lebih aman.
3. Pisahkan client pengembangan dan production
Mintalah client terpisah untuk pengembangan/QA dan untuk production, masing-masing dengan redirect URI sendiri. Jangan memakai client_secret production di laptop atau server pengembangan. Lihat Pengujian.
4. Baca konfigurasi dari discovery
Semua alamat endpoint tersedia di dokumen discovery. Pustaka OIDC biasanya cukup diberi alamat issuer:
curl https://athena.akropolis.my.id/.well-known/openid-configuration
| Endpoint | Alamat |
|---|---|
| Authorization | https://athena.akropolis.my.id/auth/v1/oauth2/authorize |
| Token | https://athena.akropolis.my.id/auth/v1/oauth2/token |
| UserInfo | https://athena.akropolis.my.id/auth/v1/oauth2/userinfo |
| Introspeksi | https://athena.akropolis.my.id/auth/v1/oauth2/introspect |
| Pencabutan | https://athena.akropolis.my.id/auth/v1/oauth2/revoke |
| Logout | https://athena.akropolis.my.id/auth/v1/oauth2/end-session |
| JWKS | https://athena.akropolis.my.id/.well-known/jwks.json |
waspada
Jangan menuliskan alamat endpoint secara tetap di kode. Baca dari discovery agar aplikasi Anda tetap berjalan bila alamat berubah.
Selanjutnya: Alur login.