웹 인증 API

통합자는 인증 목적으로 사용자를 리디렉션하는 웹 호스트를 구현해야 합니다. 이 인증은 모달리티는 다르지만 용도는 Android 인증에서 제공하는 인증과 동일합니다. 이 웹 호스트에는 모바일 친화적인 웹사이트가 있어야 합니다.

웹 호스트는 사용자 에이전트 헤더 값을 기준으로 모바일 웹 요청과 데스크톱 웹 요청을 비교하여 판단해야 합니다. 모바일 웹 요청으로 제공되는 페이지는 Android 및 iOS에서 모바일 웹에 적합해야 합니다. 사용자 에이전트 헤더 값 외에 클라이언트는 이 사용자가 요청하는 환경 (데스크톱 또는 웹)에 관한 다른 힌트를 제공하지 않습니다.

서버는 GET을 사용하여 HTTPS 프로토콜을 구현해야 합니다. 경로와 호스트는 통합자가 정의할 수 있습니다. 통합자는 URL 길이 2,048자(영문 기준)를 지원해야 합니다. 여기에는 스키마, 호스트, 포트, 경로, 매개변수가 포함됩니다.

모든 매개변수는 URL 인코딩 전에 UTF-8로 인코딩됩니다.

요청

요청이 있을 경우 Google은 다음을 URL 매개변수로 제공합니다.

필드
gspMajorVersion int

이 요청의 주 버전 번호입니다.

gspAuthenticationRequest AuthenticationRequest

인증 요청입니다.

gspAssociationId string

이 ID가 있는 경우 여기에는 통합업체가 보안 질문을 하는 사용자의 사용자 인증 정보를 찾는 데 사용하는 식별자가 포함됩니다. 이 속성이 없으면 사용자는 계정 ID를 변경할 수 있습니다.

gspCallbackUrl string

Google에서 인증 흐름을 완료하기 위해 사용자를 리디렉션할 URL입니다. 이 값은 URL로 인코딩됩니다.

응답

인증이 완료되면 사용자는 HTTPS GET을 사용하여 gspCallbackUrl로 리디렉션되어야 합니다. 이 URL에는 다음과 같은 쿼리 매개변수가 있어야 합니다.

필드
gspResult int

100
인증이 완료되었습니다.
201 사용자가 흐름을 수동으로 취소했으며 흐름이 중단되어야 합니다.
202 치명적인 이유로 인증에 실패했으며 흐름을 중단해야 합니다.

gspAuthenticationResponse AuthenticationResponse

인증 응답입니다.