Partager via

Profils techniques

  • Article

Notes

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.

Un profil technique fournit une infrastructure avec un mécanisme intégré pour communiquer avec différents types de parties. Les profils techniques sont utilisés pour communiquer avec votre locataire Azure Active Directory B2C (Azure AD B2C) afin de créer un utilisateur ou de lire un profil utilisateur. Un profil technique peut être déclaré automatiquement pour permettre l’interaction avec l’utilisateur. Par exemple, un profil technique peut collecter les informations d’identification de l’utilisateur pour se connecter, puis afficher la page d’inscription ou la page de réinitialisation du mot de passe.

Types de profils techniques

Un profil technique permet les types de scénarios suivants :

  • Application Insights : envoi de données d’événement à Application Insights.
  • Microsoft Entra ID : prise en charge de la gestion des utilisateurs Azure AD B2C.
  • Authentification multifacteur Microsoft Entra : prise en charge permettant de vérifier un numéro de téléphone à l’aide de l’authentification multifacteur Microsoft Entra.
  • Transformation de revendications : appel des transformations de revendications de sortie pour manipuler les valeurs de revendications, valider les revendications ou définir des valeurs par défaut pour un ensemble de revendications de sortie.
  • Indicateur de jeton d’ID : validation de la signature du jeton JWT id_token_hint, du nom de l’émetteur et de l’audience du jeton, puis extraction de la revendication du jeton entrant.
  • Émetteur de jeton JWT : émission d’un jeton JWT qui est retourné à l’application par partie de confiance.
  • OAuth1 : fédération avec n’importe quel fournisseur d’identité du protocole OAuth 1.0.
  • OAuth2 : fédération avec n’importe quel fournisseur d’identité du protocole OAuth 2.0.
  • Mot de passe à usage unique : prise en charge de la gestion de la génération et de la vérification d’un mot de passe à usage unique.
  • OpenID Connect : fédération avec n’importe quel fournisseur d’identité du protocole OpenID Connect.
  • Facteur de téléphone : prise en charge de l’inscription et de la vérification des numéros de téléphone.
  • Fournisseur RESTful : appel des services d’API REST, comme la validation de l’entrée utilisateur, l’enrichissement des données utilisateur ou l’intégration avec les applications métier.
  • Fournisseur d’identité SAML : fédération avec n’importe quel fournisseur d’identité du protocole SAML.
  • Émetteur de jeton SAML : émission d’un jeton SAML qui est retourné à l’application par partie de confiance.
  • Auto-déclaré : interaction avec l’utilisateur. Par exemple, collecte des informations d’identification de l’utilisateur pour se connecter, afficher la page d’inscription ou réinitialiser le mot de passe.
  • Gestion des sessions : gestion de différents types de sessions.

Flux du profil technique

Tous les types de profils techniques partagent le même concept. Ils commencent par lire les revendications d’entrée et exécutent les transformations de revendications. Ensuite, ils communiquent avec le tiers configuré, comme un fournisseur d’identité, une API REST ou les services d’annuaire Microsoft Entra. Au terme du processus, le profil technique retourne les revendications de sortie et peut exécuter des transformation de revendications de sortie. Le schéma suivant explique comment sont traités les transformations et les mappages référencés dans le profil technique. Quel que soit le tiers avec lequel le profil technique interagit, une fois la transformation de revendications exécutée, les revendications de sortie sont immédiatement stockées dans le conteneur de revendications.

Diagramme illustrant le flux du profil technique.

  1. Gestion de session d’authentification unique (SSO) : restaure l’état de session du profil technique à l’aide de la gestion de session SSO.
  2. Transformation de revendications d’entrée : avant le démarrage du profil technique, Azure AD B2C exécute la transformation de revendications d’entrée.
  3. Revendications d’entrée : les revendications sont récupérées auprès du conteneur de revendications et sont utilisées pour le profil technique.
  4. Exécution du profil technique : le profil technique échange les revendications avec le tiers configuré. Par exemple :
    • Redirige l’utilisateur vers le fournisseur d’identité pour finaliser la connexion. Une fois connecté, l’utilisateur revient et l’exécution du profil technique se poursuit.
    • Appelle une API REST tout en envoyant les paramètres en tant qu’éléments InputClaims et en récupérant les informations en tant qu’éléments OutputClaims.
    • Crée ou met à jour le compte utilisateur.
    • Envoie et vérifie le message texte de l’authentification multifacteur.
  5. Profils techniques de validation : un profil technique auto-déclaré peut appeler des profils techniques de validation pour valider les données profilées par l’utilisateur. Seuls les profils techniques à déclaration automatique peuvent utiliser des profils techniques de validation.
  6. Revendications de sortie : les revendications sont retournées au conteneur de revendications. Vous pouvez utiliser ces revendications dans la prochaine étape d’orchestration, ou dans les transformations de revendications de sortie.
  7. Transformations de revendications de sortie : une fois le profil technique complété, Azure AD B2C exécute les transformations de revendications de sortie.
  8. Gestion de session SSO : conserve les données du profil technique dans la session à l’aide de la gestion de session SSO.

Un élément TechnicalProfiles contient un ensemble de profils techniques pris en charge par le fournisseur de revendications. Chaque fournisseur de revendications doit avoir au moins un profil technique. Le profil technique détermine les points de terminaison et les protocoles nécessaires pour communiquer avec le fournisseur de revendications. Un fournisseur de revendications peut avoir plusieurs profils techniques.

<ClaimsProvider>
  <DisplayName>Display name</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Technical profile identifier">
      <DisplayName>Display name of technical profile</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        ...
      </Metadata>
      ...
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

L’élément TechnicalProfile contient l’attribut suivant :

Attribut Obligatoire Description
Id Oui Identificateur unique du profil technique. Le profil technique peut être référencé à l’aide de cet identificateur à partir d’autres éléments dans le fichier de stratégie. Par exemple, OrchestrationSteps et ValidationTechnicalProfile.

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

Élément Occurrences Description
Domain 0:1 Nom de domaine pour le profil technique. Par exemple, si votre profil technique Spécifie le fournisseur d’identité Facebook, le nom de domaine est Facebook.com.
DisplayName 1:1 Nom d’affichage du profil technique.
Description 0:1 Description du profil technique.
Protocol 1:1 Protocole utilisé pour la communication avec l’autre partie.
Métadonnées 0:1 Ensemble de clés et de valeurs qui contrôle le comportement du profil technique.
InputTokenFormat 0:1 Format du jeton d’entrée. Les valeurs possibles sont JSON, JWT, SAML11 ou SAML2. La valeur JWT représente un jeton web JSON conformément à la spécification IETF. La valeur SAML11 représente un jeton de sécurité SAML 1.1 conformément à la spécification OASIS. La valeur SAML2 représente un jeton de sécurité SAML 2.0 conformément à la spécification OASIS.
OutputTokenFormat 0:1 Format du jeton de sortie. Les valeurs possibles sont JSON, JWT, SAML11 ou SAML2.
CryptographicKeys 0:1 Liste de clés de chiffrement utilisées dans le profil technique.
InputClaimsTransformations 0:1 Liste des références précédemment définies aux transformations de revendications qui doivent être exécutées avant l’envoi de toute revendication au fournisseur de revendications ou à la partie de confiance.
InputClaims 0:1 Liste des références précédemment définies aux types de revendications qui sont prises en tant qu’entrée dans le profil technique.
PersistedClaims 0:1 Liste des références précédemment définies aux types de revendications qui sont rendues persistantes par le profil technique.
DisplayClaims 0:1 Liste des références précédemment définies aux types de revendications qui sont présentées par le profil technique auto-déclaré. La fonctionnalité DisplayClaims est actuellement en préversion.
OutputClaims 0:1 Liste des références précédemment définies aux types de revendications qui sont prises en tant que sortie dans le profil technique.
OutputClaimsTransformations 0:1 Liste des références précédemment définies aux transformations de revendications qui doivent être exécutées après la réception des revendications provenant du fournisseur de revendications.
ValidationTechnicalProfiles 0:n Liste des références à d’autres profils techniques que le profil technique utilise à des fins de validation. Pour plus d’informations, consultez Profil technique de validation.
SubjectNamingInfo 0:1 Contrôle la production du nom du sujet dans les jetons où le nom du sujet est spécifié séparément à partir de revendications. Exemples : OAuth ou SAML.
IncludeInSso 0:1 Si l’utilisation de ce profil technique doit appliquer le comportement SSO pour la session, ou si une interaction explicite est exigée à la place. Cet élément est valide uniquement dans les profils SelfAsserted utilisés dans un profil technique de validation. Les valeurs possibles sont true (par défaut) ou false.
IncludeClaimsFromTechnicalProfile 0:1 Identificateur d’un profil technique à partir duquel vous souhaitez que toutes les revendications d’entrée et de sortie soient ajoutées à ce profil technique. Le profil technique référencé doit être défini dans le même fichier de stratégie.
IncludeTechnicalProfile 0:1 Identificateur d’un profil technique à partir duquel vous souhaitez que toutes les sonnées soient ajoutées à ce profil technique.
UseTechnicalProfileForSessionManagement 0:1 Autre profil technique à utiliser pour la gestion de session.
EnabledForUserJourneys 0:1 Contrôle si le profil technique est exécuté dans un parcours utilisateur.

Protocol

L’élément Protocol spécifie le protocole utilisé pour la communication avec l’autre partie. L’élément Protocol contient les attributs suivants :

Attribut Obligatoire Description
Nom Oui Nom d’un protocole valide pris en charge par Azure AD B2C et utilisé dans le cadre du profil technique. Les valeurs possibles sont OAuth1, OAuth2, SAML2, OpenIdConnect, Proprietary ou None.
Handler Non Lorsque le nom du protocole est défini sur Proprietary, spécifie le nom de l’assembly qu’Azure AD B2C utilise pour déterminer le gestionnaire de protocole. Si vous définissez l’attribut Nom du protocole sur None, évitez d’inclure l’attribut Gestionnaire.

Métadonnées

L’élément Metadata contient les options de configuration appropriées pour un protocole spécifique. La liste des métadonnées prises en charge est documentée dans la spécification de profil technique correspondante. Un élément Metadata contient les éléments suivants :

Élément Occurrences Description
Élément 0:n Métadonnées relatives au profil technique. Chaque type de profil technique a un ensemble différent d’éléments de métadonnées. Pour plus d’informations, consultez la section consacrée aux types de profils techniques.

Élément

L’élément Item de l’élément Metadata contient les attributs suivants :

Attribut Obligatoire Description
Clé Oui Clé de métadonnées. Consultez chaque type de profil technique pour obtenir la liste des éléments de métadonnées.

L’exemple suivant illustre l’utilisation des métadonnées relatives au profil technique OAuth2.

<TechnicalProfile Id="Facebook-OAUTH">
  ...
  <Metadata>
    <Item Key="ProviderName">facebook</Item>
    <Item Key="authorization_endpoint">https://www.facebook.com/dialog/oauth</Item>
    <Item Key="AccessTokenEndpoint">https://graph.facebook.com/oauth/access_token</Item>
    <Item Key="HttpBinding">GET</Item>
    <Item Key="UsePolicyInRedirectUri">0</Item>
    ...
  </Metadata>
  ...
</TechnicalProfile>

L’exemple suivant illustre l’utilisation des métadonnées relatives au profil technique API REST.

<TechnicalProfile Id="REST-Validate-Email">
  ...
  <Metadata>
    <Item Key="ServiceUrl">https://api.sendgrid.com/v3/mail/send</Item>
    <Item Key="AuthenticationType">Bearer</Item>
    <Item Key="SendClaimsIn">Body</Item>
    ...
  </Metadata>
  ...
</TechnicalProfile>

Clés de chiffrement

Pour établir une relation de confiance avec les services auxquels il s’intègre, Azure AD B2C stocke les secrets et les certificats sous forme de clés de stratégie. Au cours de l’exécution du profil technique, Azure AD B2C récupère les clés de chiffrement à partir des clés de stratégie Azure AD B2C. Azure AD B2C utilise ensuite les clés pour établir la relation de confiance, chiffrer ou signer un jeton. Ces approbations sont constituées des éléments suivants :

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

Élément Occurrences Description
Clé 1:n Clé de chiffrement utilisée dans ce profil technique.

Clé

L’élément Key contient l’attribut suivant :

Attribut Obligatoire Description
Id Non Identificateur unique d’une paire de clés spécifique référencé à partir d’autres éléments dans le fichier de stratégie.
StorageReferenceId Oui Identificateur d’un conteneur de clé de stockage référencé à partir d’autres éléments dans le fichier de stratégie.

Transformations de revendications d’entrée

L’élément InputClaimsTransformations peut contenir une collection d’éléments de transformation de revendications d’entrée qui sont utilisés pour modifier les revendications d’entrée ou en générer de nouvelles.

Les revendications de sortie d’une transformation de revendications précédente dans la collection des transformations de revendications peuvent être des revendications d’entrée d’une transformation de revendications d’entrée ultérieure. De cette façon, vous pouvez avoir une séquence de transformations de revendications qui dépendent les unes des autres.

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

Élément Occurrences Description
InputClaimsTransformation 1:n Identificateur d’une transformation de revendications qui doit être exécutée avant l’envoi de toute revendication au fournisseur de revendications ou à la partie de confiance. Une transformation de revendications peut être utilisée pour modifier des revendications ClaimsSchema existantes ou en générer de nouvelles.

InputClaimsTransformation

L’élément InputClaimsTransformation contient l’attribut suivant :

Attribut Obligatoire Description
ReferenceId Oui Identificateur d’une transformation de revendications déjà défini dans le fichier de stratégie ou un fichier de stratégie parent.

Les profils techniques suivants font référence à la transformation de revendications CreateOtherMailsFromEmail. La transformation de revendications ajoute la valeur de la revendication email à la collection otherMails avant de rendre les données persistantes dans le répertoire.

<TechnicalProfile Id="AAD-UserWriteUsingAlternativeSecurityId">
  ...
  <InputClaimsTransformations>
    <InputClaimsTransformation ReferenceId="CreateOtherMailsFromEmail" />
  </InputClaimsTransformations>
  <PersistedClaims>
    <PersistedClaim ClaimTypeReferenceId="alternativeSecurityId" />
    <PersistedClaim ClaimTypeReferenceId="userPrincipalName" />
    <PersistedClaim ClaimTypeReferenceId="mailNickName" DefaultValue="unknown" />
    <PersistedClaim ClaimTypeReferenceId="displayName" DefaultValue="unknown" />
    <PersistedClaim ClaimTypeReferenceId="otherMails" />
    <PersistedClaim ClaimTypeReferenceId="givenName" />
    <PersistedClaim ClaimTypeReferenceId="surname" />
  </PersistedClaims>
  ...
</TechnicalProfile>

Revendications d’entrée

L’élément InputClaims récupère les revendications auprès du conteneur de revendications qui sont utilisées pour le profil technique. Par exemple, un profil technique autodéclaré utilise les revendications d’entrée pour préremplir les revendications de sortie fournies par l’utilisateur. Un profil technique d’API REST utilise les revendications d’entrée pour envoyer les paramètres d’entrée au point de terminaison de l’API REST. Azure AD B2C utilise une revendication d’entrée comme identificateur unique pour lire, mettre à jour ou supprimer un compte.

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

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

InputClaim

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

Attribut Obligatoire Description
ClaimTypeReferenceId Oui Identificateur d’un type de revendication. La revendication est déjà définie dans la section Schéma des revendications du fichier de stratégie ou du fichier de stratégie parent.
DefaultValue Non Valeur par défaut à utiliser pour créer une revendication si la revendication indiquée par ClaimTypeReferenceId n’existe pas, de sorte que le profil technique puisse utiliser la revendication obtenue comme élément InputClaim.
AlwaysUseDefaultValue Oui Force l’utilisation de la valeur par défaut.
PartnerClaimType Non Identificateur du type de revendication du partenaire externe auquel le type de revendication de stratégie spécifié mappe. Si l’attribut PartnerClaimType n’est pas spécifié, le type de revendication de stratégie spécifié est mappé au type de revendication partenaire du même nom. Utilisez cette propriété lorsque le nom de votre type de revendication diffère de celui de l’autre partie. Par exemple, le nom de la première revendication est givenName, tandis que le partenaire utilise une revendication nommée first_name.

Revendications d’affichage

L’élément DisplayClaims contient une liste des revendications à présenter à l’écran pour recueillir des données auprès de l’utilisateur. Dans la collection de revendications d’affichage, vous pouvez inclure une référence à un type de revendication ou à un contrôle d’affichage que vous avez créé.

  • Un type de revendication est une référence à une revendication à afficher à l’écran.
    • Pour forcer l’utilisateur à fournir une valeur pour une revendication spécifique, affectez la valeur true à l’attribut Required de l’élément DisplayClaims.
    • Pour prérenseigner les valeurs des revendications d'affichage, utilisez les revendications d'entrée décrites précédemment. L’élément peut également contenir une valeur par défaut.
    • L’élément ClaimType dans la collection DisplayClaims doit définir l’élément UserInputType sur n’importe quel type d’entrée d’utilisateur pris en charge par Azure AD B2C. TextBox ou DropdownSingleSelect en sont des exemples.
  • Un contrôle d’affichage est un élément d’interface utilisateur qui présente une fonctionnalité particulière et interagit avec le service principal Azure AD B2C. Il permet à l’utilisateur d’exécuter des actions sur la page qui appellent un profil technique de validation dans le back end. Par exemple, vérifier une adresse e-mail, un numéro de téléphone ou un numéro de fidélité de client.

L’ordre des éléments dans DisplayClaims détermine l’ordre dans lequel Azure AD B2C affiche les revendications à l’écran.

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

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

DisplayClaim

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

Attribut Obligatoire Description
ClaimTypeReferenceId Non Identificateur d’un type de revendication déjà défini dans la section ClaimsSchema du fichier de stratégie ou d’un fichier de stratégie parent.
DisplayControlReferenceId Non Identificateur d’un contrôle d’affichage déjà défini dans la section ClaimsSchema du fichier de stratégie ou d’un fichier de stratégie parent.
Obligatoire Non Indique si la revendication d’affichage est requise.

L’exemple suivant illustre l’utilisation des revendications d’affichage et des contrôles d’affichage dans un profil technique auto-déclaré.

Capture d’écran montrant un profil technique auto-déclaré avec des revendications d’affichage.

Ajoutez le profil technique suivant :

  • La première revendication d’affichage fait référence au contrôle d’affichage emailVerificationControl qui collecte et vérifie l’adresse e-mail.
  • La cinquième revendication d’affichage fait référence au contrôle d’affichage phoneVerificationControl qui collecte et vérifie un numéro de téléphone.
  • Les autres revendications d’affichage sont des éléments ClaimType à recueillir auprès de l’utilisateur.
<TechnicalProfile Id="Id">
  <DisplayClaims>
    <DisplayClaim DisplayControlReferenceId="emailVerificationControl" />
    <DisplayClaim ClaimTypeReferenceId="displayName" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="givenName" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="surName" Required="true" />
    <DisplayClaim DisplayControlReferenceId="phoneVerificationControl" />
    <DisplayClaim ClaimTypeReferenceId="newPassword" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="reenterPassword" Required="true" />
  </DisplayClaims>
</TechnicalProfile>

Revendications persistantes

L’élément PersistedClaims contient toutes les valeurs qui doivent être rendues persistantes par un profil technique Microsoft Entra ID, avec des informations de mappage possible entre un type de revendication déjà défini dans la section ClaimsSchema de la stratégie et le nom de l’attribut Microsoft Entra.

Le nom de la revendication est le nom de l’attribut Microsoft Entra, sauf si l’attribut PartnerClaimType est spécifié, qui contient le nom d’attribut Microsoft Entra.

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

Élément Occurrences Description
PersistedClaim 1:n Type de revendication à conserver.

PersistedClaim

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

Attribut Obligatoire Description
ClaimTypeReferenceId Oui Identificateur d’un type de revendication déjà défini dans la section ClaimsSchema du fichier de stratégie ou d’un fichier de stratégie parent.
DefaultValue Non Valeur par défaut à utiliser pour créer une revendication si la revendication n’existe pas.
PartnerClaimType Non Identificateur du type de revendication du partenaire externe auquel le type de revendication de stratégie spécifié mappe. Si l’attribut PartnerClaimType n’est pas spécifié, le type de revendication de stratégie spécifié est mappé au type de revendication partenaire du même nom. Utilisez cette propriété lorsque le nom de votre type de revendication diffère de celui de l’autre partie. Par exemple, le nom de la première revendication est givenName, tandis que le partenaire utilise une revendication nommée first_name.

Dans l’exemple suivant, le profil technique AAD-UserWriteUsingLogonEmail ou le pack de démarrage, qui crée un nouveau compte local, rend les revendications suivantes persistantes :

<PersistedClaims>
  <PersistedClaim ClaimTypeReferenceId="email" PartnerClaimType="signInNames.emailAddress" />
  <PersistedClaim ClaimTypeReferenceId="newPassword" PartnerClaimType="password"/>
  <PersistedClaim ClaimTypeReferenceId="displayName" DefaultValue="unknown" />
  <PersistedClaim ClaimTypeReferenceId="passwordPolicies" DefaultValue="DisablePasswordExpiration" />
  <PersistedClaim ClaimTypeReferenceId="givenName" />
  <PersistedClaim ClaimTypeReferenceId="surname" />
</PersistedClaims>

Revendications de sortie

L’élément OutputClaims est une collection de revendications retournées au conteneur de revendications une fois le profil technique complété. Vous pouvez utiliser ces revendications dans la prochaine étape d’orchestration, ou dans les transformations de revendications de sortie. L’élément OutputClaims contient l’élément suivant :

Élément Occurrences Description
OutputClaim 1:n Type de revendication de sortie attendu.

OutputClaim

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

Attribut Obligatoire Description
ClaimTypeReferenceId Oui Identificateur d’un type de revendication déjà défini dans la section ClaimsSchema du fichier de stratégie ou d’un fichier de stratégie parent.
DefaultValue Non Valeur par défaut à utiliser pour créer une revendication si la revendication n’existe pas.
AlwaysUseDefaultValue Non Force l’utilisation de la valeur par défaut.
PartnerClaimType Non Identificateur du type de revendication du partenaire externe auquel le type de revendication de stratégie spécifié mappe. Si l’attribut du type de revendication partenaire n’est pas spécifié, le type de revendication de stratégie spécifié est mappé au type de revendication partenaire du même nom. Utilisez cette propriété lorsque le nom de votre type de revendication diffère de celui de l’autre partie. Par exemple, le nom de la première revendication est givenName, tandis que le partenaire utilise une revendication nommée first_name.

Transformations de revendications de sortie

L’élément OutputClaimsTransformations peut contenir une collection d’éléments OutputClaimsTransformation. Les transformations de revendications de sortie sont utilisées pour modifier les revendications de sortie ou en générer de nouvelles. Après l’exécution, les revendications de sortie sont replacées dans le conteneur de revendications. Vous pouvez utiliser ces revendications dans la prochaine étape d’orchestration.

Les revendications de sortie d’une transformation de revendications précédente dans la collection des transformations de revendications peuvent être des revendications d’entrée d’une transformation de revendications d’entrée ultérieure. De cette façon, vous pouvez avoir une séquence de transformations de revendications qui dépendent les unes des autres.

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

Élément Occurrences Description
OutputClaimsTransformation 1:n Identificateurs de transformations de revendications qui doivent être exécutées avant l’envoi de toute revendication au fournisseur de revendications ou à la partie de confiance. Une transformation de revendications peut être utilisée pour modifier des revendications ClaimsSchema existantes ou en générer de nouvelles.

OutputClaimsTransformation

L’élément OutputClaimsTransformation contient l’attribut suivant :

Attribut Obligatoire Description
ReferenceId Oui Identificateur d’une transformation de revendications déjà défini dans le fichier de stratégie ou un fichier de stratégie parent.

Le profil technique suivant fait référence à la transformation de revendications AssertAccountEnabledIsTrue pour déterminer si le compte est activé ou non après la lecture de la revendication accountEnabled à partir de l’annuaire.

<TechnicalProfile Id="AAD-UserReadUsingEmailAddress">
  ...
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="objectId" />
    <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="localAccountAuthentication" />
    <OutputClaim ClaimTypeReferenceId="userPrincipalName" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="accountEnabled" />
    <OutputClaim ClaimTypeReferenceId="otherMails" />
    <OutputClaim ClaimTypeReferenceId="signInNames.emailAddress" />
  </OutputClaims>
  <OutputClaimsTransformations>
    <OutputClaimsTransformation ReferenceId="AssertAccountEnabledIsTrue" />
  </OutputClaimsTransformations>
  ...
</TechnicalProfile>

Profils techniques de validation

Un profil technique de validation sert à valider des revendications de sortie dans un profil technique autodéclaré. Un profil technique de validation est un profil technique ordinaire de n'importe quel protocole, tel que Microsoft Entra ID ou une API REST. Le profil technique de validation retourne des revendications de sortie ou un code d’erreur. Le message d’erreur s’affiche pour l’utilisateur à l’écran, lui permettant de réessayer.

Le diagramme suivant illustre la façon dont Azure AD B2C utilise un profil technique de validation pour valider les informations d’identification de l’utilisateur.

Diagramme illustrant un flux de profil technique de validation.

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

Élément Occurrences Description
ValidationTechnicalProfile 1:n Identificateur des profils techniques utilisés pour valider la totalité ou certaines des revendications de sortie du profil technique de référencement. Toutes les revendications d’entrée du profil technique référencé doivent apparaître dans les revendications de sortie du profil technique de référencement.

ValidationTechnicalProfile

L’élément ValidationTechnicalProfile contient l’attribut suivant :

Attribut Obligatoire Description
ReferenceId Oui Identificateur d’un profil technique déjà défini dans le fichier de stratégie ou dans un fichier de stratégie parent.

SubjectNamingInfo

L’élément SubjectNamingInfo définit le nom du sujet utilisé dans les jetons d’une stratégie de partie de confiance. L’élément SubjectNamingInfo contient l’attribut suivant :

Attribut Obligatoire Description
ClaimType Oui Identificateur d’un type de revendication déjà défini dans la section ClaimsSchema du fichier de stratégie.

Inclure un profil technique

Un profil technique peut inclure un autre profil technique pour modifier des paramètres ou ajouter de nouvelles fonctionnalités. L’élément IncludeTechnicalProfile est une référence au profil technique courant dont un profil technique découle. Pour réduire la redondance et la complexité de vos éléments de stratégie, utilisez l’inclusion quand vous disposez de plusieurs profils techniques qui partagent les éléments de base. Utilisez un profil technique courant avec l’ensemble courant de configuration, ainsi que des profils techniques de tâches spécifiques qui incluent le profil technique courant.

Supposons que vous ayez un profil technique d’API REST avec un seul point de terminaison auquel vous devez envoyer différents jeux de revendications pour différents scénarios. Créez un profil technique courant avec les fonctionnalités partagées, telles que l’URI de point de terminaison de l’API REST, les métadonnées, le type d’authentification et les clés de chiffrement. Créez des profils techniques de tâches spécifiques qui incluent le profil technique commun. Ajoutez ensuite les revendications d’entrée et de sortie, ou remplacez l’URI de point de terminaison de l’API REST correspondant à ce profil technique.

L’élément IncludeTechnicalProfile contient l’attribut suivant :

Attribut Obligatoire Description
ReferenceId Oui Identificateur d’un profil technique déjà défini dans le fichier de stratégie ou dans un fichier de stratégie parent.

L'exemple ci-dessous illustre l'utilisation de l'inclusion :

  • REST-API-Common : profil technique courant avec la configuration de base.
  • REST-ValidateProfile : comprend le profil technique REST-API-Common et spécifie les revendications d’entrée et de sortie.
  • REST-UpdateProfile : comprend le profil technique REST-API-Common, spécifie les revendications d’entrée et remplace les métadonnées ServiceUrl.
<ClaimsProvider>
  <DisplayName>REST APIs</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="REST-API-Common">
      <DisplayName>Base REST API configuration</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        <Item Key="ServiceUrl">https://your-app-name.azurewebsites.NET/api/identity</Item>
        <Item Key="AuthenticationType">Basic</Item>
        <Item Key="SendClaimsIn">Body</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="BasicAuthenticationUsername" StorageReferenceId="B2C_1A_B2cRestClientId" />
        <Key Id="BasicAuthenticationPassword" StorageReferenceId="B2C_1A_B2cRestClientSecret" />
      </CryptographicKeys>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
    </TechnicalProfile>

    <TechnicalProfile Id="REST-ValidateProfile">
      <DisplayName>Validate the account and return promo code</DisplayName>
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="objectId" />
        <InputClaim ClaimTypeReferenceId="email" />
        <InputClaim ClaimTypeReferenceId="userLanguage" PartnerClaimType="lang" DefaultValue="{Culture:LCID}" AlwaysUseDefaultValue="true" />
      </InputClaims>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="promoCode" />
      </OutputClaims>
      <IncludeTechnicalProfile ReferenceId="REST-API-Common" />
    </TechnicalProfile>

    <TechnicalProfile Id="REST-UpdateProfile">
      <DisplayName>Update the user profile</DisplayName>  
      <Metadata>
        <Item Key="ServiceUrl">https://your-app-name.azurewebsites.NET/api/identity/update</Item>
      </Metadata>
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="objectId" />
        <InputClaim ClaimTypeReferenceId="email" />
      </InputClaims>
      <IncludeTechnicalProfile ReferenceId="REST-API-Common" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

Inclusion multiniveau

Un profil technique peut inclure un profil technique unique. Le nombre de niveaux d’inclusion n’est pas limité. Par exemple, le profil technique AAD-UserReadUsingAlternativeSecurityId-NoError inclut le profil AAD-UserReadUsingAlternativeSecurityId. Ce profil technique définit l’élément de métadonnées RaiseErrorIfClaimsPrincipalDoesNotExist sur true, et génère une erreur si aucun compte de réseau social ne figure dans l’annuaire. AAD-UserReadUsingAlternativeSecurityId-NoError remplace ce comportement et désactive ce message d’erreur.

<TechnicalProfile Id="AAD-UserReadUsingAlternativeSecurityId-NoError">
  <Metadata>
    <Item Key="RaiseErrorIfClaimsPrincipalDoesNotExist">false</Item>
  </Metadata>
  <IncludeTechnicalProfile ReferenceId="AAD-UserReadUsingAlternativeSecurityId" />
</TechnicalProfile>

AAD-UserReadUsingAlternativeSecurityId inclut le profil technique AAD-Common.

<TechnicalProfile Id="AAD-UserReadUsingAlternativeSecurityId">
  <Metadata>
    <Item Key="Operation">Read</Item>
    <Item Key="RaiseErrorIfClaimsPrincipalDoesNotExist">true</Item>
    <Item Key="UserMessageIfClaimsPrincipalDoesNotExist">User does not exist. Please sign up before you can sign in.</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="AlternativeSecurityId" PartnerClaimType="alternativeSecurityId" Required="true" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="objectId" />
    <OutputClaim ClaimTypeReferenceId="userPrincipalName" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="otherMails" />
    <OutputClaim ClaimTypeReferenceId="givenName" />
    <OutputClaim ClaimTypeReferenceId="surname" />
  </OutputClaims>
  <IncludeTechnicalProfile ReferenceId="AAD-Common" />
</TechnicalProfile>

Ni AAD-UserReadUsingAlternativeSecurityId-NoError, ni AAD-UserReadUsingAlternativeSecurityId ne spécifient l’élément Protocol requis, car celui-ci est spécifié dans le profil technique AAD-Common.

<TechnicalProfile Id="AAD-Common">
  <DisplayName>Azure Active Directory</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AzureActiveDirectoryProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  ...
</TechnicalProfile>

Utiliser un profil technique pour la gestion des sessions

L’élément UseTechnicalProfileForSessionManagement fait référence au profil technique de session SSO. L’élément UseTechnicalProfileForSessionManagement contient l’attribut suivant :

Attribut Obligatoire Description
ReferenceId Oui Identificateur d’un profil technique déjà défini dans le fichier de stratégie ou dans un fichier de stratégie parent.

Compatible avec les parcours d'utilisateur

L’élément ClaimsProviderSelections dans un parcours utilisateur définit la liste et l’ordre des options de sélection de fournisseur de revendications. Avec l’élément EnabledForUserJourneys, vous filtrez le fournisseur de revendications disponible pour l’utilisateur. L’élément EnabledForUserJourneys contient l’une des valeurs suivantes :

  • Always : exécute le profil technique.
  • Never : ignore le profil technique.
  • OnClaimsExistence : s’exécute seulement s’il existe une certaine revendication spécifiée dans le profil technique.
  • OnItemExistenceInStringCollectionClaim : s’exécute uniquement s’il existe un élément dans une revendication de collection de chaînes.
  • OnItemAbsenceInStringCollectionClaim : s’exécute uniquement s’il n’existe pas un élément dans une revendication de collection de chaînes.

Si vous utilisez OnClaimsExistence, OnItemExistenceInStringCollectionClaim ou OnItemAbsenceInStringCollectionClaim, vous devez fournir les métadonnées suivantes :

  • ClaimTypeOnWhichToEnable : spécifie le type de la revendication à évaluer.
  • ClaimValueOnWhichToEnable : spécifie la valeur à comparer.

Le profil technique suivant est exécuté uniquement si la collection de chaînes identityProviders contient la valeur de facebook.com :

<TechnicalProfile Id="UnLink-Facebook-OAUTH">
  <DisplayName>Unlink Facebook</DisplayName>
...
    <Metadata>
      <Item Key="ClaimTypeOnWhichToEnable">identityProviders</Item>
      <Item Key="ClaimValueOnWhichToEnable">facebook.com</Item>
    </Metadata>
...
  <EnabledForUserJourneys>OnItemExistenceInStringCollectionClaim</EnabledForUserJourneys>
</TechnicalProfile>