Share via

Menambahkan atribut pengguna ke klaim token

  • Artikel

Berlaku untuk: Lingkaran putih dengan simbol X abu-abu. Penyewa Tenaga Kerja Penyewa Lingkaran hijau dengan simbol tanda centang putih. 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

Coba sekarang

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

Prasyarat

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.

    Cuplikan layar halaman gambaran umum pendaftaran aplikasi.

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

    Cuplikan layar aplikasi terkelola di tautan direktori lokal.

  5. Di bawah Kelola, pilih Akses Menyeluruh.

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

    Cuplikan layar bagian atribut dan klaim dan 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.

    Cuplikan layar daftar drop-down 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.

    Cuplikan layar opsi 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.

    Cuplikan layar panel Pilih Aplikasi.

  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