Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
Locataires externes (en savoir plus)
Approche d’authentification : Authentification native incorporée.
L’API d’authentification native utilise un flux piloté par la réponse dans ID externe Microsoft Entra locataires externes. Démarrez l’autorisation, effectuez les interactions d’authentification retournées, reprenez l’autorisation et échangez le code d’autorisation pour les jetons. Cette référence définit les opérations partagées ; Les références spécifiques au parcours définissent la découverte de connexion, les attributs d’inscription et la réinitialisation de mot de passe.
Pour une intégration V1 existante, utilisez la référence de l’API V1. Consultez Migrer de V1 vers V2 pour connaître les versions de package, les exigences de migration et les détails d’intégration du Kit de développement logiciel (SDK).
Prerequisites
Important
L’API d’authentification native V2 est en préversion. L’API d’authentification native V1 reste généralement disponible. Consultez les conditions d’utilisation supplémentaires pour les préversions Microsoft Azure pour connaître les conditions légales qui s’appliquent aux fonctionnalités en préversion.
- Un locataire externe et une application configurée pour les flux d’authentification publics et natifs. Consultez Configurer une application.
- Flux utilisateur associé à l’application.
- Domaine d’URL personnalisé vérifié par le locataire configuré pour tous les appels d’API de service.
- Autorisations déléguées et consentement requis par votre ressource cible, si vous demandez l’accès à une API.
- Pour les fournisseurs de services avec l’authentification native incorporée et les sites web d’expérience utilisateur BYO, une stratégie de proxy ou de périphérie qui implémente les exigences du proxy de navigateur.
Opérations et autorité
Les exemples utilisent https://{custom_domain}/{tenant}, où custom_domain est un domaine d’authentification vérifié par le locataire, tel que login.contoso.com, et tenant est son ID d’annuaire (locataire), un GUID.
client_id est l’ID d’application (client). Toutes les URL d’appel d’API de service utilisent ce domaine personnalisé, y compris les défis d’autorisation et l’échange de jetons. Consultez Configurer l’autorité d’API.
À l’exception de la demande d’autorisation initiale et de l’échange de jetons, utilisez l’URL annoncée par la réponse actuelle. Les ID de méthode sont opaques. Résolvez les liens relatifs par rapport à l’origine de l’autorité configurée, validez la destination et conservez le chemin d’accès et la requête retournés inchangés.
Le démarrage, la reprise et l’échange de code ci-dessous décrivent l’authentification native incorporée. Une page d’expérience utilisateur BYO utilise plutôt son transfert de navigateur et renvoie le lien de fin autour des opérations d’interaction native partagées. Ne démarrez pas ou ne reprenez /authorize-challenge pas à l’intérieur de cette transaction d’expérience utilisateur BYO.
| Operation | Méthode | Chemin d’accès ou lien |
|---|---|---|
| Démarrer l’autorisation | POST |
/{tenant}/oauth2/v2.0/authorize-challenge |
| Reprendre l’autorisation | POST |
Lien retourné continue . |
| Démarrer la connexion | POST |
Lien retourné sign_in ; des exemples utilisent /{tenant}/api/v2.0/signin/start. |
| Démarrer l’inscription | POST |
Lien retourné sign_up ; des exemples utilisent /{tenant}/api/v2.0/signup/start. |
| Envoyer des attributs d’inscription | POST |
Lien retourné submitAttributes . |
| Démarrer la réinitialisation du mot de passe | POST |
Lien reset-password retourné ; exemples d’utilisation /{tenant}/api/v2.0/resetpassword/start. |
| Démarrer la réinitialisation du mot de passe inline | POST |
Lien retourné recover par la méthode de mot de passe. |
| Inscrire une méthode d’authentification | POST |
Lien retourné par la méthode sélectionnée enroll . |
| Activer une méthode d’authentification | POST |
Lien retourné activate . |
| Défier ou renvoyer | POST |
Retourné challenge ou resend lien. |
| Vérifier les informations d’identification | POST |
Lien retourné verify . |
| Mettre à jour un mot de passe | PUT |
Lien retourné update . |
| Interroger la mise à jour du mot de passe | POST |
Lien retourné poll . |
| Exchange un code d’autorisation | POST |
/{tenant}/oauth2/v2.0/token |
Les exemples natifs utilisent /api/v2.0; Les opérations OAuth utilisent /oauth2/v2.0. Utilisez le GUID du locataire dans ces exemples d’autorité. Suivez les liens retournés sans réécrire leurs chemins, versions ou paramètres de requête.
En-têtes
Les opérations d’authentification OAuth et native utilisent différents encodages de corps.
| Header | Utiliser |
|---|---|
Content-Type: application/x-www-form-urlencoded |
Obligatoire pour les demandes de challenge d’autorisation et de jeton. |
Content-Type: application/json |
Obligatoire pour les corps de demande d’authentification native. |
Accept: application/hal+json |
Recommandé pour les demandes d’authentification natives. |
client-request-id: {guid} |
Recommandé. Générez une nouvelle valeur pour chaque flux et conservez-la pour les diagnostics. |
Configuration requise pour le proxy du navigateur
Ces exigences s’appliquent aux appels d’API de navigateur à partir d’api spAs avec l’authentification native incorporée et les sites web d’expérience utilisateur BYO. Les applications Android et iOS utilisant des transports HTTP natifs n’ont pas besoin de configuration CORS ou d’un proxy CORS.
Les itinéraires d’authentification native gèrent OPTIONS, mais n’accordent pas d’accès à l’origine du navigateur via Access-Control-Allow-Origin. Les intégrations entre navigateurs d’origine ont donc besoin d’une configuration proxy ou edge qui :
- Transfère la réponse préliminaire réussie du service et applique la stratégie d’origine du navigateur configurée.
- Retourne
Access-Control-Allow-Originpour cette origine exacte autorisée, et non*. - Autorise l’opération requise
POSTouPUTla méthode et les en-têtes de requête utilisés par l’intégration. - Conserve les corps de la demande, les codes d’état de réponse, les types de contenu et les liens de transaction sans mettre en cache les réponses d’authentification.
- Gère l’origine et le routage de manière cohérente entre l’autorisation, les opérations natives et l’échange de jetons.
- Conserve les conseils de nouvelle tentative, y compris
Retry-After, et l’expose au code du navigateur si nécessaire.
Consultez les concepts CORS de l’authentification native pour la limite du navigateur et la configuration du proxy local pour le développement.
Jetons de continuation
Un jeton de continuation représente la transaction d’authentification à son stade actuel. Elle est liée au locataire, au client, au scénario et à l’action.
| Format du message | Champ |
|---|---|
| OAuth | continuation_token |
| API d’authentification native | continuationToken |
Utilisez uniquement le jeton actuel avec l’opération identifiée par la même réponse. N’analysez pas, modifiez, journaliser ou conservez-le au-delà de la transaction active. Lorsqu’une réponse fournit un remplacement, arrêtez d’utiliser le jeton précédent. Ne déplacez pas de jeton vers un autre utilisateur ou parcours. Redémarrez l’autorisation après expiration.
La validité par défaut documentée est de 10 minutes pour un jeton de continuation individuel. Gérer l’expiration en fonction de la réponse du service ; un jeton plus récent n’est pas une garantie d’extension de tout le parcours. Le jeton et un code secret à usage unique ont des durées de vie distinctes. Les codes d’autorisation sont à courte durée et à usage unique ; n’interprètez pas la réponse d’un expires_in jeton comme la durée de vie du code d’autorisation.
Modèle de réponse
Les opérations d’interaction native réussies retournent HAL JSON. L’action suivante peut différer même pour les appels successifs au même point de terminaison. Les champs sont spécifiques à la réponse : par exemple, une redirection peut contenir uniquement state.
| Membre | Purpose |
|---|---|
continuationToken |
Jeton pour la requête autorisée suivante, lorsqu’elle est incluse. |
state |
État de transaction actuel. |
action |
Interaction requise pour une interactionRequired réponse. |
_links |
URL pour les opérations autorisées. |
_embedded |
Ressources associées, y compris les méthodes disponibles. |
Le concept de flux explique les états et les actions. Pour interactionRequired, gérez l’action retournée à l’aide d’une opération autorisée. Pour continue, reprendre l’autorisation via le lien retourné. L’état d’une completed opération individuelle ne confirme pas que les jetons ont été émis.
Une transaction native qui ne peut pas continuer peut retourner :
{
"state": "redirect"
}
Cette réponse ne fournit pas de jeton de continuation, de liens ou d’URL de transfert de navigateur. Arrêtez les requêtes natives et proposez une connexion de navigateur configurée séparément ou un échec clair. La connexion du navigateur redémarre l’authentification ; elle ne reprend pas la progression native.
Action de sélection de compte
Note
La sélection de compte n’est pas pertinente dans l’authentification native incorporée et n’est pas encore prise en charge pour les pages auto-hébergées BYO.
disambiguate identifie la sélection du compte sous state: interactionRequired.
Relations de lien
Utilisez des liens de la dernière réponse et validez leur autorité avant de transférer des secrets.
| Relation | Purpose |
|---|---|
self |
Ressource ou opération actuelle. |
discover |
Envoyez un identificateur de connexion. |
challenge |
Démarrez le défi de la méthode sélectionnée. |
verify |
Vérifiez un mot de passe ou un code secret à usage unique. |
resend |
Demandez un autre code secret à usage unique. |
submitAttributes |
Envoyez les valeurs d’inscription demandées. |
recover |
Démarrez la récupération de mot de passe dans la transaction de connexion active. |
enroll |
Démarrez l’inscription d’une méthode d’authentification annoncée. |
activate |
Vérifiez le code d’une méthode inscrite. |
update |
Envoyez un mot de passe de remplacement. |
poll |
Vérifiez une mise à jour asynchrone. |
continue |
Reprendre l’autorisation OAuth. |
Cette action s’applique à la sélection de compte BYO (Bring Your Own UX). Les intégrations d’authentification native incorporées ne l’utilisent pas, et la sélection de compte sur la page d’expérience utilisateur BYO auto-hébergée n’est actuellement pas prise en charge.
Si votre intégration d’expérience utilisateur BYO suit la solution de contournement recommandée en envoyant login_hint ou prompt=login dans la demande d’autorisation, l’introduction de la sélection de compte n’interrompt pas ou ne interrompt pas votre expérience utilisateur existante.
La charge utile d’action initialResponse fait partie du document existant du navigateur BYO UX et inclut :
-
state: interactionRequired,action: disambiguateet uncontinuationTokenpour la sélection en attente. - Tableau
_embedded.usercontenant des informations sur chaque compte proposé et les liens pris en charge. Un compte actif a une URL spécifique au_links.resumecompte. - URL de niveau
_links.discoverréponse pour un compte inactif ou utiliser un autre compte.
Ressources de méthode d’authentification
La sélection de méthode d’informations d’identification existantes utilise _embedded.methods. Le service peut également sélectionner une méthode unique. Les informations d’identification existantes ont un élément opaque id, type tel que password, emailou , et smsdes liens pour les opérations autorisées. Un masque hint identifie une destination sans la divulguer en intégralité ; isPreferred il s’agit des métadonnées de préférence facultatives. Les choix d’inscription ont une représentation distincte et n’ont pas besoin d’un ID d’informations d’identification existant.
{
"_embedded": {
"methods": [
{
"id": "{id}",
"type": "email",
"hint": "u***@contoso.com",
"isPreferred": true,
"_links": {
"challenge": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{id}/challenge"
},
"verify": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{id}/verify"
}
}
}
]
}
}
Ce fragment illustre les métadonnées de méthode. La disponibilité des méthodes est déterminée pour chaque transaction. Votre application peut présenter des méthodes disponibles ou en sélectionner une via la logique de flux d’application. Le défi et la vérification fonctionnent sur la méthode sélectionnée ; l’inscription de méthode a un contrat distinct.
Ne nécessite pas de métadonnées de présentation facultatives telles que pages ou scenario. Les exemples décrivent les interactions par mot de passe et par e-mail/SMS de base, pas toutes les exigences supplémentaires spécifiques à la méthode.
Démarrer l’autorisation
Envoyez l’application, les étendues et les revendications facultatives sur la requête initiale. Valeurs encodées par formulaire ; les sauts de ligne ci-dessous sont à des fins de lisibilité.
POST https://{custom_domain}/{tenant}/oauth2/v2.0/authorize-challenge
Content-Type: application/x-www-form-urlencoded
client_id={client_id}&
scope=openid%20profile%20offline_access&
response_type=code
| Parameter | Utiliser |
|---|---|
client_id |
ID d’application (client) requis. |
scope |
Étend vos demandes d’application. Incluez les étendues openID Connect (OIDC) et de ressources nécessaires pour les jetons résultants. |
response_type |
code dans cet exemple. Le point de terminaison retourne un code d’autorisation après l’authentification. |
claims |
Demande facultative de revendications OpenID Connect encodée au format JSON. |
Lorsque l’authentification est requise, la réponse est 401 Unauthorized, avec Content-Type: application/json:
{
"error": "InsufficientAuthorization",
"error_description": "AADSTS500127: No authenticated credentials found in request.",
"error_codes": [
500127
],
"timestamp": "2026-08-28T17:30:00Z",
"trace_id": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
"correlation_id": "aaaa0000-bb11-2222-33cc-444444dddddd",
"continuation_token": "******",
"reset_password": "/{tenant}/api/v2.0/resetpassword/start",
"sign_in": "/{tenant}/api/v2.0/signin/start",
"sign_up": "/{tenant}/api/v2.0/signup/start"
}
Les URL de connexion et d’inscription sont conditionnelles. Les liens de parcours sont des propriétés de réponse OAuth de niveau supérieur, et non _links des entrées. Sélectionnez un parcours publié et envoyez son jeton comme continuationToken dans la requête JSON. Gérez tout rejet spécifique à une stratégie ou à un compte.
Reprendre l’autorisation
Lorsque la réponse actuelle retourne state: continue, publiez le dernier jeton sur _links.continue.href. Ne renvoyez pas l’initial client_id, scopeou claims dans cette requête.
POST https://{custom_domain}/{tenant}/oauth2/v2.0/authorize-challenge
Content-Type: application/x-www-form-urlencoded
continuation_token={continuation_token}
La réponse réussie est 200 OK et JSON :
{
"code": "{authorization_code}"
}
Les codes d’autorisation sont à courte durée et à usage unique. Exchange le code plutôt que de le traiter comme un jeton d’accès.
Exchange le code d’autorisation
Publiez le code avec le même ID d’application :
POST https://{custom_domain}/{tenant}/oauth2/v2.0/token
Content-Type: application/x-www-form-urlencoded
client_id={client_id}&
grant_type=authorization_code&
code={authorization_code}
Les trois paramètres sont obligatoires.
grant_type a la valeur authorization_code. Cette demande publique-client ne contient pas de clé secrète client.
La réponse réussie est 200 OK et JSON :
{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "******",
"id_token": "******",
"refresh_token": "******"
}
Les champs de jeton dépendent des étendues et revendications établies initialement. Un jeton d’actualisation est retourné uniquement lorsque la requête initiale inclut offline_access. L’exemple de valeur d’expiration n’est pas une garantie de durée de vie fixe. Ne demandez offline_access pas si votre application n’a pas besoin d’un jeton d’actualisation.
Défier ou renvoyer
Suivez le lien de challenge la méthode sélectionnée ou un lien actuel resend lorsque le client demande un autre code secret :
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/{methodType}/{id}/challenge
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******"
}
Un défi par e-mail peut retourner :
{
"continuationToken": "******",
"state": "interactionRequired",
"action": "verify",
"id": "{email_method_id}",
"type": "email",
"hint": "u***@contoso.com",
"codeLength": 8,
"_links": {
"verify": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{email_method_id}/verify"
},
"resend": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{email_method_id}/challenge"
}
}
}
SMS utilise la même forme de défi d’informations d’identification avec type: sms, un indicateur de téléphone masqué et ses liens de méthode retournés. Les défis liés au mot de passe n’envoient aucun code secret et retournent une action de mot de passe verify . Utilisez l’exemple de longueur retourné codeLength, et non la longueur de l’exemple. Suivez la tentative contrôlée par le service et renvoyez les limites.
Vérifier les informations d’identification
Publier sur le lien actuel verify . Pour une méthode de mot de passe :
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/password/{id}/verify
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******",
"password": "******"
}
Pour une méthode e-mail ou SMS :
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/{methodType}/{id}/verify
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******",
"otp": "{one_time_passcode}"
}
La vérification peut retourner un autre défi, une collection d’attributs, une mise à jour de mot de passe ou une continuation. Gérez l’action retournée. La vérification n’est pas idempotente ; ne réessayez pas automatiquement après une défaillance réseau ambiguë.
Inscription de méthode d’authentification
L’inscription ou la connexion peuvent nécessiter l’inscription inline via action: enroll, suivie par action: activate. L’inscription est distincte de la collecte des attributs de profil ou de la vérification d’informations d’identification existantes.
Important
L’inscription est distincte de l’authentification avec une méthode inscrite. Utilisez uniquement les méthodes d’inscription publiées pour la transaction actuelle ; ne pas déduire une opération d’inscription à partir d’un défi d’informations d’identification.
Sélectionner et inscrire une méthode
Sélectionnez une méthode prise en charge et _embedded.methods suivez son _links.enroll URL.
| Méthode | Publicité | Champs JSON obligatoires |
|---|---|---|
| SMS de téléphone |
type: phone, avec sms en channels. |
continuationToken, phoneNumber y compris le code du pays et channel: sms. |
| Adresse e-mail |
type: email. |
continuationToken et email. N’envoyez pas de channel. |
L’inscription par téléphone utilise type: phone, et non le sms type utilisé par les méthodes de défi SMS existantes. L’exemple d’URL d’inscription par téléphone est /{tenant}/api/v2.0/auth/methods/phone; l’URL de messagerie est /{tenant}/api/v2.0/auth/methods/email. Utilisez POST json et suivez l’URL annoncée plutôt que de la construire.
Pour l’inscription par SMS téléphonique, le corps est :
{
"continuationToken": "******",
"phoneNumber": "+1 2025550123",
"channel": "sms"
}
Pour l’inscription par e-mail, le corps est :
{
"continuationToken": "******",
"email": "user@contoso.com"
}
Le service envoie un code secret et retourne action: activate, un nouveau jeton de continuation et un activate lien. Affichez le masquage retourné hint et codeLength le moment présent. L’e-mail et le SMS peuvent utiliser différentes longueurs de code.
Une réponse d’activation par téléphone peut être :
{
"continuationToken": "******",
"state": "interactionRequired",
"action": "activate",
"id": "{phone_method_id}",
"type": "phone",
"channel": "sms",
"hint": "***0123",
"codeLength": 6,
"_links": {
"activate": {
"href": "/{tenant}/api/v2.0/auth/methods/phone/{phone_method_id}/activate"
},
"resend": {
"href": "/{tenant}/api/v2.0/auth/methods/phone"
}
}
}
Utilisez les champs et les liens de la réponse réelle ; l’e-mail utilise son propre type de méthode, sa longueur de code et ses liens.
Activer ou renvoyer
Envoyez un JSON POST au lien actuel activate avec le code le plus récent continuationToken et le code de l’utilisateur dans otp. Exemples téléphoniques utilisés /{tenant}/api/v2.0/auth/methods/phone/{phone_method_id}/activate; l’e-mail utilise son propre lien publié. N’envoyez pas de codes d’activation au lien d’informations d’identification verify .
{
"continuationToken": "******",
"otp": "{one_time_passcode}"
}
Si la réponse d’activation publie resend, envoyez un JSON POST contenant uniquement la dernière continuationToken version à ce lien. Le lien peut pointer vers l’inscription. Ne conservez pas ou renvoyez les coordonnées ; le jeton porte le contexte d’inscription.
{
"continuationToken": "******"
}
Remplacez le jeton actif, les liens, l’indicateur et la longueur du code après chaque réponse. Continuer la gestion des actions retournées après l’activation ; autorise uniquement state: continue la reprise de l’autorisation. L’inscription peut elle-même satisfaire l’authentification multifacteur. Par conséquent, un défi d’informations d’identification distinct n’est pas toujours obligatoire.
Pour invalidGrant cela innerError.code: invalidOneTimeCode, conservez le jeton d’activation actuel et les liens publiés. Laissez l’utilisateur corriger le code ou demander un renvoi. Ne relectez pas automatiquement l’inscription ou l’activation après un échec de connexion ambigu.
Errors
Les erreurs OAuth utilisent des champs tels que error, error_descriptiontrace_idet correlation_id. Les échecs d’authentification native utilisent une enveloppe imbriquée. Par exemple, un code de vérification de courrier incorrect peut retourner HTTP 400 avec :
{
"error": {
"code": "invalidGrant",
"message": "AADSTS50181: Unable to validate the otp.",
"timestamp": "2026-08-28T17:30:00Z",
"traceId": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
"correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"innerError": {
"code": "invalidOneTimeCode"
}
}
}
Utilisez des codes stables pour la gestion plutôt que les messages localisés. La validation d’attribut peut retourner error.innerError.code: attributeValidationError avec details des entrées contenant code, messageet attributeIds, et , plus facultatif suggestions ou recovery. Vérifiez l’état HTTP et le type de contenu avant l’analyse ; ne restituez pas un corps d’erreur HTML inattendu dans l’application.
| Pathologie | État ou erreur | Handling |
|---|---|---|
| Paramètre OAuth non valide | 400 invalid_request |
Corrigez la demande ; n’effectuez pas de nouvelle tentative inchangée. |
| Code non valide ou expiré | 400 invalid_grant |
Redémarrez l’autorisation. |
| Application non valide | 400 invalid_client |
Configuration correcte de l’application. |
| Étendue non valide ou non valide | 400 invalid_scope |
Vérifiez les étendues demandées et le consentement. |
| Authentification requise | 401 InsufficientAuthorization |
Suivez un lien de parcours activé. |
| Jeton de continuation/état non valide | 400 invalidRequest |
Redémarrez le flux applicable. |
| Jeton de mise à jour du mot de passe expiré |
400 expiredToken avec innerError.code: expiredContinuationToken |
Redémarrez l’autorisation. |
| Code de vérification manquant | 400 invalidRequest |
Corrigez l’entrée manquante. |
| Code de vérification par e-mail ou SMS incorrect |
400 invalidGrant avec innerError.code: invalidOneTimeCode |
Laissez l’utilisateur corriger le code à l’aide de l’état de vérification actuel utilisable ou suivez un lien de renvoi publié. Ne soumettez pas automatiquement. |
| Code d’activation incorrect |
400 invalidGrant avec innerError.code: invalidOneTimeCode |
Conservez le jeton d’activation actuel et les liens publiés. Laissez l’utilisateur corriger le code ou utiliser une action de réexécrite annoncée. Ne soumettez pas automatiquement. |
| Interaction du navigateur requise |
invalid_grant avec web_redirect_required |
Arrêtez les requêtes natives et utilisez le chemin de récupération interactif configuré. Ne transférez pas le jeton de continuation vers une URL arbitraire. |
| La transaction native ne peut pas continuer | Corps natif {"state":"redirect"} |
Arrêtez les requêtes natives. Une connexion de navigateur distincte ne conserve pas la progression native. |
| Limitation du débit | 429 |
Respectez Retry-After et les conseils sur le serveur. |
Les échecs de réseau et de service peuvent utiliser d’autres formats de réponse. Traitez un type de contenu inattendu comme un échec explicite. Le tableau décrit des cas courants spécifiques, et non un catalogue d’erreurs exhaustif pour chaque opération.
Sécurité et diagnostics
Utilisez HTTPS pour chaque requête en amont. Conservez les mots de passe, les codes secrets, les jetons de continuation, les codes et les jetons émis en dehors des URL, des journaux, des données de télémétrie, des exceptions, des captures d’écran et prennent en charge les pièces jointes. Ne ayez pas de réponses d’authentification en cache ou partagez l’état des transactions entre les utilisateurs.
Refusez les autorités inattendues et redirigez plutôt que de transférer des secrets. Ne réessayez pas automatiquement la vérification des informations d’identification, les soumissions de création de compte ou les mises à jour de mot de passe après une défaillance ambiguë.
Afficher uniquement les indicateurs masqués fournis par le service. Utilisez des échecs de découverte génériques afin que les messages et la présentation des méthodes ne divulguent pas inutilement l’existence du compte.
Conservez les diagnostics sécurisés : état HTTP, catégorie d’opération, client-request-id, ID de trace/corrélation de service et horodatage. Les noms OAuth utilisent des traits de soulignement ; Les noms d’erreurs d’authentification native utilisent le cas chameau. Extrayez ces champs de diagnostic sans conserver les corps de requête ou de réponse complets.
Extensions d’authentification personnalisées
La configuration des événements et les contrats sont spécifiques à chaque extension et parcours. Votre application continue de sélectionner les opérations autorisées dans les réponses de service lorsqu’une extension participe au flux.
La couverture des événements natifs inclut OnOtpSend l’e-mail et OnTokenIssuanceStart.
OnAttributeCollectionStart et OnAttributeCollectionSubmit ne sont pas pris en charge pour l’authentification native incorporée ou apportez votre propre expérience utilisateur. Consultez les extensions d’authentification personnalisées pour un comportement spécifique à l’événement. Cet ensemble d’événements n’établit pas de hooks de migration de mot de passe, de synchronisation de mise à jour de mot de passe ou de propagation de contexte arbitraire.