Lewati ke konten utama

Memulai

1. Daftarkan aplikasi Anda​

Pendaftaran client dilakukan oleh tim MyJNE. Kirimkan informasi berikut kepada kontak integrasi Anda:

InformasiContohKeterangan
Nama aplikasiToko MitraTampil di halaman persetujuan pengguna.
Jenis aplikasiAplikasi web dengan serverLihat tabel jenis aplikasi di bawah.
Redirect URIhttps://toko.example.com/auth/callbackWajib https, tanpa wildcard dan tanpa fragmen #. Boleh lebih dari satu (maksimal 10).
Post-logout redirect URIhttps://toko.example.com/Opsional, untuk kembali ke aplikasi setelah logout.
Scope yang dibutuhkanopenid profile emailMinta hanya yang benar-benar dipakai.
Back-channel logout URIhttps://toko.example.com/auth/backchannel-logoutOpsional. Lihat Logout.
Origin CORShttps://toko.example.comHanya untuk aplikasi browser (SPA) yang memanggil endpoint token langsung.
URL kebijakan privasi dan syarat layananTampil di halaman persetujuan.
Kontak teknisemail tim AndaUntuk pemberitahuan rotasi secret dan insiden.

Anda akan menerima:

  • client_id
  • client_secret (hanya untuk aplikasi server). Secret ditampilkan satu kali. Simpan di secret manager, jangan di repository kode.

2. Pilih jenis aplikasi yang tepat​

JenisContohClient rahasia?Autentikasi ke endpoint token
Aplikasi web dengan serverLaravel, Spring, Express, Next.js (server)Yaclient_secret_basic (disarankan) atau client_secret_post
Aplikasi browser (SPA)React, Vue tanpa backendTidakHanya client_id + PKCE
Aplikasi mobile/desktopAndroid, iOS, FlutterTidakHanya client_id + PKCE
Layanan (server ke server)Sistem backend yang memanggil API MyJNEYaclient_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
EndpointAlamat
Authorizationhttps://athena.akropolis.my.id/auth/v1/oauth2/authorize
Tokenhttps://athena.akropolis.my.id/auth/v1/oauth2/token
UserInfohttps://athena.akropolis.my.id/auth/v1/oauth2/userinfo
Introspeksihttps://athena.akropolis.my.id/auth/v1/oauth2/introspect
Pencabutanhttps://athena.akropolis.my.id/auth/v1/oauth2/revoke
Logouthttps://athena.akropolis.my.id/auth/v1/oauth2/end-session
JWKShttps://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.