Method: accounts.signInWithCustomToken

커스텀 인증 토큰을 교환하여 사용자를 로그인 또는 가입 처리합니다. 로그인 또는 가입이 완료되면 사용자에게 새 Identity Platform ID 토큰과 갱신 토큰이 발급됩니다.

Google Cloud 프로젝트를 식별하려면 요청에 API 키가 필요합니다.

HTTP 요청

POST https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "token": string,
  "instanceId": string,
  "returnSecureToken": boolean,
  "delegatedProjectNumber": string,
  "tenantId": string
}
필드
token

string

필수 입력란입니다. 개발자가 어설션한 맞춤 인증 토큰입니다. 토큰은 API 참조의 '맞춤 토큰 클레임' 섹션에 나열된 클레임이 포함된 JSON 웹 토큰 (JWT)이어야 합니다.
instanceId
(deprecated)

string
returnSecureToken

boolean

항상 참이어야 합니다.
delegatedProjectNumber
(deprecated)

string (int64 format)
tenantId

string

사용자가 로그인하는 Identity Platform 테넌트의 ID입니다. 있는 경우 ID는 토큰의 tenantId와 일치해야 합니다.

응답 본문

accounts.signInWithCustomToken의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "kind": string,
  "idToken": string,
  "refreshToken": string,
  "expiresIn": string,
  "isNewUser": boolean
}
필드
kind
(deprecated)

string
idToken

string

인증된 사용자의 Identity Platform ID 토큰입니다.
refreshToken

string

인증된 사용자의 Identity Platform 갱신 토큰입니다.
expiresIn

string (int64 format)

ID 토큰이 만료될 때까지 남은 시간(초)입니다.
isNewUser

boolean

이 요청에 의해 인증된 사용자가 생성되었는지 여부입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview를 참고하세요.