Lewati ke konten utama

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​

ScopeData yang didapatCatatan
openidsub (ID pengguna) dan ID tokenWajib untuk login.
profilename, given_name, family_name
emailemail, email_verified
phonephone_number (format E.164, mis. +6281234567890), phone_number_verified
offline_accessrefresh_tokenSensitif. 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 scope di respons token. Pengguna atau kebijakan dapat memberikan scope lebih sedikit dari yang diminta; aplikasi harus tetap berjalan tanpa data opsional.