Method: accounts.mfaEnrollment.finalize

Termina de inscribir un segundo factor para el usuario.

Solicitud HTTP

POST https://identitytoolkit.googleapis.com/v2/accounts/mfaEnrollment: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 
{
  "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.
}
Campos
idToken

string

Obligatorio. Token de ID
displayName

string

Es el nombre visible que ingresan los usuarios para distinguir entre diferentes segundos factores con el mismo tipo o con un tipo diferente.
tenantId

string

El ID del grupo de usuarios de Identity Platform al que pertenece el usuario que inscribe la MFA. Si no se establece, el usuario pertenece al proyecto predeterminado de Identity Platform.
Campo de unión verification_info. Se debe verificar la información de inscripción de la MFA. verification_info puede ser solo uno de los siguientes:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Información de verificación para autorizar el envío de un SMS de verificación telefónica
totpVerificationInfo

object (FinalizeMfaTotpEnrollmentRequestInfo)

Información de verificación para TOTP.

Cuerpo de la respuesta

mfaEnrollment.finalize response.

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

string

Se actualizó el token de ID para reflejar la inscripción de la MFA.
refreshToken

string

Se actualizó el token de actualización para reflejar la inscripción de la MFA.
Campo de unión auxiliary_auth_info. Información de inscripción verificada por la MFA auxiliary_auth_info puede ser solo uno de los siguientes:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Información de autenticación auxiliar específica de la autenticación telefónica.
totpAuthInfo

object (FinalizeMfaTotpEnrollmentResponseInfo)

Información de autenticación auxiliar específica de la autenticación de TOTP.

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.

FinalizeMfaTotpEnrollmentRequestInfo

Información de la solicitud de MFA específica para la autenticación de TOTP para FinalizeMfa.

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

string

Es una cadena opaca que representa la sesión de inscripción.
verificationCode

string

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

FinalizeMfaTotpEnrollmentResponseInfo

Este tipo no tiene campos.

Información de respuesta de MFA específica para la autenticación de TOTP para FinalizeMfa.