Défi-réponse avec les codes de récupération

Décrit comment utiliser l’API MFA pour lancer un défi-réponse aux utilisateurs qui perdent l’accès à leur appareil ou à leur compte à l’aide de codes de récupération.

Lorsque les codes de récupération sont activés pour votre locataire, Auth0 les génère automatiquement lorsqu’un utilisateur s’inscrit avec l’authentification multifacteur (MFA). L’utilisateur doit enregistrer le code de récupération. Ce code pourra être utilisé ultérieurement si l’utilisateur perd l’accès à l’appareil ou au compte utilisé pour la MFA.

Lorsque les codes de récupération sont désactivés, l’API de MFA ne renvoie pas de code de récupération lorsque vous associez le premier facteur MFA d’un utilisateur et que les utilisateurs ne peuvent pas s’authentifier avec un code de récupération.

Vous pouvez autoriser les utilisateurs à s’authentifier avec un code de récupération à l’aide de l’API MFA.

1. Demandez à l’utilisateur son code de récupération. Cette valeur doit être saisie dans l’application pour que l’utilisateur puisse s’authentifier.

   Auth0 ne génère pas de codes de récupération pour DUO et pour l’ancien facteur google-authenticator.

2. Authentifiez-vous avec le code de récupération. Appelez le point de terminaison OAuth Token avec le code de récupération pour vous authentifier et générer un nouveau code de récupération. Vous devez préciser les paramètres suivants :

Paramètre	Valeur
grant_type	http://auth0.com/oauth/grant-type/mfa-recovery-code
recovery_code	Le code de récupération fourni par l’utilisateur.

3. Invitez l’utilisateur à recueillir le code de récupération. Si l’appel réussit, vous obtiendrez les jetons d’authentification et un nouveau code de récupération :

   {
       "access_token": "O3...H4",
       "id_token": "eyJh...w",
       "scope": "openid profile",
       "expires_in": 86400,
       "recovery_code": "K6LGLV3RSH3VERMKET8L7QKU",
       "token_type": "Bearer"
   }
   

4. Avertissez l’utilisateur qu’un nouveau code de récupération a été généré et demandez-lui de le recueillir.

​

En savoir plus

• Facteurs d’authentification SMS et vocaux pour l’inscription et les défis de connexion
• Inscrire et lancer un défi-réponse pour les authentifiants Push
• Inscription et défi des authentificateurs OTP
• Inscription et authentifiants par défi-réponse avec courriel
• API MFA Auth0
• Gérer les facteurs d’authentification avec l’Authentication API