BuildingBlocks

發行項
01/11/2024

注意

在 Azure Active Directory B2C 中，自訂原則的主要用途為處理複雜的案例。在大部分情況下，我們建議使用內建的使用者流程。如果您尚未執行此操作，請於在 Active Directory B2C 中開始使用自訂原則中，瞭解自訂原則入門套件。

BuildingBlocks 元素會新增到 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>

BuildingBlocks 元素包含下列必須以所定義順序來指定的元素：

ClaimsSchema：定義可當作原則一部分進行參考的宣告類型。宣告結構描述是可在其中宣告您的宣告類型的位置。在許多程式設計語言中，宣告類型會與變數類似。您可以使用宣告類型來向應用程式的使用者收集資料、接收來自社交識別提供者的宣告、從自訂 REST API 傳送和接收資料，或儲存您自訂原則所使用的任何內部資料。
Predicates 與 PredicateValidationsInput：可讓您執行驗證程序來確定只能在宣告中輸入正確格式的資料。
ClaimsTransformations：包含可在原則中使用的宣告轉換清單。宣告轉換會將一個宣告轉換成另一個。在宣告轉換中，您會指定轉換方法，例如：
- 將字串宣告的大小寫變更為指定的大小寫。例如，將字串從小寫變更為大寫。
- 比較兩個宣告，並使用 True 傳回宣告以指出宣告相符，否則會傳回 False。
- 從原則中提供的參數建立字串宣告。
- 使用隨機號碼產生器來建立隨機字串。
- 根據提供的格式字串來將宣告格式化。此轉換會使用 C# String.Format 方法。
InputValidation - 此元素可讓您執行類似於「和」以及「或」的布林值彙總。
ContentDefinitions：包含要在使用者旅程圖中使用之 HTML5 範本的 URL。在自訂原則中，內容定義會定義要在使用者旅程圖中針對指定步驟使用的 HTML5 頁面 URI。例如，登入或註冊、密碼重設或錯誤網頁。可以藉由覆寫該 HTML5 檔案的 LoadUri 來修改外觀與風格。或者，可以根據您的需求來建立新的內容定義。這個元素可能會使用當地語系化識別碼來包含當地語系化的資源參考。
Localization：可讓您支援多種語言。原則中的當地語系化支援可讓您在原則中設定支援的語言清單，並挑選預設語言。同時也支援特定語言的字串和集合。
DisplayControls - 定義要在頁面上顯示的控制項。顯示控制項具有特殊功能，並可與後端驗證技術設定檔互動。

BuildingBlocks

其他資源