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

注册多重身份验证的用户所属的 Identity Platform 租户的 ID。如果未设置，则用户属于默认的 Identity Platform 项目。
联合字段 verification_info。要验证的多重身份验证 (MFA) 注册信息。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

更新了身份令牌以反映多重身份验证注册。
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 响应信息。