Data pengguna

Setiap aplikasi menerima objek user yang sama dari /oauth/token dan /oauth/userinfo. Halaman ini menjelaskan isinya dan cara menautkan akun dengan benar.

Kolom

{
  "sentra_id": "8f3a1c52-7d0e-4b6a-9c21-5e7f0a3d9b14",
  "name": "Aisyah Rahmawati",
  "picture": "https://api.sso.sentratechnology.com/files/8f3a1c52.jpg",
  "credential": "aisyah.rahmawati@contoh.id",
  "roles": ["editor"],
  "user_types": ["umum"]
}
KolomTipeIsi
sentra_idstring (UUID)ID tetap pengguna di Sentra. Tidak pernah berubah.
namestringNama lengkap. Pengguna bisa mengubahnya.
picturestring atau nullURL foto profil, atau null jika belum ada.
credentialstringEmail akun, atau username jika akun tidak punya email.
rolesstring[]Peran pengguna di aplikasi Anda. Boleh kosong.
user_typesstring[]Tipe pengguna, misalnya umum. Boleh kosong.

Data dibaca saat kode ditukar, jadi setiap kali pengguna masuk Anda mendapat data terbaru. Perbarui name dan picture di aplikasi Anda pada saat itu.

sentra_id

Jadikan sentra_id kunci pengguna di aplikasi Anda. Nilainya tetap sama walau pengguna mengganti nama, email, atau username. Akun di Sentra tidak pernah dihapus, hanya dinonaktifkan, jadi sentra_id tidak akan dipakai orang lain.

credential

credential berisi pengenal masuk akun: email jika akun punya email, jika tidak username. Akun yang dibuat admin atau lewat impor bisa saja tidak punya email.

Gunakan credential hanya untuk ditampilkan. Jangan menganggapnya selalu alamat email, dan jangan pernah menautkan akun berdasarkan kolom ini. Email di Sentra tidak diverifikasi, dan nilai credential bisa berubah jika pengguna menambah atau mengganti email.

roles

roles berisi kunci peran dari katalog Peran aplikasi Anda di konsol, yang diberikan admin Sentra kepada pengguna ini. Isinya:

  • Hanya peran untuk aplikasi Anda, bukan peran di aplikasi lain.
  • Hanya kunci, misalnya editor, bukan nama tampilannya.
  • Informasi, bukan izin. Aplikasi Anda yang memutuskan apa yang boleh dilakukan setiap peran.

Pengguna yang belum diberi peran menerima roles: [].

user_types

user_types berisi tipe pengguna yang diatur admin Sentra untuk seluruh layanan, misalnya umum. Sama seperti roles, ini hanya informasi.

Yang tidak dikirim

  • Nomor telepon.
  • Peran pengguna di Sentra sendiri (misalnya pengembang atau admin).
  • Peran pengguna di aplikasi lain.
  • Kata sandi, dalam bentuk apa pun.

Format pengenal

Pengguna bisa masuk ke Sentra dengan email, nomor telepon, atau username. Formatnya tidak bisa saling bertabrakan:

PengenalFormat
EmailSelalu berisi @. Wajib saat mendaftar sendiri, opsional untuk akun buatan admin atau impor.
TeleponDisimpan dalam format internasional dengan +, misalnya +6281234567890. Masukan 0812… diubah menjadi +62812….
Username3–64 karakter: huruf kecil, angka, titik, garis bawah, atau tanda hubung. Tidak pernah berisi @ atau +.

Username yang hanya berisi angka hanya bisa dibuat oleh admin Sentra atau lewat impor. Username yang dipilih pengguna saat mendaftar sendiri selalu berisi huruf.

Urutan pencarian saat masuk

Sentra mencari akun dari apa yang diketik pengguna dengan urutan berikut:

  1. Berisi @: dicari sebagai email.
  2. Diawali +: dicari sebagai nomor telepon.
  3. Selain itu: dicari sebagai username. Jika tidak ada dan masukan diawali 0 seperti nomor telepon lokal, Sentra mencarinya sebagai nomor telepon.

Jika satu masukan cocok dengan dua akun, username yang menang. Contoh: jika ada akun dengan username 081234567890, masukan 081234567890 membuka akun itu, bukan akun dengan nomor telepon +6281234567890.

Menautkan akun

  1. Simpan sentra_id di pengguna lokal (kolom unik yang boleh kosong) dan cari pengguna hanya berdasarkan kolom itu.
  2. Jika belum ada pengguna lokal dengan sentra_id itu, buat pengguna baru atau tampilkan pesan "akun belum terdaftar", sesuai kebijakan aplikasi Anda. Jangan pernah menautkan otomatis berdasarkan email, username, atau credential.
  3. Untuk menautkan pengguna lama sebelum mereka masuk pertama kali, simpan kolom sentra_id dari hasil impor. Lihat Impor pengguna.
  4. Gabungkan akun ganda dengan alat admin di aplikasi Anda sendiri.

Contoh kode ada di tutorial Laravel dan Next.js.