Method: accounts.mfaEnrollment.finalize

Menyelesaikan pendaftaran faktor kedua untuk pengguna.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "idToken": string,
  "displayName": string,
  "tenantId": string,

  // Union field verification_info can be only one of the following:
  "phoneVerificationInfo": {
    object (FinalizeMfaPhoneRequestInfo)
  },
  "totpVerificationInfo": {
    object (FinalizeMfaTotpEnrollmentRequestInfo)
  }
  // End of list of possible types for union field verification_info.
}
Kolom
idToken

string

Wajib. Token ID.
displayName

string

Nama tampilan yang dimasukkan oleh pengguna untuk membedakan antara faktor kedua yang berbeda dengan jenis yang sama atau jenis yang berbeda.
tenantId

string

ID tenant Identity Platform tempat pengguna yang mendaftarkan MFA berada. Jika tidak ditetapkan, pengguna akan menjadi bagian dari project Identity Platform default.
Kolom union verification_info. Informasi pendaftaran MFA yang akan diverifikasi. verification_info hanya ada berupa salah satu diantara berikut:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Info verifikasi untuk mengizinkan pengiriman SMS guna verifikasi telepon.
totpVerificationInfo

object (FinalizeMfaTotpEnrollmentRequestInfo)

Informasi verifikasi untuk TOTP.

Isi respons

Respons mfaEnrollment.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)
  },
  "totpAuthInfo": {
    object (FinalizeMfaTotpEnrollmentResponseInfo)
  }
  // End of list of possible types for union field auxiliary_auth_info.
}
Kolom
idToken

string

Token ID diperbarui untuk mencerminkan pendaftaran MFA.
refreshToken

string

Token refresh diperbarui untuk mencerminkan pendaftaran MFA.
Kolom union auxiliary_auth_info. Informasi pendaftaran yang diverifikasi MFA. auxiliary_auth_info hanya ada berupa salah satu diantara berikut:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Info autentikasi tambahan khusus untuk autentikasi ponsel.
totpAuthInfo

object (FinalizeMfaTotpEnrollmentResponseInfo)

Info autentikasi tambahan khusus untuk autentikasi TOTP.

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.

FinalizeMfaTotpEnrollmentRequestInfo

Info permintaan MFA khusus untuk autentikasi TOTP untuk FinalizeMfa.

Representasi JSON 
{
  "sessionInfo": string,
  "verificationCode": string
}
Kolom
sessionInfo

string

String buram yang mewakili sesi pendaftaran.
verificationCode

string

Kode verifikasi yang dimasukkan pengguna.

FinalizeMfaTotpEnrollmentResponseInfo

Jenis ini tidak memiliki kolom.

Info respons MFA khusus untuk autentikasi TOTP untuk FinalizeMfa.