Field ekstensi akun - Identity as a Service - Alibaba Cloud Documentation Center

IDaaS EIAM mendukung dua jenis field akun: basic fields yang telah ditentukan oleh sistem dan extension fields yang Anda buat untuk menyimpan atribut pengguna tambahan seperti ID karyawan, departemen, atau wilayah.

Setelah dibuat, extension fields dapat digunakan oleh aplikasi melalui tiga cara: diambil melalui Dev/OpenAPI untuk sinkronisasi, disertakan dalam id_token OIDC dan titik akhir UserInfo setelah SSO, atau dikembalikan dalam SAML Attribute Statements.

Field dasar

Field dasar adalah field yang telah ditentukan sistem untuk menangkap informasi pengguna standar seperti username, alamat email, dan nomor telepon. Field ini tidak dapat ditambahkan atau dihapus—hanya visibilitas dan kemampuan editnya yang dapat dikonfigurasi, dan hanya berlaku untuk tiga field: nama tampilan pengguna, email pengguna, dan nomor telepon.

Lihat field dasar

Masuk ke Konsol IDaaS. Di panel navigasi, pilih Konsol IDaaS EIAM, lalu pilih instans IDaaS Anda dan klik Manage.
Buka Account > Field Management > Basic Fields.
Untuk hanya melihat field yang dapat diedit pengguna, pilih Editable Fields Only di sebelah kiri.

Daftar field dasar mencakup kolom-kolom berikut:

Kolom	Deskripsi
Field display name	Label yang ditampilkan di antarmuka pengguna
Field ID	Identifier internal yang digunakan oleh sistem
Data type	Selalu `String` untuk field dasar
Required	Apakah field tersebut wajib diisi
Unique	Apakah nilai field harus unik di seluruh akun
User permissions	Apakah pengguna akhir dapat melihat atau mengedit field: Invisible, Visible, atau Editable
Actions	Hanya tersedia untuk nama tampilan pengguna, email pengguna, dan nomor telepon

Konfigurasikan izin pengguna untuk field dasar

Hanya tiga field dasar yang mendukung perubahan izin: user display name, user email, dan phone number.

Di tab Basic Fields, temukan field yang ingin Anda perbarui.
Klik Modify di kolom Actions.
Di dialog Edit Field, atur User Permissions:
- Invisible — field disembunyikan dari pengguna
- Visible — pengguna dapat melihat nilai field tetapi tidak dapat mengeditnya
- Editable — pengguna dapat melihat dan memperbarui nilai mereka sendiri
Klik OK untuk menyimpan.

Extension fields

Extension fields memungkinkan Anda menyimpan atribut pengguna kustom di luar field dasar bawaan. Contoh umum termasuk ID karyawan, tanggal lahir, dan wilayah.

Hanya extension fields akun yang didukung. Extension fields untuk tipe entitas lain (seperti kelompok atau organisasi) tidak didukung.

Buat extension field

Buka Account > Field Management > Extended Fields.
Klik Create Field dan isi formulir:

Pengaturan umum

Field	Deskripsi	Dapat diedit setelah pembuatan
Field display name	Label yang ditampilkan di UI	Ya
Field ID	Identifier unik untuk field ini. Gunakan hanya huruf kecil dan garis bawah; tidak boleh diawali dengan garis bawah. Nilai ini dipetakan ke kunci field yang digunakan dalam konfigurasi API dan SSO.	Tidak
Field type	Mengontrol cara field dirender: Input box, Drop-down list, atau Checkbox	Tidak
Field description	(Opsional) Teks penjelasan yang ditampilkan di bawah field	Ya
Required	Jika dipilih, field ini harus diisi untuk semua operasi pembuatan dan pengeditan akun. Jika Anda telah mengonfigurasi penyedia identitas (IdP) untuk impor akun dan menambahkan field wajib baru, Anda harus membuka halaman Identity Provider untuk menambahkan pemetaan field. Jika tidak, sinkronisasi akan gagal.	Tidak
Unique	Apakah nilai field harus unik dalam instans ini. Pilih opsi ini untuk field seperti ID karyawan.	Tidak
Encryption	Mengenkripsi data field sebelum menyimpannya. Gunakan ini untuk atribut sensitif guna mengurangi risiko paparan.	Tidak
User permissions	Mengontrol akses pengguna akhir ke field ini: Invisible, Visible, atau Editable.	Ya

Field type: Input box

Parameter	Deskripsi	Dapat diedit setelah pembuatan
Data type	`String` atau `Number`	Tidak
Default value	Nilai yang digunakan ketika tidak ada input yang diberikan. Setara dengan kendala `DEFAULT` dalam database relasional.	Ya

Field type: Drop-down list

Parameter	Deskripsi	Dapat diedit setelah pembuatan
Data type	`String` atau `Number`	Tidak
Data items	Pasangan kunci-nilai untuk opsi dropdown. Kunci adalah nilai yang disimpan; nama tampilan adalah yang dilihat pengguna. Misalnya, Anda dapat menyimpan kunci `1` dan menampilkannya sebagai `Small`.	Tambah: Ya / Nonaktifkan atau aktifkan: Ya / Hapus: Tidak / Ubah kunci: Tidak / Ubah nama tampilan: Ya
Default value	Kunci dari opsi yang dipilih secara default	Ya

Data items tidak dapat dihapus setelah pembuatan. Untuk menghapus opsi dari dropdown, nonaktifkan saja. Nilai field yang sudah ada tidak terpengaruh saat item dinonaktifkan.

Field type: Checkbox

Menggunakan parameter dan aturan editabilitas yang sama seperti drop-down list.

Klik OK untuk membuat field.

Isi extension fields untuk akun

Setelah membuat dan mengaktifkan field:

Buka Accounts And Orgs dan klik Create Account.
Di dialog pembuatan akun, beralih ke tab Extended Field.
Masukkan nilai untuk extension fields, lalu kirim formulir.

Self-service pengguna

Pengguna dapat melihat dan mengedit nilai extension field mereka sendiri dari portal pengguna:

Field Visible muncul di My Account > Extended Information (read-only).
Field Editable menyertakan opsi modifikasi sehingga pengguna dapat memperbarui nilai mereka sendiri.

Ambil extension fields di aplikasi

Aplikasi dapat mengakses data extension field melalui tiga metode:

Metode	Dikembalikan secara default	Konfigurasi diperlukan
Dev/OpenAPI	Ya — semua extension fields dikembalikan tanpa konfigurasi tambahan	Tidak diperlukan. Lihat dokumentasi API.
OIDC SSO (`id_token` / UserInfo endpoint)	Tidak	Di pengaturan `id_token` yang diperluas, tambahkan field menggunakan format `user.customFieldMap.$field key value$.fieldValue`. Titik akhir UserInfo mengembalikan klaim yang sama seperti `id_token`.
SAML SSO (Attribute Statements)	Tidak	Di konfigurasi Attribute Statements aplikasi, tambahkan atribut kustom untuk menyertakan nilai extension field dalam SAMLResponse.