Looker(Google Cloud 핵심 서비스)에 사용자를 인증하는 데 다른 인증 방법을 사용하려는 경우에도 OAuth 클라이언트를 설정해야 하며 Looker(Google Cloud 핵심 서비스) 인스턴스 생성 중에 OAuth 사용자 인증 정보를 생성해야 합니다.
필요한 역할
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와 클라이언트 보안 비밀번호를 생성합니다. 이러한 값은 Looker(Google Cloud 핵심 서비스) 인스턴스를 만드는 동안 필요합니다.
원하는 Google Cloud 프로젝트에서 OAuth 클라이언트를 설정할 수 있습니다. Looker (Google Cloud 핵심 서비스) 인스턴스와 동일한 프로젝트가 아니어도 됩니다. 하지만 이 프로젝트에서 Looker (Google Cloud 핵심 서비스) API를 사용 설정해야 합니다.
클라이언트와 사용자 인증 정보를 만들려면 다음 단계를 따르세요.
- OAuth 클라이언트를 만들 프로젝트로 이동합니다.
- API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기를 클릭합니다.
- 드롭다운 메뉴에서 OAuth 클라이언트 ID를 선택합니다.
- 애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.
- 이름 필드에 OAuth 클라이언트 이름을 입력합니다.
- 이 시점에서는 승인된 JavaScript 출처 또는 승인된 리디렉션 URI 섹션에 URI를 추가할 필요가 없습니다.
- 만들기를 클릭합니다.
만들기를 클릭하면 OAuth 클라이언트가 생성됨 창이 나타납니다. 이 창에는 OAuth 클라이언트에 생성된 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 이 값은 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 핵심 서비스) 인스턴스 생성 도중
Looker(Google Cloud 핵심 서비스) 인스턴스를 만들 때 OAuth 애플리케이션 사용자 인증 정보 섹션에서 OAuth 클라이언트 ID와 클라이언트 보안 비밀번호를 추가합니다. OAuth 사용자 인증 정보가 없으면 인스턴스를 만들 수 없습니다. Google Cloud 콘솔에서 OAuth 클라이언트로 이동하여 OAuth 클라이언트 ID와 클라이언트 보안 비밀번호를 찾습니다.
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를 기본 인증 방법으로 사용하는 경우 Looker(Google Cloud 핵심 서비스) 사용자 인증에 Google OAuth 사용 문서 페이지에 설명된 단계를 완료하여 사용자 인증을 위한 OAuth 설정을 완료하세요.
인증 방법이 설정되면 ID 공급업체를 통해 사용자를 추가하거나 삭제하고 Looker 내에서 사용자를 관리할 수 있습니다.
Looker(Google Cloud 핵심 서비스) 인스턴스의 OAuth 클라이언트 수정
원하는 경우 다음 단계에 따라 Looker(Google Cloud 핵심 서비스) 인스턴스의 OAuth 사용자 인증 정보를 수정하거나 변경할 수 있습니다.
- 새 클라이언트나 사용자 인증 정보를 설정합니다.
- Google Cloud 콘솔의 인스턴스 페이지에서 인스턴스 이름을 클릭하여 세부정보 페이지를 엽니다.
- 세부정보 페이지에서 수정을 클릭합니다.
- Looker(Google Cloud 핵심 서비스) 인스턴스 페이지에서 OAuth 클라이언트 ID 및 OAuth 클라이언트 보안 비밀번호 필드에 새 값을 입력합니다.
- 저장을 클릭합니다.