Method: accounts.mfaSignIn.start

傳送多重驗證挑戰

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體包含下列結構的資料:

JSON 表示法
{
  "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.
}
欄位
mfaPendingCredential

string

這是必要旗標,第一層驗證機制登入的憑證尚未完成。

mfaEnrollmentId

string

這是必要旗標,使用者目前多重驗證註冊項目清單中的多重驗證註冊 ID。

tenantId

string

使用者要登入的 Identity Platform 租用戶 ID。如果未設定,使用者會登入預設的 Identity Platform 專案。

聯集欄位 sign_in_info。按 2 級驗證類型區分的多重驗證資訊。sign_in_info 只能是下列其中一項:
phoneSignInInfo

object (StartMfaPhoneRequestInfo)

授權傳送簡訊進行電話驗證的驗證資訊。

回應主體

mfaSignIn.start 回應。

如果成功,回應主體會含有以下結構的資料:

JSON 表示法
{

  // 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.
}
欄位
聯集欄位 response_info。多重驗證開始登入回應,並根據第 2 種驗證類型進行驗證。response_info 只能是下列其中一項:
phoneResponseInfo

object (StartMfaPhoneResponseInfo)

專屬於簡訊類型第二因素的多重驗證登入工作階段資訊。除了從傳送的簡訊擷取的一次性驗證碼外,您也應將這個工作階段資訊的內容傳遞至 mfaSignIn.finalize,以便完成登入程序。

授權範圍

需要下列其中一種 OAuth 範圍:

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

詳情請參閱 Authentication Overview