リカバリーコードによるチャレンジ

デバイスまたはアカウントへのアクセスを失ったユーザーに対して、MFA API を使用してリカバリーコードによるチャレンジを行う方法を説明します。

テナントでリカバリーコードが有効になっている場合、Auth0 はユーザーが多要素認証 (MFA) に登録すると、自動的にリカバリーコードを生成します。ユーザーはリカバリーコードを保存しておく必要があります。このコードは、後でユーザーが MFA に使用したデバイスまたはアカウントにアクセスできなくなった場合に使用できます。

リカバリーコードが無効になっている場合、MFA API はユーザーの最初の MFA 認証要素を関連付ける際にリカバリーコードを返さず、ユーザーはリカバリーコードを使用して認証できません。

MFA API を使用すると、ユーザーがリカバリーコードで認証できるようにできます。

1. ユーザーにリカバリーコードの入力を求めます。ユーザーが認証できるようにするには、その値をアプリケーションに入力する必要があります。

   Auth0 は、DUO とレガシー google-authenticator 認証要素ではリカバリーコードを生成しません。

2. リカバリーコードで認証します。OAuth Token エンドポイントをリカバリーコードとともに呼び出して認証し、新しいリカバリーコードを生成します。次のパラメーターを指定する必要があります。

   パラメーター	値
   grant_type	http://auth0.com/oauth/grant-type/mfa-recovery-code
   recovery_code	ユーザーから提供されたリカバリーコード。

3. ユーザーにリカバリーコードを控えるよう促します。呼び出しが成功すると、認証トークンと新しいリカバリーコードが返されます。

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

4. 新しいリカバリーコードが生成されたことをユーザーに通知し、それを控えるよう求めます。

​

詳しくはこちら

• SMS および音声の認証器の登録とチャレンジ
• プッシュ認証器の登録とチャレンジ
• OTP 認証器の登録とチャレンジ
• メールアドレス認証器の登録とチャレンジ
• Auth0 MFA API
• Authentication API で認証要素を管理する