Method: accounts.mfaEnrollment.finalize

Completa la registrazione di un secondo fattore per l'utente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
idToken

string

Obbligatorio. Token ID.

displayName

string

Nome visualizzato inserito dagli utenti per distinguere i diversi secondi fattori dello stesso tipo o di tipo diverso.

tenantId

string

L'ID del tenant Identity Platform a cui appartiene l'utente che registra l'MFA. Se non è impostato, l'utente appartiene al progetto Identity Platform predefinito.

Campo unione verification_info. Dati di registrazione della verifica in due passaggi da verificare. verification_info può essere solo uno dei seguenti:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Informazioni di verifica per autorizzare l'invio di un SMS per la verifica telefonica.

totpVerificationInfo

object (FinalizeMfaTotpEnrollmentRequestInfo)

Informazioni di verifica per TOTP.

Corpo della risposta

Risposta mfaEnrollment.finalize.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
idToken

string

Token ID aggiornato in base alla registrazione all'MFA.

refreshToken

string

Il token di aggiornamento è stato aggiornato in base alla registrazione all'MFA.

Campo unione auxiliary_auth_info. Dati di registrazione verificati con l'autenticazione a più fattori. auxiliary_auth_info può essere solo uno dei seguenti:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Informazioni di autenticazione ausiliarie specifiche per l'autenticazione del telefono.

totpAuthInfo

object (FinalizeMfaTotpEnrollmentResponseInfo)

Informazioni di autenticazione ausiliarie specifiche per l'autenticazione TOTP.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.

FinalizeMfaTotpEnrollmentRequestInfo

Informazioni sulla richiesta di autenticazione a due fattori specifiche per l'autenticazione TOTP per FinalizeMfa.

Rappresentazione JSON
{
  "sessionInfo": string,
  "verificationCode": string
}
Campi
sessionInfo

string

Una stringa opaca che rappresenta la sessione di registrazione.

verificationCode

string

Codice di verifica inserito dall'utente.

FinalizeMfaTotpEnrollmentResponseInfo

Questo tipo non contiene campi.

Informazioni sulla risposta dell'autenticazione a due fattori specifiche per l'autenticazione TOTP per FinalizeMfa.