Partager via

ClaimsTransformations

Important

À compter du 1er mai 2025, Azure AD B2C ne sera plus disponible pour les nouveaux clients. Pour plus d’informations, consultez notre FAQ.

Remarque

Dans Active Directory B2C, les stratégies personnalisées sont principalement conçues pour gérer des scénarios complexes. Pour la plupart des scénarios, nous vous recommandons de recourir à des flux d’utilisateurs intégrés. Si vous ne l’avez pas fait, découvrez le Pack de démarrage de stratégie personnalisée dans Prise en main des stratégies personnalisées dans Active Directory B2C.

L’élément ClaimsTransformations contient une liste de fonctions de transformation de revendications qui peuvent être utilisées dans les parcours utilisateur dans le cadre d’une stratégie personnalisée. Une transformation de revendication convertit une revendication donnée en une autre. Dans la transformation des revendications, vous spécifiez la méthode de transformation, par exemple l’ajout d’un élément à une collection de chaînes ou la modification de la casse d’une chaîne.

Pour inclure la liste des fonctions de transformation de revendications qui peuvent être utilisées dans les parcours utilisateur, un élément XML ClaimsTransformations doit être déclaré sous la section BuildingBlocks de la stratégie.

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

L’élément ClaimsTransformation contient les attributs suivants :

Caractéristique Obligatoire Descriptif
Id Oui Identificateur utilisé pour identifier de manière unique la transformation de revendication. L’identificateur est référencé à partir d’autres éléments XML de la stratégie.
Méthode de Transformation Oui Méthode de transformation à utiliser dans la transformation de revendications. Chaque transformation de revendication a ses propres valeurs. Consultez la référence de transformation des revendications pour obtenir la liste complète des valeurs disponibles.

ClaimsTransformation

L’élément ClaimsTransformation contient les éléments suivants :

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Élément Occurrences Descriptif
InputClaims 0:1 Liste des éléments InputClaim qui spécifient les types de revendications pris comme entrée dans la transformation des revendications. Chacun de ces éléments contient une référence à un ClaimType déjà défini dans la section ClaimsSchema de la stratégie.
Paramètres d’entrée 0:1 Liste des éléments InputParameter fournis en tant qu’entrée à la transformation de revendications.
OutputClaims 0:1 Liste des éléments OutputClaim qui spécifient les types de revendication générés après l’appel de ClaimsTransformation. Chacun de ces éléments contient une référence à un ClaimType déjà défini dans la section ClaimsSchema.

InputClaims

L’élément InputClaims contient l’élément suivant :

Élément Occurrences Descriptif
InputClaim 1 :n Type de revendication d’entrée attendu.

InputClaim

L’élément InputClaim contient les attributs suivants :

Caractéristique Obligatoire Descriptif
ClaimTypeReferenceId Oui Référence à un ClaimType déjà défini dans la section ClaimsSchema de la stratégie.
TransformationClaimType Oui Identificateur permettant de référencer un type de revendication de transformation. Chaque transformation de revendication a ses propres valeurs. Consultez la référence de transformation des revendications pour obtenir la liste complète des valeurs disponibles.

Paramètres d’entrée

L’élément InputParameters contient l’élément suivant :

Élément Occurrences Descriptif
InputParameter 1 :n Paramètre d’entrée attendu.

InputParameter

Caractéristique Obligatoire Descriptif
Id Oui Identificateur qui est une référence à un paramètre de la méthode de transformation de revendications. Chaque méthode de transformation de revendications a ses propres valeurs. Consultez la table de transformation des revendications pour obtenir la liste complète des valeurs disponibles.
Type de données Oui Type de données du paramètre, tel que String, Boolean, Int ou DateTime en fonction de l’énumération DataType dans le schéma XML de stratégie personnalisée. Ce type est utilisé pour effectuer correctement des opérations arithmétiques. Chaque transformation de revendication a ses propres valeurs. Consultez la référence de transformation des revendications pour obtenir la liste complète des valeurs disponibles.
Valeur Oui Valeur transmise textuellement à la transformation. Certaines des valeurs sont arbitraires, certaines d’entre elles sont sélectionnées dans la méthode de transformation de revendications.

OutputClaims

L’élément OutputClaims contient l’élément suivant :

Élément Occurrences Descriptif
OutputClaim 0 :n Type de revendication de sortie attendu.

OutputClaim

L’élément OutputClaim contient les attributs suivants :

Caractéristique Obligatoire Descriptif
ClaimTypeReferenceId Oui Référence à un ClaimType déjà défini dans la section ClaimsSchema de la stratégie.
TransformationClaimType Oui Identificateur permettant de référencer un type de revendication de transformation. Chaque transformation de revendication a ses propres valeurs. Consultez la référence de transformation des revendications pour obtenir la liste complète des valeurs disponibles.

Les revendications d’entrée et de sortie utilisées dans la transformation des revendications doivent être distinctes. La même revendication d’entrée ne peut pas être utilisée comme revendication de sortie.

Exemple :

Par exemple, vous pouvez stocker la dernière version de vos conditions d’utilisation que l’utilisateur a acceptées. Lorsque vous mettez à jour les conditions d’utilisation, vous pouvez demander à l’utilisateur d’accepter la nouvelle version. Dans l’exemple suivant, la transformation de revendications HasTOSVersionChanged compare la valeur de la revendication TOSVersion à la valeur de la revendication LastTOSAcceptedVersion , puis retourne la revendication BOOlean 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>

Informations de référence sur les transformations de revendications

Pour obtenir des exemples de transformations de revendications, consultez les pages de référence suivantes :

  • Last updated on