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"]
}| Kolom | Tipe | Isi |
|---|---|---|
sentra_id | string (UUID) | ID tetap pengguna di Sentra. Tidak pernah berubah. |
name | string | Nama lengkap. Pengguna bisa mengubahnya. |
picture | string atau null | URL foto profil, atau null jika belum ada. |
credential | string | Email akun, atau username jika akun tidak punya email. |
roles | string[] | Peran pengguna di aplikasi Anda. Boleh kosong. |
user_types | string[] | 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.
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:
| Pengenal | Format |
|---|---|
Selalu berisi @. Wajib saat mendaftar sendiri, opsional untuk akun buatan admin atau impor. | |
| Telepon | Disimpan dalam format internasional dengan +, misalnya +6281234567890. Masukan 0812… diubah menjadi +62812…. |
| Username | 3–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:
- Berisi
@: dicari sebagai email. - Diawali
+: dicari sebagai nomor telepon. - Selain itu: dicari sebagai username. Jika tidak ada dan masukan diawali
0seperti 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
- Simpan
sentra_iddi pengguna lokal (kolom unik yang boleh kosong) dan cari pengguna hanya berdasarkan kolom itu. - Jika belum ada pengguna lokal dengan
sentra_iditu, buat pengguna baru atau tampilkan pesan "akun belum terdaftar", sesuai kebijakan aplikasi Anda. Jangan pernah menautkan otomatis berdasarkan email, username, ataucredential. - Untuk menautkan pengguna lama sebelum mereka masuk pertama kali, simpan kolom
sentra_iddari hasil impor. Lihat Impor pengguna. - Gabungkan akun ganda dengan alat admin di aplikasi Anda sendiri.