Login dengan MyJNE
Login dengan MyJNE memungkinkan pengguna masuk ke aplikasi Anda memakai akun MyJNE mereka, tanpa membuat kata sandi baru. Aplikasi Anda menerima identitas pengguna yang sudah terverifikasi beserta data yang mereka setujui untuk dibagikan, misalnya nama, email, dan nomor HP.
Layanan ini dibangun di atas standar terbuka OAuth 2.0 dan OpenID Connect (OIDC), sehingga dapat dipakai dengan pustaka OIDC yang sudah tersedia di hampir semua bahasa pemrograman.
Yang Anda dapatkan
| Kemampuan | Penjelasan |
|---|---|
| Login satu akun | Pengguna masuk dengan akun MyJNE (email dan kode verifikasi). |
| Identitas terverifikasi | Email dan nomor HP yang diverifikasi MyJNE, beserta status verifikasinya. |
| Persetujuan pengguna | Pengguna memilih data apa yang boleh dibagikan ke aplikasi Anda. |
| Tetap terhubung | Refresh token agar aplikasi tidak perlu meminta login berulang kali. |
| Logout terpadu | Keluar dari MyJNE dari aplikasi Anda, dan pemberitahuan logout dari MyJNE ke server Anda. |
| Server ke server | Token untuk layanan backend tanpa melibatkan pengguna. |
Istilah penting
| Istilah | Arti |
|---|---|
| Client | Aplikasi Anda yang terdaftar di MyJNE. Memiliki client_id dan, untuk aplikasi server, client_secret. |
| Issuer | Alamat server MyJNE: https://athena.akropolis.my.id. |
| Redirect URI | Alamat di aplikasi Anda tempat pengguna dikembalikan setelah login. Harus didaftarkan lebih dulu. |
| Scope | Jenis data atau akses yang diminta, misalnya email. |
| Authorization code | Kode sekali pakai yang ditukar dengan token di server Anda. |
| Access token | Kunci untuk mengambil data pengguna dari endpoint userinfo. |
| ID token | Bukti identitas pengguna dalam format JWT yang ditandatangani MyJNE. |
| Refresh token | Kunci untuk mendapatkan access token baru tanpa login ulang. |
| PKCE | Pengaman tambahan yang wajib pada setiap login, mencegah kode dicuri dan dipakai pihak lain. |
Alur singkat
- Pengguna menekan tombol Login dengan MyJNE di aplikasi Anda.
- Aplikasi mengarahkan browser ke endpoint
authorizeMyJNE, disertai PKCE. - Pengguna masuk ke MyJNE dan, untuk aplikasi pihak ketiga, menyetujui data yang dibagikan.
- MyJNE mengembalikan browser ke redirect URI Anda dengan
code. - Server Anda menukar
codedi endpointtokendan menerimaaccess_token,id_token, sertarefresh_token(bila diminta). - Server Anda memverifikasi
id_token, lalu mengambil data pengguna di endpointuserinfobila perlu.
Lanjutkan ke Memulai untuk mendaftarkan aplikasi Anda.