Method: accounts.mfaSignIn.finalize

Memverifikasi tantangan MFA dan melakukan login

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
mfaPendingCredential

string

Wajib. Kredensial tertunda dari login faktor pertama.
tenantId

string

ID tenant Identity Platform tempat pengguna login. Jika tidak ditetapkan, pengguna akan login ke project Identity Platform default.
mfaEnrollmentId

string

ID pendaftaran MFA dari daftar pendaftaran MFA pengguna saat ini.
Kolom union verification_info. Bukti penyelesaian tantangan MFA. verification_info hanya ada berupa salah satu diantara berikut:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Bukti penyelesaian tantangan MFA berbasis SMS.
totpVerificationInfo

object (MfaTotpSignInRequestInfo)

Bukti penyelesaian tantangan MFA berbasis TOTP.

Isi respons

Respons mfaSignIn.finalize.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
idToken

string

Token ID untuk pengguna yang diautentikasi.
refreshToken

string

Token refresh untuk pengguna yang diautentikasi.
Kolom union auxiliary_auth_info. Informasi login yang diverifikasi MFA. auxiliary_auth_info hanya ada berupa salah satu diantara berikut:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Info autentikasi telepon tambahan, termasuk bukti verifikasi Android.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

MfaTotpSignInRequestInfo

Info verifikasi TOTP untuk FinalizeMfaSignInRequest.

Representasi JSON 
{
  "verificationCode": string
}
Kolom
verificationCode

string

Kode verifikasi yang dimasukkan pengguna.