Menambahkan atribut pengguna ke klaim token

Berlaku untuk: Penyewa Tenaga Kerja Penyewa eksternal (pelajari lebih lanjut)

Atribut pengguna adalah nilai yang dikumpulkan dari pengguna selama pendaftaran mandiri. Selain atribut pengguna bawaan, Anda dapat membuat atribut kustom saat perlu mengumpulkan informasi tambahan. Karena aplikasi Anda mungkin mengandalkan atribut pengguna tertentu untuk berfungsi seperti yang dirancang, Anda dapat menambahkan salah satu atribut ini ke token yang dikirim dari ID Microsoft Entra ke aplikasi Anda.

Anda dapat menentukan atribut bawaan atau kustom mana yang ingin Anda sertakan sebagai klaim dalam token yang dikirim ID Microsoft Entra ke aplikasi Anda.

Tip

Untuk mencoba fitur ini, buka demo Woodgrove Groceries dan mulai kasus penggunaan "Tambahkan klaim ke token keamanan dari REST API".

Prasyarat

• Daftarkan aplikasi dengan ID Microsoft Entra.
• Buat alur pengguna pendaftaran dan masuk dan pilih atribut yang ingin Anda kumpulkan selama pendaftaran.
• Buat atribut kustom yang ingin Anda sertakan.

Menambahkan atribut bawaan atau kustom ke token

1. Masuk ke Pusat Admin Microsoft Entra.

2. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

3. Pilih aplikasi Anda dalam daftar untuk membuka halaman Gambaran Umum aplikasi.

   

4. Di bagian Esensial , di bawah Aplikasi terkelola di direktori lokal, pilih tautan yang menampilkan nama aplikasi Anda.

   

5. Di bawah Kelola, pilih Akses Menyeluruh.

6. Di bagian Atribut & Klaim , pilih ikon Edit .

   

Untuk menambahkan atribut bawaan ke token sebagai klaim

1. Pada halaman Atribut & Klaim , pilih Tambahkan klaim baru.

2. Masukkan nama .

3. Di samping Sumber, pilih Atribut. Kemudian gunakan daftar drop-down untuk memilih atribut bawaan.

   

4. Pilih Simpan. Ulangi untuk semua atribut bawaan yang ingin Anda tambahkan.

Untuk menambahkan atribut kustom ke token sebagai klaim

1. Pada halaman Atribut & Klaim , pilih Tambahkan klaim baru.

2. Masukkan nama .

3. Di samping Sumber, pilih Ekstensi skema direktori.

   

4. Di panel Pilih Aplikasi , pilih b2c-extensions-app (aplikasi yang berisi semua atribut ekstensi untuk penyewa eksternal Anda), lalu pilih Pilih.

   

5. Di panel Tambahkan Atribut Ekstensi, temukan atribut kustom yang ingin Anda tambahkan sebagai klaim ke token, lalu pilih.

6. Pilih Tambahkan.

7. Pilih Simpan. Ulangi untuk setiap atribut kustom yang ingin Anda tambahkan.

Memperbarui manifes aplikasi untuk menerima klaim yang dipetakan

1. Masuk ke Pusat Admin Microsoft Entra.
2. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
3. Pilih aplikasi Anda dalam daftar untuk membuka halaman Gambaran Umum aplikasi.
4. Di menu sebelah kiri, di bawah Kelola, pilih Manifes untuk membuka manifes aplikasi.
5. Temukan kunci acceptMappedClaims dan atur nilainya ke true.
6. Temukan kunci allowPublicClient dan atur nilainya ke true.
7. Pilih Simpan.

Lihat juga

• Membuat REST API dengan peristiwa mulai penerbitan token
• Mengonfigurasi penyedia klaim kustom untuk peristiwa penerbitan token