Method: accounts.mfaSignIn.finalize

Verifica el desafío de la MFA y accede

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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.
}
Campos
mfaPendingCredential

string

Obligatorio. Credenciales pendientes del acceso con el primer factor

tenantId

string

El ID del grupo de usuarios de Identity Platform al que accede el usuario. Si no se establece, el usuario accederá al proyecto predeterminado de Identity Platform.

mfaEnrollmentId

string

El ID de inscripción de la MFA de la lista de inscripciones actuales de la MFA del usuario

Campo de unión verification_info. Prueba de finalización del desafío de MFA verification_info puede ser solo uno de los siguientes:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Prueba de que se completó el desafío de la MFA basada en SMS

totpVerificationInfo

object (MfaTotpSignInRequestInfo)

Prueba de que se completó el desafío de MFA basado en TOTP

Cuerpo de la respuesta

Respuesta de mfaSignIn.finalize.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación 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.
}
Campos
idToken

string

Token de ID para el usuario autenticado

refreshToken

string

Token de actualización para el usuario autenticado.

Campo de unión auxiliary_auth_info. Información de acceso verificada con la MFA auxiliary_auth_info puede ser solo uno de los siguientes:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Información adicional de autenticación telefónica, incluida la prueba de verificación de Android

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

MfaTotpSignInRequestInfo

Información de verificación de TOTP para FinalizeMfaSignInRequest.

Representación JSON
{
  "verificationCode": string
}
Campos
verificationCode

string

Es el código de verificación que ingresó el usuario.