Partager via

Définir un profil technique SSPR Microsoft Entra ID dans une stratégie personnalisée Azure AD B2C

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.

Important

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

Azure Active Directory B2C (Azure AD B2C) prend en charge la vérification d’une adresse e-mail pour la réinitialisation de mot de passe en libre-service (SSPR). Utilisez le profil technique SSPR microsoft Entra ID pour générer et envoyer un code à une adresse e-mail, puis vérifiez le code. Le profil technique SSPR microsoft Entra ID peut également renvoyer un message d’erreur. Le profil technique de validation valide les données fournies par l’utilisateur avant que le parcours de l’utilisateur ne se poursuive. Avec le profil technique de validation, un message d’erreur s’affiche sur une page autodéclarée.

Ce profil technique :

  • Ne fournit pas d’interface permettant d’interagir avec l’utilisateur. Au lieu de cela, l’interface utilisateur est appelée à partir d’un profil technique autodéclaré ou d’un contrôle d’affichage en tant que profil technique de validation.
  • Utilise le service Microsoft Entra SSPR pour générer et envoyer un code à une adresse e-mail, puis vérifie le code.
  • Valide une adresse e-mail via un code de vérification.

Protocole

L’attribut Name de l’élément Protocol doit être défini sur Proprietary. L’attribut handler doit contenir le nom complet de l’assembly de gestionnaire de protocole utilisé par Azure AD B2C :

Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

L’exemple suivant montre un profil technique Microsoft Entra ID SSPR :

<TechnicalProfile Id="AadSspr-SendCode">
  <DisplayName>Send Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
    ...

Envoyer un e-mail

Le premier mode de ce profil technique consiste à générer un code et à l’envoyer. Les options suivantes peuvent être configurées pour ce mode.

Revendications d’entrée

L’élément InputClaims contient une liste de revendications à envoyer à Microsoft Entra SSPR. Vous pouvez également mapper le nom de votre revendication au nom défini dans le profil technique SSPR.

ClaimReferenceId Obligatoire Descriptif
adresse e-mail Oui Identificateur de l’utilisateur propriétaire de l’adresse e-mail. La PartnerClaimType propriété de la revendication d’entrée doit être définie sur emailAddress.

L’élément InputClaimsTransformations peut contenir une collection d’éléments InputClaimsTransformation utilisés pour modifier les revendications d’entrée ou en générer de nouvelles avant l’envoi au service Microsoft Entra SSPR.

Revendications de sortie

Le fournisseur de protocole Microsoft Entra SSPR ne retourne aucun OutputClaims, il n’est donc pas nécessaire de spécifier les revendications de sortie. Toutefois, vous pouvez inclure des revendications qui ne sont pas retournées par le fournisseur de protocole Microsoft Entra SSPR tant que vous définissez l’attribut DefaultValue .

L’élément OutputClaimsTransformations peut contenir une collection d’éléments OutputClaimsTransformation qui sont utilisés pour modifier les revendications de sortie ou en générer de nouvelles.

Métadonnées

Caractéristique Obligatoire Descriptif
Opération Oui Doit être SendCode.

Éléments d’interface utilisateur

Les métadonnées suivantes peuvent être utilisées pour configurer les messages d’erreur affichés lors de l’envoi d’un échec SMS. Les métadonnées doivent être configurées dans le profil technique autodéclaré . Les messages d’erreur peuvent être localisés.

Caractéristique Obligatoire Descriptif
UserMessageIfInternalError Non Message d’erreur utilisateur si le serveur a rencontré une erreur interne.
UserMessageIfThrottled Non Message d’erreur utilisateur si une demande a été limitée.

Exemple : envoyer un e-mail

L’exemple suivant montre un profil technique SSPR Microsoft Entra ID utilisé pour envoyer un code par e-mail.

<TechnicalProfile Id="AadSspr-SendCode">
  <DisplayName>Send Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="Operation">SendCode</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" PartnerClaimType="emailAddress"/>
  </InputClaims>
</TechnicalProfile>

Vérifier le code

Le deuxième mode de ce profil technique consiste à vérifier un code. Les options suivantes peuvent être configurées pour ce mode.

Revendications d’entrée

L’élément InputClaims contient une liste de revendications à envoyer à Microsoft Entra SSPR. Vous pouvez également mapper le nom de votre revendication au nom défini dans le profil technique SSPR.

ClaimReferenceId Obligatoire Descriptif
adresse e-mail Oui Même adresse e-mail que celle utilisée précédemment pour envoyer un code. Il est également utilisé pour localiser une session de vérification par e-mail. La PartnerClaimType propriété de la revendication d’entrée doit être définie sur emailAddress.
code de vérification Oui Code de vérification fourni par l’utilisateur à vérifier. La PartnerClaimType propriété de la revendication d’entrée doit être définie sur verificationCode.

L’élément InputClaimsTransformations peut contenir une collection d’éléments InputClaimsTransformation utilisés pour modifier les revendications d’entrée ou en générer de nouvelles avant d’appeler le service Microsoft Entra SSPR.

Revendications de sortie

Le fournisseur de protocole Microsoft Entra SSPR ne retourne aucun OutputClaims, il n’est donc pas nécessaire de spécifier les revendications de sortie. Toutefois, vous pouvez inclure des revendications qui ne sont pas retournées par le fournisseur de protocole Microsoft Entra SSPR tant que vous définissez l’attribut DefaultValue .

L’élément OutputClaimsTransformations peut contenir une collection d’éléments OutputClaimsTransformation qui sont utilisés pour modifier les revendications de sortie ou en générer de nouvelles.

Métadonnées

Caractéristique Obligatoire Descriptif
Opération Oui Doit être VerifyCode

Éléments d’interface utilisateur

Les métadonnées suivantes peuvent être utilisées pour configurer les messages d’erreur affichés en cas d’échec de la vérification du code. Les métadonnées doivent être configurées dans le profil technique autodéclaré . Les messages d’erreur peuvent être localisés.

Caractéristique Obligatoire Descriptif
UserMessageIfChallengeExpired Message à afficher à l’utilisateur si la session de vérification du code a expiré. Le code a expiré ou le code n’a jamais été généré pour un identificateur donné.
UserMessageIfInternalError Message d’erreur utilisateur si le serveur a rencontré une erreur interne.
UserMessageIfThrottled Message d’erreur utilisateur si une demande a été limitée.
UserMessageIfVerificationFailedNoRetry Message à afficher à l’utilisateur s’il a fourni un code non valide et que l’utilisateur n’est pas autorisé à fournir le code approprié.
UserMessageIfVerificationFailedRetryAllowed Message à afficher à l’utilisateur s’il a fourni un code non valide et que l’utilisateur est autorisé à fournir le code approprié.

Exemple : vérifier un code

L’exemple suivant montre un profil technique SSPR Microsoft Entra ID utilisé pour vérifier le code.

<TechnicalProfile Id="AadSspr-VerifyCode">
  <DisplayName>Verify Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="Operation">VerifyCode</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="verificationCode" PartnerClaimType="verificationCode" />
    <InputClaim ClaimTypeReferenceId="email" PartnerClaimType="emailAddress"/>
  </InputClaims>
</TechnicalProfile>
  • Last updated on