リカバリーコードで検証

ユーザーが登録済みデバイスを利用できない場合に、リカバリーコードを使用して MFA を検証します。

​

エンドポイント

POST /oauth/token

回復コードを使用して多要素認証 (MFA) を検証します。一部の多要素認証 (MFA) プロバイダー (Guardian など) では、ログイン時に回復コードを使用できます。ユーザーが登録済みデバイスを利用できない場合や、接続の問題によってチャレンジを受信または承認できない場合は、このメソッドを使用して認証します。

回復コードを使用して MFA を検証するには、アプリでユーザーに回復コードの入力を求め、grant_type=http://auth0.com/oauth/grant-type/mfa-recovery-code を指定して /oauth/token にリクエストを送信する必要があります。入力された回復コードと、mfa_required エラーで返される mfa_token を含めてください。回復コードが受け入れられた場合、レスポンスは password または http://auth0.com/oauth/grant-type/password-realm の grant type と同じになります。また、recovery_code フィールドが含まれることもあります。その場合、アプリケーションは今後使用できるよう、エンドユーザーに表示して安全に保管してもらう必要があります。

​

ヘッダー

DPoP · string

リクエストの DPoP プルーフです。これは省略可能で、アプリケーションで Demonstrating Proof-of-Possession を使用している場合にのみ必要です。

​

ボディパラメーター

grant_type · string · 必須

使用するフローを示します。リカバリーコードの場合は http://auth0.com/oauth/grant-type/mfa-recovery-code を使用します。

使用可能な値: http://auth0.com/oauth/grant-type/mfa-recovery-code

client_id · string · 必須

アプリケーションのクライアントID。

client_assertion · string

アプリケーションの認証情報を含む、署名付きアサーションを格納した JWT。

client_assertion_type · string

値は urn:ietf:params:oauth:client-assertion-type:jwt-bearer です。

使用可能な値: urn:ietf:params:oauth:client-assertion-type:jwt-bearer

client_secret · string

アプリケーションのクライアントシークレット。

mfa_token · string · 必須

mfa_required エラーで受け取った mfa_token。

recovery_code · string · 必須

エンドユーザーから提供されたリカバリーコード。

​

レスポンススキーマ

​

レスポンスメッセージ

Status	Description
200	回復コードの検証に成功した場合のレスポンスです。
400	パラメーターが不足しているか無効なため、不正なリクエストです。
401	未認証です。mfa_token または recovery_code が無効です。