BuildingBlocks

  • Artikel

Catatan

Di Azure Active Directory B2C, kebijakan kustom didesain khusus untuk menangani skenario kompleks. Untuk skenario umum, sebaiknya gunakan alur pengguna bawaan. Jika Anda belum melakukannya, pelajari tentang paket starter kebijakan kustom di Mulai dengan kebijakan kustom di Azure Active Directory B2C.

Elemen BuildingBlocks ditambahkan di dalam elemen TrustFrameworkPolicy.

<TrustFrameworkPolicy
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="https://www.w3.org/2001/XMLSchema"
  xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
  PolicySchemaVersion="0.3.0.0"
  TenantId="mytenant.onmicrosoft.com"
  PolicyId="B2C_1A_TrustFrameworkBase"
  PublicPolicyUri="http://mytenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">

  <BuildingBlocks>
    <ClaimsSchema>
      ...
    </ClaimsSchema>
    <Predicates>
    ...
    </Predicates>
    <PredicateValidations>
    ...
    </PredicateValidations>
    <ClaimsTransformations>
      ...
    </ClaimsTransformations>
    <ContentDefinitions>
      ...
    </ContentDefinitions>
    <Localization>
      ...
    </Localization>
    <DisplayControls>
      ...
    </DisplayControls>
 </BuildingBlocks>

Elemen BuildingBlocks berisi elemen berikut yang harus ditentukan dalam urutan yang ditentukan:

  • ClaimsSchema - Menentukan jenis klaim yang dapat direferensikan sebagai bagian dari kebijakan. Skema klaim adalah tempat di mana Anda menyatakan klaim Anda. Jenis klaim mirip dengan variabel dalam banyak bahasa terprogram. Anda dapat menggunakan jenis klaim untuk mengumpulkan data dari pengguna aplikasi Anda, menerima klaim dari IdP sosial, mengirim dan menerima data dari REST API kustom, atau menyimpan data internal apa pun yang digunakan oleh kebijakan kustom Anda.

  • Predikat dan PredicateValidationsInput - Memungkinkan Anda melakukan proses validasi untuk memastikan bahwa hanya data yang terbentuk dengan benar yang dimasukkan ke dalam klaim.

  • ClaimsTransformations - Berisi daftar transformasi klaim yang dapat digunakan dalam kebijakan Anda. Transformasi klaim mengubah satu klaim menjadi klaim lain. Dalam transformasi klaim, Anda menentukan metode transformasi, seperti:

    • Mengubah kasus klaim untai (karakter) ke yang ditentukan. Misalnya, mengubah untai (karakter) dari huruf kecil menjadi huruf besar.
    • Membandingkan dua klaim dan mengembalikan klaim dengan benar yang menunjukkan bahwa klaim cocok, jika tidak salah.
    • Membuat klaim untai (karakter) dari parameter yang disediakan dalam kebijakan.
    • Membuat untai (karakter) acak menggunakan generator angka acak.
    • Format klaim sesuai dengan untai (karakter) format yang tersedia. Transformasi ini menggunakan metode String.Format C#.

  • InputValidation - Elemen ini memungkinkan Anda untuk melakukan agregasi boolean yang mirip dengan dan dan atau.

  • ContentDefinitions - Berisi URL untuk templat HTML5 untuk digunakan dalam perjalanan Anda. Dalam kebijakan kustom, definisi konten mendefinisikan URI halaman HTML5 yang digunakan untuk langkah tertentu dalam perjalanan. Misalnya, halaman masuk atau pendaftaran, reset kata sandi, atau kesalahan. Anda dapat memodifikasi tampilan dan nuansa dengan mengesampingkan LoadUri untuk file HTML5. Atau, Anda dapat membuat definisi konten baru sesuai dengan kebutuhan Anda. Elemen ini mungkin berisi referensi sumber daya yang di lokal menggunakan ID pelokalan.

  • Pelokalan - Memungkinkan Anda mendukung beberapa bahasa. Dukungan pelokalan dalam kebijakan memungkinkan Anda menyiapkan daftar bahasa yang didukung dalam kebijakan dan memilih bahasa default. Untai (karakter) dan koleksi khusus bahasa juga didukung.

  • DisplayControls - Menentukan kontrol yang akan ditampilkan pada halaman. Kontrol tampilan memiliki fungsionalitas khusus dan berinteraksi dengan profil teknis validasi back-end.