Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk: 
Penyewa Tenaga Kerja 
Penyewa Eksternal (pelajari lebih lanjut)
Atribut pengguna yang Anda kumpulkan selama pendaftaran disimpan dengan profil pengguna di direktori Anda. Anda dapat memilih dari atribut pengguna bawaan atau membuat atribut pengguna kustom.
Atribut pengguna bawaan, seperti kota, negara/wilayah, alamat email, dan sebagainya, tersedia di ID Eksternal Microsoft Entra. Anda dapat memilih atribut pengguna bawaan yang ingin Anda kumpulkan selama pendaftaran.
Untuk informasi tambahan apa pun yang ingin Anda kumpulkan, Anda dapat membuat atribut pengguna kustom. Beberapa kontrol input kustom dapat ditambahkan ke halaman pendaftaran untuk mengumpulkan atribut, termasuk kotak teks, tombol radio, dan kotak centang. Contoh berikut menunjukkan bagaimana kontrol input kustom dapat digunakan untuk mengumpulkan atribut untuk nomor loyalitas, persetujuan ketentuan penggunaan untuk ketentuan penggunaan, dan persetujuan kebijakan privasi.
Atribut pengguna bawaan
MICROSOFT Entra External ID memiliki atribut pengguna bawaan yang dapat Anda kumpulkan selama pendaftaran. Anda mengonfigurasi atribut ini saat membuat alur pengguna di pusat admin Microsoft Entra.
Tabel ini meringkas atribut pengguna bawaan yang dapat Anda kumpulkan selama alur pendaftaran:
- Label di pusat admin Microsoft Entra adalah nama atribut pengguna sebagaimana tampil di pusat tersebut.
- Nama yang dapat diprogram adalah nama atribut pengguna seperti yang digunakan dalam sumber daya pengguna Microsoft Graph API. Anda menggunakan nama ini saat ingin menggunakan atribut pengguna ini secara terprogram, seperti dalam autentikasi asli.
- Jenis data adalah jenis data atribut pengguna.
| Label di pusat administrasi Microsoft Entra | Nama yang dapat diprogram | Jenis Data | Keterangan |
|---|---|---|---|
| Kota | kota | String | Panjang maksimum adalah 128 karakter. |
| Negara/Wilayah | negara | String | Panjang maksimum adalah 128 karakter. |
| Nama Tampilan | nama tampilan | String | Panjang maksimum adalah 256 karakter. |
| Alamat Email | String | Properti ini dilarang berisi karakter aksen. Dalam API autentikasi asli, atribut ini dirujuk sebagai nama pengguna. | |
| Nama Depan | givenName | String | Panjang maksimum adalah 64 karakter. |
| Jabatan | judul pekerjaan | String | Panjang maksimum adalah 128 karakter. |
| Kode Pos | Kode Pos | String | Panjang maksimum adalah 40 karakter. |
| Negara Bagian/Provinsi | negara | String | Panjang maksimum adalah 128 karakter. |
| Alamat Jalan | alamat jalan | String | Panjang maksimum adalah 1024 karakter. |
| Nama Belakang | surname | String | Panjang maksimum adalah 64 karakter. |
Atribut pengguna kustom
Jika aplikasi Anda memerlukan lebih banyak informasi daripada atribut pengguna bawaan yang disediakan, Anda dapat menambahkan atribut Anda sendiri. Kami menyebut atribut ini sebagai atribut pengguna kustom.
Untuk menentukan atribut pengguna kustom, Anda terlebih dahulu membuat atribut di tingkat penyewa sehingga dapat digunakan dalam alur pengguna apa pun di penyewa. Kemudian Anda menetapkan atribut ke alur pengguna pendaftaran dan mengonfigurasi bagaimana Anda ingin atribut tersebut muncul di halaman pendaftaran.
Pelajari cara membuat atribut pengguna kustom di artikel Membuat atribut pengguna kustom.
Jenis input atribut pengguna kustom
Sebelum Anda menggunakan atribut pengguna kustom, tentukan cara terbaik untuk mengumpulkan input pengguna untuk setiap atribut kustom yang ingin Anda kumpulkan. Anda dapat mengumpulkan informasi dari pengguna selama pendaftaran dengan menggunakan kontrol jenis input berikut:
- Kotak teks "string"
- Tombol radio
- Kotak centang pilihan ganda
- Kotak teks numerik
- Kotak centang pilih tunggal
Lihat tabel ini untuk menemukan jenis data dan jenis input pengguna yang sesuai:
| Jenis Data | Jenis input pengguna | Deskripsi |
|---|---|---|
| String | TextBox | Bidang entri teks bentuk bebas. |
| String | RadioSingleSelect | Serangkaian tombol radio hanya dengan satu pilihan yang diizinkan. Teks untuk setiap tombol radio dapat menyertakan hyperlink yang diformat dengan format Markdown. |
| String | Kotak Centang Pilihan Ganda | Serangkaian satu atau beberapa kotak centang dengan beberapa pilihan diizinkan. Teks untuk kotak centang individu dapat menyertakan hyperlink yang diformat dalam bahasa Markdown. |
| Boolean | Kotak Centang Pilih Tunggal | Kotak centang boolean tunggal dengan label. Label untuk kotak centang dapat menyertakan hyperlink yang diformat dalam bahasa Markdown. |
| Int | NumericTextBox | Entri bilangan bulat bentuk bebas. |
Kotak centang dan tombol radio dapat menyertakan hyperlink ke konten lain, seperti ketentuan penggunaan dan kebijakan privasi. Contoh di awal artikel ini memperlihatkan halaman pendaftaran yang menggabungkan atribut bawaan dan atribut kustom. Dalam contoh:
- Bidang Nama Tampilan adalah atribut bawaan.
- Nomor Loyalitas adalah atribut kustom dengan bidang entri bebas yang menerima bilangan bulat numerik. Anda dapat mengonfigurasi format ini menggunakan jenis data Int dan jenis input pengguna NumericTextBox .
- Atribut kustom untuk ketentuan penggunaan dan kebijakan privasi adalah kotak centang terpisah yang hanya dapat memilih satu, dengan label yang berisi hyperlink. Anda dapat mengonfigurasi satu kotak centang menggunakan jenis data Boolean, yang secara bawaan menggunakan jenis input pengguna CheckboxSingleSelect. Gunakan bahasa Markdown untuk menambahkan hyperlink ke label kotak centang.
Pelajari cara mengonfigurasi jenis input atribut pengguna di artikel Mengonfigurasi jenis input pengguna.
Tempat atribut pengguna kustom disimpan
Atribut pengguna kustom juga dikenal sebagai atribut ekstensi direktori karena memperluas informasi profil pengguna yang disimpan di direktori Anda. Semua atribut ekstensi untuk penyewa eksternal Anda disimpan di aplikasi bernama b2c-extensions-app. Setelah pengguna memasukkan nilai untuk atribut kustom selama pendaftaran, atribut tersebut ditambahkan ke objek pengguna dan dapat dipanggil melalui Microsoft Graph API menggunakan konvensi extension_{appId-without-hyphens}_{custom-attribute-name} penamaan di mana:
-
{appId-without-hyphens}adalah versi yang disederhanakan dari ID klien untuk b2c-extensions-app. -
{custom-attribute-name}adalah nama yang Anda tetapkan ke atribut kustom.
Misalnya, jika ID klien b2c-extensions-app adalah 2588a-bcdwh-tfeehj-jeeqw-ertc dan nama atributnya adalah:
-
loyaltyNumber, kemudian atribut kustom dinamai sebagai
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. -
Nomor Loyalitas kemudian dinamai sebagai atribut kustom
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Anda menghapus spasi dan menggunakan camel case sebagai pemisah kata-kata.
Gunakan artikel Temukan ID aplikasi untuk aplikasi ekstensi untuk mempelajari cara menemukan ID aplikasi untuk b2c-extensions-app yang terdaftar di penyewa eksternal Anda.
Microsoft Graph APIs
Atribut pengguna disebut sebagai atribut alur pengguna di Microsoft Graph. Gunakan jenis sumber daya identityUserFlowAttribute dan metode terkait untuk mengelola atribut alur pengguna bawaan dan kustom.