통합자는 인증 목적으로 사용자를 리디렉션하는 웹 호스트를 구현해야 합니다. 이 인증은 모달리티는 다르지만 용도는 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
|
||||||
gspAuthenticationResponse
|
AuthenticationResponse
인증 응답입니다. |