문서 메뉴

문서 홈Atlas App Services

Google 인증

이 페이지의 내용

  • 개요
  • Google API 콘솔에서 프로젝트 설정
  • Google API 콘솔에서 프로젝트 생성
  • OAuth 클라이언트 자격 증명 생성
  • Google 인증 제공자 구성
  • App Services에서 구성하기
  • 예제

Google 인증 제공자는 사용자가 Google 로그인 을 통해 기존 Google 계정으로 로그인할 수 있도록 허용합니다. . 사용자가 로그인하면 Google은 Atlas App Services에 OAuth 2 0 를 제공합니다. 액세스 토큰 . App Services는 토큰을 사용하여 사용자를 식별하고 사용자를 대신하여 Google API에서 승인된 데이터에 액세스합니다.

다음 다이어그램은 OAuth 로직의 흐름을 보여줍니다.

OAuth 흐름 다이어그램

App Services에서 Google 인증을 구성 하기 전에 Google API 콘솔에서 프로젝트를 설정해야 합니다. Google API 콘솔에서 Google 인증을 설정하려면 SDK 관련 단계를 따르세요.

Google 인증 제공자 는 Google API 콘솔의 프로젝트가 필요합니다. 인증 및 사용자 권한을 관리합니다. 다음 단계에서는 프로젝트를 만들고, OAuth 자격 증명을 생성하고, 프로젝트와 연결하도록 제공자를 구성하는 과정을 안내합니다.

1

Google의 공식 가이드 따르기 새 GCP 프로젝트를 만듭니다.

2

OAuth 2 0 설정에 대한 Google 지원 가이드를 따르세요. 사용할 수 있습니다.

3

GCP 프로젝트를 App Services에 연결하려면 OAuth 2 을(를) 추가합니다. 이전 단계에서 생성한 0 Client IDClient Secret 를 인증 제공자 구성에 추가합니다.

Google 인증 제공자에는 다음과 같은 구성 옵션이 있습니다.

필드
설명
Client ID
config.clientId

필수 사항입니다. Google API 콘솔 내 프로젝트의 OAuth 2.0 Client ID입니다.

GCP 프로젝트의 OAuth 자격 증명 설정에 대한 자세한 내용 은 Google API 콘솔에서 프로젝트 설정하기를 참조하세요.

Client Secret
secret_config.clientSecret

필수 사항입니다. Google API 콘솔에서 프로젝트의 OAuth 2.0 Client Secret을 저장하는 Secret(시크릿)의 이름입니다.

GCP 프로젝트의 OAuth 자격 증명 설정에 대한 자세한 내용 은 Google API 콘솔에서 프로젝트 설정하기를 참조하세요.

Metadata Fields
metadata_fields

선택 사항. 애플리케이션이 Google Identity API에서요청할 인증된 사용자를 설명하는 필드 목록입니다.

모든 메타데이터 필드는 기본적으로 생략되며 필드별로 필수로 설정할 수 있습니다. 사용자는 각 필수 필드에 액세스할 수 있는 권한을 앱에 명시적으로 부여해야 합니다. 특정 사용자에 대해 메타데이터 필드가 필수이고 존재하는 경우 해당 사용자 객체에 해당 필드가 포함됩니다.

가져오기/내보내기 구성 파일에서 메타데이터 필드를 요구하려면 필드 항목을 metadata_fields 배열에 추가합니다. 각 항목은 다음 형식의 문서여야 합니다.

{ name: "<metadata field name>", required: "<boolean>" }
Redirect URIs
redirect_uris

웹 애플리케이션에 필요합니다. 허용된 리다이렉션 URI 목록입니다.

사용자가 Google에서 인증 프로세스를 완료하면 App Services는 사용자를 지정된 리디렉션 URI로 리디렉션하거나, 리디렉션 URI가 지정되지 않은 경우 인증 요청을 시작한 URL로 리디렉션합니다. App Services는 프로토콜 및 모든 트레일링 슬래시를 포함하여 이 목록의 엔트리와 정확히 일치하는 URI로만 사용자를 리디렉션합니다.

Domain Restrictions
domain_restrictions

선택 사항. 승인된 도메인 목록 사용자 계정의 경우.

지정된 경우 제공자는 Google에서 사용자의 프라이머리 이메일 주소 도메인을 확인하고 도메인이 이 목록의 항목과 일치하는 경우에만 인증을 허용합니다.

예를 들어 example1.comexample2.com이 나열된 경우 프라이머리 이메일이 joe.mango@example1.com인 Google 사용자는 로그인이 허용되고 프라이머리 이메일이 joe.mango@example3.com인 사용자는 로그인이 허용되지 않습니다.

참고

도메인 제한사항을 어떤 것이든 지정한 적이 있다면 Metadata Fields 설정에서 이메일 주소 필드 역시 필수로 입력해야 합니다.

OpenID Connect
config.openId

선택 사항입니다. 기본값은 false입니다.

true인 경우 제공자는 OpenID Connect 를 사용합니다. 사용자를 인증합니다.

중요

SDK에 따라 달라지는 OpenID 연결 지원

OpenID Connect에 대한 지원은 SDK별 문서서를 참조하세요. Google 인증의 모든 SDK 구현이 OpenID Connect를 지원하는 것은 아니지만 일부 구현은 OpenID Connect를 필요로 합니다.

참고

OpenID Connect는 메타데이터 필드를 지원하지 않습니다.

Google은 OAuth 2.0 구현의 일환으로 OpenID를 지원하지만, OpenID 인증을 위해 제한된 영역으로의 액세스를 제공하지는 않습니다. 이는 App Services가 OpenID Connect로 인증된 사용자의 메타데이터 필드에 액세스할 수 없음을 의미합니다.

Google 인증을 이용한 등록 및 로그인 방법에 대한 코드 예제는 Realm SDK 설명서를 참조하세요.

← Facebook 인증