Method: accounts.mfaEnrollment.finalize

사용자의 두 번째 단계 등록을 완료합니다.

HTTP 요청

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

URL은 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

사용자가 동일한 유형 또는 다른 유형의 2단계 인증을 구분하기 위해 입력하는 표시 이름입니다.
tenantId

string

MFA를 등록하는 사용자가 속한 Identity Platform 테넌트의 ID입니다. 설정하지 않으면 사용자는 기본 Identity Platform 프로젝트에 속합니다.
통합 필드 verification_info. 확인할 MFA 등록 정보 verification_info은 다음 중 하나여야 합니다.
phoneVerificationInfo

object (FinalizeMfaPhoneRequestInfo)

전화 인증을 위한 SMS 전송을 승인하는 인증 정보입니다.
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

MFA 등록을 반영하도록 ID 토큰이 업데이트되었습니다.
refreshToken

string

MFA 등록을 반영하도록 갱신 토큰이 업데이트되었습니다.
통합 필드 auxiliary_auth_info. MFA로 등록 정보가 확인되었습니다. 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 응답 정보입니다.