이 문서 페이지에서는 인스턴스를 만드는 동안 OAuth 클라이언트를 설정하고 OAuth 사용자 인증 정보를 인스턴스와 수동으로 연결하는 방법을 설명합니다.
OAuth 사용자 인증 정보를 만들어야 하는 경우
대부분의 경우 Looker(Google Cloud 핵심 서비스)는 기본적으로 Looker 관리 OAuth 사용자 인증 정보를 자동으로 만들고 할당합니다. 인스턴스의 네트워크 연결 유형 및 인증 구성에 따라 특정 시나리오에서만 OAuth 클라이언트를 만들고 커스텀 OAuth 사용자 인증 정보를 수동으로 연결해야 합니다.
- Google OAuth를 사용하는 비공개 또는 하이브리드 연결: Google OAuth를 비공개 또는 하이브리드 연결과 함께 사용하는 경우(기본 또는 보조 인증으로) 수동 OAuth 설정이 필요합니다.
- Google OAuth를 사용한 공개 연결:Google Cloud 콘솔에서 인스턴스를 만드는 경우 Looker(Google Cloud 핵심 서비스)가 기본적으로 Looker 관리 사용자 인증 정보를 자동으로 할당하므로 수동 OAuth 설정이 필요하지 않습니다. 하지만 원하는 경우 커스텀 사용자 인증 정보를 구성할 수 있습니다. Google Cloud CLI를 사용하여 인스턴스를 만드는 경우 OAuth 사용자 인증 정보를 제공해야 합니다.
- 직원 ID 제휴만 해당: 보조 Google OAuth 없이 직원 ID 제휴를 사용하는 경우 네트워크 연결 유형 전반에서 수동 OAuth 설정이 필요하지 않습니다.
- 커스텀 도메인: 공개 보안 연결 및 Google OAuth를 사용하는 인스턴스에 커스텀 도메인을 구성하는 경우 커스텀 OAuth 사용자 인증 정보가 필요하며 커스텀 도메인 생성 프로세스의 일부로 구성됩니다.
다음 표에는 수동 OAuth 사용자 인증 정보 설정이 필요한 경우가 요약되어 있습니다.
| 기본 인증 | 보조 인증 | 네트워크 연결 유형 | 수동 OAuth 설정 |
|---|---|---|---|
| Google OAuth | 없음 | 공개 보안 연결 | Google Cloud 콘솔을 사용하는 경우 Looker(Google Cloud 핵심 서비스)가 Looker 관리 사용자 인증 정보를 자동으로 할당하므로 필요하지 않습니다. gcloud CLI를 사용하는 경우 필수입니다. |
| 비공개 연결 또는 하이브리드 연결 | 필수. 이 페이지의 안내를 따르세요. | ||
| 직원 ID 제휴 | 없음 | 공개 연결 | 필수 항목이 아닙니다. |
| 직원 ID 제휴 | Google OAuth | 공개 보안 연결 | Google Cloud 콘솔을 사용하는 경우 선택사항입니다. 기본적으로 Looker(Google Cloud 핵심 서비스)는 Looker 관리 사용자 인증 정보를 사용하지만 커스텀 사용자 인증 정보를 제공할 수 있습니다. gcloud CLI를 사용하는 경우 필수입니다. |
필요한 역할
Google Cloud 콘솔을 사용하여 OAuth 사용자 인증 정보를 만들고 수정하려면 다음 권한이 필요합니다. 권한 목록을 숨기려면 필수 권한 섹션을 접으세요.
필수 권한
- clientauthconfig.*
- clientauthconfig.brands.create
- clientauthconfig.brands.delete
- clientauthconfig.brands.get
- clientauthconfig.brands.list
- clientauthconfig.brands.update
- clientauthconfig.clients.create
- clientauthconfig.clients.createSecret
- clientauthconfig.clients.delete
- clientauthconfig.clients.get
- clientauthconfig.clients.getWithSecret
- clientauthconfig.clients.list
- clientauthconfig.clients.listWithSecrets
- clientauthconfig.clients.undelete
- clientauthconfig.clients.update
- oauthconfig.*
- oauthconfig.clientpolicy.get
- oauthconfig.testusers.get
- oauthconfig.testusers.update
- oauthconfig.verification.get
- oauthconfig.verification.submit
- oauthconfig.verification.update
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다. 역할 부여에 대한 자세한 내용은 Identity and Access Management(IAM) 문서의 프로젝트, 폴더, 조직 액세스 관리 페이지를 참조하세요.
Looker(Google Cloud 핵심 서비스) 인스턴스를 만들기 전에
Looker(Google Cloud 핵심 서비스) 인스턴스를 만들기 전에 다음 섹션에 설명된 단계를 완료하세요.
OAuth 클라이언트 ID 및 클라이언트 보안 비밀번호 생성
먼저 OAuth 클라이언트를 만들고 해당 클라이언트의 클라이언트 ID와 클라이언트 보안 비밀번호를 생성합니다. Google OAuth를 사용한 비공개 또는 하이브리드 연결과 같은 커스텀 OAuth 사용자 인증 정보를 구성하거나 gcloud CLI를 사용하여 Google 인증을 사용 설정하는 경우 인스턴스 생성 중에 이러한 값이 필요합니다.
원하는 Google Cloud 프로젝트에서 OAuth 클라이언트를 설정할 수 있습니다. Looker(Google Cloud 핵심 서비스) 인스턴스와 동일한 프로젝트가 아니어도 됩니다. 하지만 이 프로젝트에서 Looker(Google Cloud 핵심 서비스) API를 사용 설정해야 합니다.
클라이언트와 사용자 인증 정보를 만들려면 다음 단계를 따르세요.
- OAuth 클라이언트를 만들 프로젝트로 이동합니다.
- API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기를 클릭합니다.
- 드롭다운 메뉴에서 OAuth 클라이언트 ID를 선택합니다.
- 애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.
- 이름 필드에 OAuth 클라이언트 이름을 입력합니다.
- 이 시점에서는 승인된 JavaScript 원본 또는 승인된 리디렉션 URI 섹션에 URI를 추가할 필요가 없습니다.
- 만들기를 클릭합니다.
만들기를 클릭하면 OAuth 클라이언트가 생성됨 창이 나타납니다. 이 창에는 OAuth 클라이언트에 생성된 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 커스텀 OAuth 사용자 인증 정보를 구성하는 경우 공개 보안 연결, Private Service Connect 또는 비공개 서비스 액세스를 위해 Looker(Google Cloud 핵심 서비스) 인스턴스를 만들 때 이러한 값을 입력합니다.
원하는 경우 JSON 다운로드를 클릭하여 사용자 인증 정보를 JSON 파일에 다운로드합니다. 창을 닫으려면 확인을 클릭합니다.
사용자 동의 화면, 범위, 테스트 사용자 구성
다음으로 동의 화면을 구성할 수 있습니다. 사용자가 처음 로그인할 때 및 인증이 만료되거나 사용자에 의해 인증이 취소되는 시점에 Looker(Google Cloud 핵심 서비스) 인스턴스의 사용자에게 동의 화면이 표시됩니다.
OAuth 동의 화면 구성 및 범위 선택 문서 페이지의 안내를 따릅니다. 화면을 구성하는 동안 설명된 대로 다음 설정을 완료합니다.
브랜딩 섹션의 승인된 도메인에서 도메인은 OAuth 사용자 인증 정보를 사용하는 Looker(Google Cloud 핵심 서비스) 인스턴스의 도메인과 일치해야 합니다. Looker(Google Cloud 핵심 서비스) 인스턴스의 커스텀 도메인을 만들고 할당할 도메인을 알고 있는 경우 지금 입력할 수 있습니다. 그렇지 않으면 이 필드를 비워 둘 수 있습니다. Looker(Google Cloud 핵심 서비스) 인스턴스가 생성된 후 승인된 리디렉션 URI를 추가하면 자동으로 채워집니다.
대상 섹션의 사용자 유형에서 다음 중 하나를 선택합니다.
- 내부: 기본 설정입니다. 조직 내 사용자만 IAM을 통해 추가된 후 인스턴스에 액세스할 수 있습니다.
- 외부로 설정: 모든 종류의 Google 계정이 있는 사용자는 IAM을 통해 추가되면 인스턴스에 액세스할 수 있습니다.
Looker(Google Cloud 핵심 서비스) 인스턴스 생성 도중
비공개 또는 하이브리드 연결 및 Google OAuth가 있는 인스턴스 또는 Google 인증이 사용 설정된 상태에서 gcloud CLI로 만드는 인스턴스와 같은 일부 인스턴스에는 커스텀 OAuth 사용자 인증 정보가 필요합니다. 이러한 인스턴스의 경우 설정 중에 OAuth 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다. 이러한 값을 찾으려면 Google Cloud 콘솔에서 OAuth 클라이언트를 선택합니다.
연결 유형 및 생성 방법에 따라 다음과 같이 사용자 인증 정보를 입력합니다.
- Private Service Connect 또는 선택적 수동 OAuth 사용자 인증 정보를 사용하는 공개 연결 인스턴스의 경우 Google Cloud 콘솔에서 OAuth 애플리케이션 사용자 인증 정보 섹션에 값을 입력합니다.
- gcloud CLI의 경우 공개 보안 연결, Private Service Connect 또는 비공개 서비스 액세스의 생성 가이드에 설명된 대로
--oauth-client-id및--oauth-client-secret플래그를gcloud looker instances create명령어에 전달합니다.
Looker(Google Cloud 핵심 서비스) 인스턴스를 만든 후
다음 안내에 따라 구성을 완료합니다. 승인된 리디렉션 URI를 추가하면 OAuth 동의 화면에 승인된 도메인으로 추가됩니다.
OAuth 클라이언트에 승인된 리디렉션 URI 추가
아직 입력하지 않은 경우 다음 단계에 따라 새로 만든 Looker(Google Cloud 핵심 서비스) 인스턴스의 URL을 OAuth 클라이언트에 입력합니다.
Looker(Google Cloud 핵심 서비스) 인스턴스를 만든 후 인스턴스의 URL을 찾아 복사합니다. 인스턴스 페이지에서 URL을 찾을 수 있습니다.
Google Cloud 콘솔에서 API 및 서비스 > 사용자 인증 정보로 이동합니다.
OAuth 2.0 클라이언트 ID 제목에서 만든 클라이언트의 이름을 클릭합니다.
승인된 리디렉션 URI 섹션에서 URI 추가를 클릭합니다.
Looker(Google Cloud 핵심 서비스) 인스턴스의 URL을 URI 필드에 붙여넣습니다.
/oauth2callback을 URL 끝에 추가합니다. 예를 들면https://uuid.looker.app/oauth2callback입니다.BigQuery에 OAuth 승인을 설정하려는 경우 Looker(Google Cloud 핵심 서비스) 인스턴스의 URL을 가리키는 두 번째 리디렉션 URI를 추가하고 URL 끝에
/external_oauth/redirect를 추가할 수도 있습니다. 예를 들면https://uuid.looker.app/external_oauth/redirect입니다.저장을 클릭합니다.
업데이트가 적용되는 데 5분에서 몇 시간 정도 걸릴 수 있습니다.
사용자 관리
OAuth 클라이언트가 구성되고 Looker(Google Cloud 핵심 서비스) 인스턴스가 생성되면 OAuth를 사용하여 인스턴스에 로그인할 수 있습니다. 그런 다음 인스턴스의 인증 방법을 선택할 수 있습니다.
OAuth를 기본 인증 방법으로 사용하는 경우 Looker(Google Cloud 핵심 서비스) 사용자 인증에 Google OAuth 사용 문서 페이지에 설명된 단계를 완료하여 사용자 인증을 위한 OAuth 설정을 완료하세요.
인증 방법이 설정되면 ID 공급업체를 통해 사용자를 추가하거나 삭제하고 Looker 내에서 사용자를 관리할 수 있습니다.
인스턴스의 OAuth 사용자 인증 정보 유형 보기
OAuth 사용자 인증 정보는 Google Cloud 콘솔의 인스턴스 구성 페이지에 직접 나열되지 않습니다. 인스턴스 구성 페이지에서 수정을 클릭하여 OAuth 애플리케이션 사용자 인증 정보 섹션을 확인합니다.
OAuth 사용자 인증 정보가 Looker 관리로 설정된 경우 Looker(Google Cloud 핵심 서비스)는 인스턴스 생성 중에 인스턴스에 Looker 관리 OAuth 사용자 인증 정보를 할당하며 클라이언트 ID와 클라이언트 보안 비밀번호는 표시되지 않습니다.
OAuth 사용자 인증 정보가 수동으로 설정된 경우 인스턴스 생성 중 또는 생성 후에 수동 OAuth 사용자 인증 정보가 인스턴스에 추가된 것입니다. 클라이언트 ID와 클라이언트 보안 비밀번호는 표시되지 않고 대신 섹션에 **** 자리표시자가 표시됩니다.
Looker(Google Cloud 핵심 서비스) 인스턴스의 OAuth 클라이언트 수정
원하는 경우 다음 단계에 따라 Looker(Google Cloud 핵심 서비스) 인스턴스의 OAuth 사용자 인증 정보를 추가, 수정 또는 변경할 수 있습니다.
- 새 클라이언트나 사용자 인증 정보를 설정합니다.
- Google Cloud 콘솔의 인스턴스 페이지에서 인스턴스 이름을 클릭하여 세부정보 페이지를 엽니다.
- 세부정보 페이지에서 수정을 클릭합니다.
- Looker(Google Cloud 핵심 서비스) 인스턴스 수정 페이지에서 OAuth 애플리케이션 사용자 인증 정보 섹션으로 이동하여 수동을 선택합니다(아직 선택하지 않은 경우).
- OAuth 클라이언트 ID 및 OAuth 클라이언트 보안 비밀번호 필드에 새 값을 입력합니다.
- 저장을 클릭합니다.
OAuth 애플리케이션 사용자 인증 정보가 Looker 관리로 설정된 경우 사용자 인증 정보를 추가하거나 수정할 수 없습니다. 사용자 인증 정보를 수정하거나 추가하려면 사용자 인증 정보의 수동 설정으로 전환합니다.