Partage via

Définir un profil technique de facteur téléphone dans une stratégie personnalisée Azure Active Directory B2C

  • 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.

Azure Active Directory B2C (Azure AD B2C) prend en charge l’inscription et la vérification de numéros de téléphone. Ce profil technique :

  • Fournit une interface utilisateur qui permet d’interagir avec l’utilisateur pour vérifier ou inscrire un numéro de téléphone.
  • Prend en charge les appels téléphoniques et les SMS pour valider le numéro de téléphone.
  • Prend en charge plusieurs numéros de téléphone. L’utilisateur peut sélectionner un des numéros de téléphone pour la vérification.
  • Retourne une revendication indiquant si l’utilisateur a fourni un nouveau numéro de téléphone. Vous pouvez utiliser cette revendication pour décider si le numéro de téléphone doit être rendu persistant dans le profil utilisateur Azure AD B2C.
  • Utilise la définition de contenu pour contrôler l’aspect.

Protocol

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 qui est utilisé par Azure AD B2C pour le facteur téléphone : Web.TPEngine.Providers.PhoneFactorProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

L’exemple suivant montre un profil technique de facteur téléphone pour l’inscription et la validation :

<TechnicalProfile Id="PhoneFactor-InputOrVerify">
  <DisplayName>PhoneFactor</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.PhoneFactorProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
</TechnicalProfile>

Transformations de revendications d’entrée

L’élément InputClaimsTransformations peut contenir une collection de transformations de revendications d’entrée qui sont utilisées pour modifier les revendications d’entrée ou en générer de nouvelles. La transformation de revendications d’entrée suivante génère une revendication UserId utilisée ultérieurement dans la collection de revendications d’entrée.

<InputClaimsTransformations>
  <InputClaimsTransformation ReferenceId="CreateUserIdForMFA" />
</InputClaimsTransformations>

Revendications d’entrée

L’élément InputClaims doit contenir les revendications suivantes. Vous pouvez également mapper le nom de votre revendication au nom défini dans le profil technique du facteur téléphone.

Type de données Obligatoire Description
string Oui Identificateur unique de l’utilisateur. Le nom de la revendication ou PartnerClaimType doit être défini sur UserId. Cette revendication ne doit pas contenir d’informations d’identification personnelle.
string Oui Liste des types de revendication. Chaque revendication contient un numéro de téléphone. Si l’une des revendications d’entrée ne contient pas de numéro de téléphone, l’utilisateur est invité à inscrire et à vérifier un nouveau numéro de téléphone. Le numéro de téléphone validé est retourné en tant que revendication de sortie. Si l’une des revendications d’entrée contient un numéro de téléphone, l’utilisateur est invité à le vérifier. Si plusieurs revendications d’entrée contiennent un numéro de téléphone, l’utilisateur est invité à choisir et à vérifier l’un des numéros de téléphone.

L’exemple suivant illustre l’utilisation de plusieurs numéros de téléphone. Pour plus d’informations, consultez Exemple de stratégie.

<InputClaims>
  <InputClaim ClaimTypeReferenceId="userIdForMFA" PartnerClaimType="UserId" />
  <InputClaim ClaimTypeReferenceId="strongAuthenticationPhoneNumber" />
  <InputClaim ClaimTypeReferenceId="secondaryStrongAuthenticationPhoneNumber" />
</InputClaims>

Revendications de sortie

L’élément OutputClaims contient une liste de revendications retournées par le profil technique du facteur téléphone.

Type de données Obligatoire Description
boolean Oui Indique si le nouveau numéro de téléphone a été entré par l’utilisateur. Le nom de la revendication ou PartnerClaimType doit être défini sur newPhoneNumberEntered.
string Oui Numéro de téléphone vérifié. Le nom de la revendication ou PartnerClaimType doit être défini sur Verified.OfficePhone.

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.

Clés de chiffrement

L’élément CryptographicKeys n’est pas utilisé.

Métadonnées

Attribut Obligatoire Description
ContentDefinitionReferenceId Oui Identificateur de la définition de contenu associée à ce profil technique.
ManualPhoneNumberEntryAllowed Non Indique si un utilisateur est autorisé ou non à entrer manuellement un numéro de téléphone. Valeurs possibles : true ou false (par défaut).
setting.authenticationMode Non Méthode permettant de valider le numéro de téléphone. Valeurs possibles : sms, phone ou mixed (par défaut).
setting.autodial Non Indique si le profil technique doit composer automatiquement le numéro ou envoyer automatiquement un SMS. Valeurs possibles : true ou false (par défaut). La numérotation automatique nécessite que les métadonnées setting.authenticationMode soient définies sur sms ou phone. La collection de revendications d’entrée doit avoir un numéro de téléphone unique.
setting.autosubmit No Spécifie si le profil technique doit envoyer automatiquement le formulaire d’entrée de mot de passe unique. Les valeurs possibles sont true (par défaut) ou false. Lorsque l’envoi automatique est désactivé, l’utilisateur doit sélectionner un bouton pour progresser dans le parcours.
setting.enableCaptchaChallenge Non Spécifie si le code de défi CAPTCHA doit être affiché dans un flux MFA. Valeurs possibles : true ou false (par défaut). Pour que ce paramètre fonctionne, le contrôle d’affichage CAPTCHA doit être référencé dans les revendications d’affichage du profil technique du facteur téléphonique. La fonctionnalité CAPTCHA est en préversion publique.

Éléments d’interface utilisateur

Les éléments d’interface utilisateur de la page d’authentification par facteur téléphone peuvent être localisés.

Étapes suivantes