ClaimsTransformations

[アーティクル]
01/11/2024

注意

Azure Active Directory B2C で、カスタムポリシーは、主に、複雑なシナリオに取り組む用途向けに設計されています。ほとんどのシナリオで、組み込みユーザーフローを使用することをお勧めします。まだ行っていない場合は、Active Directory B2C でのカスタムポリシーの概要に関する記事で、カスタムポリシースターターパックの詳細を確認してください。

ClaimsTransformations 要素には、カスタムポリシーの一部としてユーザー体験に使用できる要求変換関数のリストが含まれています。要求変換により、所定の要求が別の要求に変換されます。要求変換で、文字列コレクションに項目を追加したり、文字列の大文字と小文字を変更したりする変換メソッドを指定します。

ユーザー体験で使用できる要求変換関数のリストを含めるには、ClaimsTransformations XML 要素が、ポリシーの BuildingBlocks セクションで宣言されている必要があります。

<ClaimsTransformations>
  <ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
    ...
  </ClaimsTransformation>
</ClaimsTransformations>

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

属性	必須	説明
Id	はい	要求変換を一意に識別するために使用される識別子。識別子は、ポリシー内の他の XML 要素から参照されます。
TransformationMethod	はい	要求変換で使用する変換メソッド。各要求変換は、独自の値を持ちます。使用可能な値の完全なリストについては、要求変換の参照を確認してください。

ClaimsTransformation

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

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>

要素	発生回数	説明
InputClaims	0:1	要求変換への入力として取得される要求の種類を指定する InputClaim 要素のリスト。これらの各要素には、ポリシー内の ClaimsSchema セクションに既に定義されている ClaimType への参照が含まれています。
InputParameters	0:1	要求変換への入力として提供される InputParameter 要素のリスト。
OutputClaims	0:1	ClaimsTransformation が呼び出された後に生成される要求の種類を指定する OutputClaim 要素のリスト。これらの各要素には、ClaimsSchema セクションに既に定義されている ClaimType への参照が含まれています。

InputClaims

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

要素	発生回数	Description
InputClaim	1:n	予想される入力要求の種類。

InputClaim

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

属性	必須	Description
ClaimTypeReferenceId	はい	ポリシー内の ClaimsSchema セクションに既に定義されている ClaimType への参照。
TransformationClaimType	はい	変換要求の種類を参照する識別子。各要求変換は、独自の値を持ちます。使用可能な値の完全なリストについては、要求変換の参照を確認してください。

InputParameters

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

要素	発生回数	説明
InputParameter	1:n	想定される入力パラメーター。

InputParameter

属性	必須	説明
Id	はい	要求変換メソッドのパラメーターへの参照である識別子。各要求変換メソッドは、独自の値を持ちます。使用可能な値の完全なリストについては、要求変換の表を参照してください。
DataType	はい	カスタムポリシー XML スキーマの DataType エミュレーションに従った、文字列、ブール値、Int、または DateTime などの、パラメーターのデータ型。この型は、算術演算を正しく行うために使用されます。各要求変換は、独自の値を持ちます。使用可能な値の完全なリストについては、要求変換の参照を確認してください。
Value	はい	変換に逐語的に渡される値。一部の値は任意ですが、一部の値は要求変換メソッドから選択します。

OutputClaims

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

要素	発生回数	Description
OutputClaim	0:n	予想される出力要求の種類。

OutputClaim

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

属性	必須	Description
ClaimTypeReferenceId	はい	ポリシー内の ClaimsSchema セクションに既に定義されている ClaimType への参照。
TransformationClaimType	はい	変換要求の種類を参照する識別子。各要求変換は、独自の値を持ちます。使用可能な値の完全なリストについては、要求変換の参照を確認してください。

要求変換に使用される入力と出力の要求は、区別できる必要があります。同じ入力要求を出力要求として使用することはできません。

例

例えば、ユーザーが同意したサービス使用条件の最後のバージョンを保存できます。サービス使用条件を更新するときに、新しいバージョンに同意することをユーザーに求めることができます。次の例では、HasTOSVersionChanged 要求変換によって、TOSVersion 要求の値と LastTOSAcceptedVersion 要求の値が比較され、ブール TOSVersionChanged 要求が返されます。

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="TOSVersionChanged">
      <DisplayName>Indicates if the TOS version accepted by the end user is equal to the current version</DisplayName>
      <DataType>boolean</DataType>
    </ClaimType>
    <ClaimType Id="TOSVersion">
      <DisplayName>TOS version</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
    <ClaimType Id="LastTOSAcceptedVersion">
      <DisplayName>TOS version accepted by the end user</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
  </ClaimsSchema>

  <ClaimsTransformations>
    <ClaimsTransformation Id="HasTOSVersionChanged" TransformationMethod="CompareClaims">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="TOSVersion" TransformationClaimType="inputClaim1" />
        <InputClaim ClaimTypeReferenceId="LastTOSAcceptedVersion" TransformationClaimType="inputClaim2" />
      </InputClaims>
      <InputParameters>
        <InputParameter Id="operator" DataType="string" Value="NOT EQUAL" />
      </InputParameters>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="TOSVersionChanged" TransformationClaimType="outputClaim" />
      </OutputClaims>
    </ClaimsTransformation>
  </ClaimsTransformations>
</BuildingBlocks>

要求の変換の参照

要求変換の例については、次の参照ページを確認してください。

次の方法で共有