연결된 계정 로그인

Google 계정 연결을 사용하면 Google 계정 소유자가 서비스에 빠르고 원활하며 안전하게 연결하고 Google과 데이터를 공유할 수 있습니다.

연결된 계정 로그인을 사용하면 이미 Google 계정이 서비스에 연결된 사용자에게 Google 원탭 로그인을 사용할 수 있습니다. 이렇게 하면 사용자 이름과 비밀번호를 다시 입력하지 않고도 클릭 한 번으로 로그인할 수 있으므로 사용자 환경이 개선됩니다. 또한 사용자가 서비스에서 중복 계정을 만들 가능성도 줄어듭니다.

요구사항

연결된 계정 로그인을 구현하려면 다음 요구사항을 충족해야 합니다.

• OAuth 2.0 승인 코드 흐름을 지원하는 Google 계정 OAuth 연결 구현이 있습니다. OAuth 구현에는 다음 엔드포인트가 포함되어야 합니다.
  • 승인 요청을 처리하는 승인 엔드포인트
  • 액세스 및 갱신 토큰 요청을 처리하는 토큰 엔드포인트
  • userinfo 엔드포인트: 연결된 계정 로그인 프로세스 중에 사용자에게 표시되는 연결된 사용자에 관한 기본 계정 정보를 가져옵니다.
• Android 앱이 있습니다.

작동 방식

기본 요건 : 사용자가 이전에 Google 계정을 서비스의 계정과 연결한 적이 있어야 합니다.

1. 원탭 로그인 과정에서 연결된 계정을 표시하도록 선택합니다.
2. 연결된 계정으로 서비스에 로그인할 수 있는 옵션이 포함된 원탭 로그인 메시지가 사용자에게 표시됩니다.
3. 사용자가 연결된 계정으로 계속 진행하겠다고 선택하면 Google에서 토큰 엔드포인트에 승인 코드를 저장해 달라는 요청을 보냅니다. 요청에는 서비스에서 발급한 사용자의 액세스 토큰과 Google 승인 코드가 포함됩니다.
4. Google 승인 코드를 사용자의 Google 계정에 관한 정보가 포함된 Google ID 토큰으로 교환합니다.
5. 또한 흐름이 완료되면 앱은 ID 토큰을 수신하고 이를 서버에서 수신한 ID 토큰의 사용자 식별자와 일치시켜 사용자를 앱에 로그인합니다.

Android 앱에서 연결된 계정 로그인 구현

Android 앱에서 연결된 계정 로그인을 지원하려면 Android 구현 가이드의 안내를 따르세요.

Google의 승인 코드 요청 처리

Google은 토큰 엔드포인트에 POST 요청을 보내 승인 코드를 저장하고 개발자는 이 승인 코드를 사용자의 ID 토큰으로 교환합니다. 요청에는 사용자의 액세스 토큰과 Google에서 발급한 OAuth2 승인 코드가 포함됩니다.

승인 코드를 저장하기 전에 client_id로 식별되는 액세스 토큰이 개발자에 의해 Google에 부여되었는지 확인해야 합니다.

HTTP 요청

샘플 요청

POST /token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=urn:ietf:params:oauth:grant-type:reciprocal
&client_id=CLIENT_ID
&client_secret=CLIENT_SECRET
&access_token=ACCESS_TOKEN

토큰 교환 엔드포인트는 다음 요청 매개변수를 처리할 수 있어야 합니다.

토큰 교환 엔드포인트는 다음을 실행하여 POST 요청에 응답해야 합니다.

• client_id로 식별된 Google에 access_token가 부여되었는지 확인합니다.
• 요청이 유효하고 인증 코드가 Google ID 토큰으로 성공적으로 교환된 경우 HTTP 200 (OK) 응답으로 응답하고, 요청이 유효하지 않은 경우 HTTP 오류 코드로 응답합니다.

HTTP 응답

성공

HTTP 상태 코드 200 OK 반환

샘플 성공 응답

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
{}

오류

잘못된 HTTP 요청이 발생하면 다음 HTTP 오류 코드 중 하나로 응답합니다.

오류 응답에는 다음 필드가 포함되어야 합니다.

샘플 오류 400 응답

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "error": "invalid_request",
  "error_description": "Request was missing the 'access_token' parameter."
}

승인 코드를 ID 토큰으로 교환

받은 승인 코드를 사용자의 Google 계정에 관한 정보가 포함된 Google ID 토큰으로 교환해야 합니다.

승인 코드를 Google ID 토큰으로 교환하려면 https://oauth2.googleapis.com/token 엔드포인트를 호출하고 다음 매개변수를 설정합니다.

샘플 요청

POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=authorization_code
&client_id=GOOGLE_CLIENT_ID
&client_secret=GOOGLE_CLIENT_SECRET

Google은 이 요청에 대해 단기 액세스 토큰과 새로고침 토큰이 포함된 JSON 객체를 반환하여 응답합니다.

응답에는 다음 필드가 포함됩니다.

샘플 응답

HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8

{
  "access_token": "Google-access-token",
  "id_token": "Google-ID-token",
  "expires_in": 3599,
  "token_type": "Bearer",
  "scope": "openid",
  "refresh_token": "Google-refresh-token"
}


POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=Google authorization code
&grant_type=authorization_code
&client_id=Google client id
&client_secret=Google client secret

ID 토큰 응답 검증