Azure Active Directory B2C カスタム ポリシーで検証技術プロファイルを定義する

検証技術プロファイルは、Microsoft Entra ID や REST API などの、あらゆるプロトコルの通常の技術プロファイルです。 検証技術プロファイルは、出力要求を返すか、次のデータを含む 4xx HTTP 状態コードを返します。 詳細については、エラー メッセージの返しを参照してください。

{
    "version": "1.0.0",
    "status": 409,
    "userMessage": "Your error message"
}

検証技術プロファイルの出力要求のスコープは、検証技術プロファイルとその検証 技術プロファイル を呼び出すセルフアサート技術プロファイルに制限されます。 次のオーケストレーション 手順で出力要求を使用する場合は、検証技術プロファイルを呼び出すセルフアサート技術プロファイルに出力要求を追加します。

検証技術プロファイルは、 ValidationTechnicalProfiles 要素に表示される順序で実行されます。 検証技術プロファイルでエラーが発生した場合、または成功した場合に後続の検証技術プロファイルの実行を続行するかどうかを検証技術プロファイルで構成できます。

検証技術プロファイルは、 ValidationTechnicalProfile 要素で定義されている前提条件に基づいて条件付きで実行できます。 たとえば、特定の要求が存在するかどうか、または要求が指定した値と等しいかどうかを確認できます。

セルフアサート技術プロファイルでは、その出力要求の一部またはすべてを検証するために使用する検証技術プロファイルを定義できます。 参照される技術プロファイルのすべての入力要求は、参照元の検証技術プロファイルの出力要求に表示される必要があります。

検証技術プロファイル

ValidationTechnicalProfiles 要素には、次の要素が含まれています。

ValidationTechnicalProfile 要素には、次の属性が含まれています。

ValidationTechnicalProfile 要素には、次の要素が含まれています。

Precondition 要素には、次の属性が含まれています。

Precondition 要素には、次の要素が含まれています。

例

次の例では、これらの検証技術プロファイルを使用します。

1. 最初の検証技術プロファイルでは、ユーザー資格情報がチェックされ、無効なユーザー名や無効なパスワードなどのエラーが発生しても続行されません。
2. 次の検証技術プロファイルは、userType 要求が存在しない場合、または userType の値が Partner場合は実行されません。 検証技術プロファイルは、ユーザー プロファイルを内部顧客データベースから読み取り、REST API サービスが利用できない、内部エラーなどのエラーが発生した場合は続行しようとします。
3. 最後の検証技術プロファイルは、userType 要求が存在しない場合、または userType の値が Customerされている場合は実行されません。 検証技術プロファイルは、内部パートナー データベースからユーザー プロファイルの読み取りを試み、REST API サービスが利用できない、内部エラーなどのエラーが発生した場合は続行されます。

<ValidationTechnicalProfiles>
  <ValidationTechnicalProfile ReferenceId="login-NonInteractive" ContinueOnError="false" />
  <ValidationTechnicalProfile ReferenceId="REST-ReadProfileFromCustomersDatabase" ContinueOnError="true" >
    <Preconditions>
      <Precondition Type="ClaimsExist" ExecuteActionsIf="false">
        <Value>userType</Value>
        <Action>SkipThisValidationTechnicalProfile</Action>
      </Precondition>
      <Precondition Type="ClaimEquals" ExecuteActionsIf="true">
        <Value>userType</Value>
        <Value>Partner</Value>
        <Action>SkipThisValidationTechnicalProfile</Action>
      </Precondition>
    </Preconditions>
  </ValidationTechnicalProfile>
  <ValidationTechnicalProfile ReferenceId="REST-ReadProfileFromPartnersDatabase" ContinueOnError="true" >
    <Preconditions>
      <Precondition Type="ClaimsExist" ExecuteActionsIf="false">
        <Value>userType</Value>
        <Action>SkipThisValidationTechnicalProfile</Action>
      </Precondition>
      <Precondition Type="ClaimEquals" ExecuteActionsIf="true">
        <Value>userType</Value>
        <Value>Customer</Value>
        <Action>SkipThisValidationTechnicalProfile</Action>
      </Precondition>
    </Preconditions>
  </ValidationTechnicalProfile>
</ValidationTechnicalProfiles>