Method: accounts.mfaSignIn.finalize

MFA チャレンジを検証してログインを実行する

HTTP リクエスト

POST https://identitytoolkit.googleapis.com/v2/accounts/mfaSignIn:finalize

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "mfaPendingCredential": string,
  "tenantId": string,
  "mfaEnrollmentId": string,

  // Union field verification_info can be only one of the following:
  "phoneVerificationInfo": {
    object (FinalizeMfaPhoneRequestInfo)
  },
  "totpVerificationInfo": {
    object (MfaTotpSignInRequestInfo)
  }
  // End of list of possible types for union field verification_info.
}
フィールド
mfaPendingCredential

string

必須。第 1 要素でのログインからの認証情報の保留中。
tenantId

string

ユーザーがログインしている Identity Platform テナントの ID。設定されていない場合、ユーザーはデフォルトの Identity Platform プロジェクトにログインします。
mfaEnrollmentId

string

ユーザーの現在の MFA 登録リストにある MFA 登録 ID。
共用体フィールド verification_info。MFA チャレンジの完了を証明する書類。verification_info は次のいずれかになります。
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

SMS ベースの MFA チャレンジの完了を証明する書類。
totpVerificationInfo

object (MfaTotpSignInRequestInfo)

TOTP ベースの MFA チャレンジの完了を証明する書類。

レスポンスの本文

mfaSignIn.finalize レスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "idToken": string,
  "refreshToken": string,

  // Union field auxiliary_auth_info can be only one of the following:
  "phoneAuthInfo": {
    object (FinalizeMfaPhoneResponseInfo)
  }
  // End of list of possible types for union field auxiliary_auth_info.
}
フィールド
idToken

string

認証されたユーザーの ID トークン。
refreshToken

string

認証されたユーザーの更新トークン。
共用体フィールド auxiliary_auth_info。MFA で確認されたログイン情報。auxiliary_auth_info は次のいずれかになります。
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Android の確認証明書など、スマートフォンの追加の認証情報。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

詳細については、Authentication Overview をご覧ください。

MfaTotpSignInRequestInfo

FinalizeMfaSignInRequest の TOTP 確認情報。

JSON 表現 
{
  "verificationCode": string
}
フィールド
verificationCode

string

ユーザーが入力した確認コード。