Method: accounts.mfaEnrollment.finalize

為使用者註冊次要驗證方法。

HTTP 要求

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

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

要求主體

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

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.
}
欄位
idToken

string

這是必要旗標，ID 權杖。
displayName

string

使用者輸入的顯示名稱，用於區分相同或不同類型的第二種驗證方式。
tenantId

string

使用者註冊 MFA 所屬的 Identity Platform 租用戶 ID。如果未設定，使用者就會屬於預設的 Identity Platform 專案。
聯集欄位 verification_info。需要驗證的多重驗證註冊資訊。verification_info 只能是下列其中一項：
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

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

object (FinalizeMfaTotpEnrollmentRequestInfo)

TOTP 的驗證資訊。

回應主體

mfaEnrollment.finalize 回應。

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

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.
}
欄位
idToken

string

ID 權杖已更新，反映多重身份驗證註冊狀態。
refreshToken

string

重新整理權杖，以反映多重身分驗證註冊狀態。
聯集欄位 auxiliary_auth_info。已驗證的多重驗證註冊資訊。auxiliary_auth_info 只能是下列其中一項：
phoneAuthInfo

object (FinalizeMfaPhoneResponseInfo)

電話驗證專用的輔助驗證資訊。
totpAuthInfo

object (FinalizeMfaTotpEnrollmentResponseInfo)

專屬於 TOTP 驗證的輔助驗證資訊。

授權範圍

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

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

詳情請參閱 Authentication Overview。

FinalizeMfaTotpEnrollmentRequestInfo

針對 FinalizeMfa 的 TOTP 驗證，特定的 MFA 要求資訊。

JSON 表示法 
{
  "sessionInfo": string,
  "verificationCode": string
}
欄位
sessionInfo

string

代表註冊工作階段的不透明字串。
verificationCode

string

使用者輸入的驗證碼。

FinalizeMfaTotpEnrollmentResponseInfo

這個類型沒有任何欄位。

針對 FinalizeMfa 的 TOTP 驗證，專屬的 MFA 回應資訊。