Method: accounts.mfaSignIn.start

MFA-Herausforderung senden

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "mfaPendingCredential": string,
  "mfaEnrollmentId": string,
  "tenantId": string,

  // Union field sign_in_info can be only one of the following:
  "phoneSignInInfo": {
    object (StartMfaPhoneRequestInfo)
  }
  // End of list of possible types for union field sign_in_info.
}
Felder
mfaPendingCredential

string

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

string

Pflichtangabe. MFA-Registrierungs-ID aus der Liste der aktuellen MFA-Registrierungen des Nutzers.
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.
Union-Feld sign_in_info. Informationen zur MFA nach Art des zweiten Faktors. Für sign_in_info ist nur einer der folgenden Werte zulässig:
phoneSignInInfo

object (StartMfaPhoneRequestInfo)

Bestätigungsinformationen, um das Senden einer SMS zur Bestätigung des Smartphones zu autorisieren.

Antworttext

mfaSignIn.start-Antwort.

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

JSON-Darstellung 
{

  // Union field response_info can be only one of the following:
  "phoneResponseInfo": {
    object (StartMfaPhoneResponseInfo)
  }
  // End of list of possible types for union field response_info.
}
Felder
Union-Feld response_info. MultiFactor start sign-in response by 2nd factor type. Für response_info ist nur einer der folgenden Werte zulässig:
phoneResponseInfo

object (StartMfaPhoneResponseInfo)

Informationen zur Multi-Faktor-Anmeldesitzung, die sich auf zweite Faktoren vom Typ „SMS“ beziehen. Zusammen mit dem Einmalcode, der aus der gesendeten SMS abgerufen wurde, sollten die Inhalte dieser Sitzungsinformationen an mfaSignIn.finalize übergeben werden, um die Anmeldung abzuschließen.

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.