Method: accounts.mfaSignIn.finalize

Verifica o desafio de MFA e faz o login

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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

Obrigatório. Credencial pendente do primeiro fator de login.
tenantId

string

O ID do locatário do Identity Platform em que o usuário está fazendo login. Se não for definido, o usuário vai fazer login no projeto padrão do Identity Platform.
mfaEnrollmentId

string

O ID de registro da MFA da lista de registros atuais da MFA do usuário.
Campo de união verification_info. Prova de conclusão do desafio de MFA. verification_info pode ser apenas de um dos tipos a seguir:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Prova de conclusão do desafio de MFA com base em SMS.
totpVerificationInfo

object (MfaTotpSignInRequestInfo)

Prova de conclusão do teste de MFA baseado em TOTP.

Corpo da resposta

Resposta mfaSignIn.finalize.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação 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 do usuário autenticado.
refreshToken

string

Token de atualização para o usuário autenticado.
Campo de união auxiliary_auth_info. Informações de login verificadas pela MFA. auxiliary_auth_info pode ser apenas de um dos tipos a seguir:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Informações extras de autenticação do smartphone, incluindo comprovante de verificação do Android.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

MfaTotpSignInRequestInfo

Informações de verificação de TOTP para FinalizeMfaSignInRequest.

Representação JSON 
{
  "verificationCode": string
}
Campos
verificationCode

string

Código de verificação inserido pelo usuário.