Scope dan persetujuan
Scope menentukan data apa yang boleh diakses aplikasi Anda. Aplikasi hanya bisa meminta scope yang diizinkan untuk client-nya saat pendaftaran.
Scope standar
| Scope | Data yang didapat | Catatan |
|---|---|---|
openid | sub (ID pengguna) dan ID token | Wajib untuk login. |
profile | name, given_name, family_name | |
email | email, email_verified | |
phone | phone_number (format E.164, mis. +6281234567890), phone_number_verified | |
offline_access | refresh_token | Sensitif. Minta hanya bila aplikasi perlu bekerja saat pengguna tidak aktif. |
Daftar lengkap scope yang tersedia selalu ada di scopes_supported pada dokumen discovery. Scope API untuk server ke server diberikan oleh tim MyJNE sesuai kebutuhan integrasi.
Halaman persetujuan
- Aplikasi pihak ketiga (partner): pengguna melihat halaman persetujuan berisi nama aplikasi dan daftar data yang diminta, lalu memilih Izinkan atau Tolak.
- Persetujuan disimpan. Login berikutnya dengan scope yang sama atau lebih sedikit tidak menampilkan halaman persetujuan lagi.
- Bila aplikasi meminta scope baru, halaman persetujuan muncul lagi untuk scope tersebut.
- Persetujuan dapat dicabut. Setelah dicabut, refresh token aplikasi Anda tidak berlaku lagi dan login berikutnya akan menampilkan persetujuan.
Prinsip meminta scope
- Minta sesedikit mungkin. Semakin sedikit data yang diminta, semakin tinggi tingkat persetujuan pengguna.
- Selalu periksa field
scopedi respons token. Pengguna atau kebijakan dapat memberikan scope lebih sedikit dari yang diminta; aplikasi harus tetap berjalan tanpa data opsional.