Method: accounts.mfaSignIn.finalize

Prüft die MFA-Abfrage und führt die Anmeldung durch

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
mfaPendingCredential

string

Pflichtangabe. Anmeldedaten aus der Anmeldung mit dem ersten Faktor ausstehend.
tenantId

string

Die ID des Identity Platform-Mandanten, bei dem sich der Nutzer anmeldet. Wenn nicht festgelegt, meldet sich der Nutzer im Standardprojekt von Identity Platform an.
mfaEnrollmentId

string

Die MFA-Registrierungs-ID aus der Liste der aktuellen MFA-Registrierungen des Nutzers.
Union-Feld verification_info. Nachweis, dass die MFA-Abfrage abgeschlossen wurde. Für verification_info ist nur einer der folgenden Werte zulässig:
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

Nachweis, dass die SMS-basierte MFA-Herausforderung abgeschlossen wurde.
totpVerificationInfo

object (MfaTotpSignInRequestInfo)

Nachweis, dass die TOTP-basierte MFA-Herausforderung abgeschlossen wurde.

Antworttext

mfaSignIn.finalize-Antwort.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
idToken

string

ID-Token für den authentifizierten Nutzer.
refreshToken

string

Aktualisierungstoken für den authentifizierten Nutzer.
Union-Feld auxiliary_auth_info. Anmeldedaten, die mit der Multi-Faktor-Authentifizierung bestätigt wurden Für auxiliary_auth_info ist nur einer der folgenden Werte zulässig:
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

Zusätzliche Informationen zur Smartphone-Authentifizierung, einschließlich Nachweis der Android-Bestätigung

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

MfaTotpSignInRequestInfo

TOTP-Bestätigungsinformationen für FinalizeMfaSignInRequest.

JSON-Darstellung 
{
  "verificationCode": string
}
Felder
verificationCode

string

Vom Nutzer eingegebener Bestätigungscode.