Looker 22.10 이후에 Looker 인스턴스가 만들어진 경우 기본적으로 관리 메뉴의 인증 섹션에서 OpenID Connect 페이지를 사용할 수 있습니다.
관리 메뉴의 인증 섹션에 OpenID Connect 페이지가 표시되지 않는 경우 문의하기를 클릭하여 Looker 고객센터에서 지원 요청을 여세요.
회사는 다양한 OpenID Connect 제공업체 (OP)를 사용하여 OpenID Connect를 조정합니다 (예: Okta 또는 OneLogin). 다음 설정 안내 및 Looker UI에서 사용되는 용어는 OP에서 사용하는 용어와 직접 일치하지 않을 수 있습니다.
관리 메뉴의 인증 섹션에 있는 OpenID Connect 페이지에서 OpenID Connect 프로토콜을 사용하여 사용자를 인증하도록 Looker를 구성할 수 있습니다. 이 페이지에서는 이러한 프로세스를 설명하고 OpenID Connect 그룹을 Looker 역할 및 권한에 연결하는 방법을 안내합니다.
계획 고려사항
- 지정된 사용자에 대한 대체 로그인 옵션을 사용하여 Looker 관리자가 OpenID Connect 없이 Looker에 액세스할 수 있도록 하는 것이 좋습니다.
- 보조 계정 로그인을 설정하지 않은 경우 OpenID Connect를 사용하여 Looker에 로그인한 상태에서 OpenID Connect 인증을 사용 중지하지 마세요. 그러지 않으면 앱을 사용할 수 없게 됩니다.
- Looker는 현재 이메일/비밀번호 설정, LDAP, SAML 또는 Google 인증에서 수신되는 이메일 주소를 사용하여 기존 계정을 OpenID Connect로 이전할 수 있습니다. 설정 과정에서 이를 구성할 수 있습니다.
- Looker는 OpenID Connect의 승인 코드 흐름을 사용하여 OpenID Connect 인증만 지원합니다. 다른 코드 흐름은 지원되지 않습니다.
- OpenID Connect 사양에는 선택사항인 검색 메커니즘이 포함됩니다. Looker는 이 메커니즘을 지원하지 않으므로 아래에 설명된 대로 OpenID Connect 인증 설정 섹션에 명시적 URL을 제공해야 합니다.
OpenID Connect 설정
Looker와 OpenID Connect 간의 연결을 설정하려면 다음 작업을 실행합니다.
운영 중인 Looker 설정
OpenID Connect 제공업체 (OP)에 Looker 인스턴스의 URL이 필요합니다. OP는 이를 다른 이름 중에서도 리디렉션 URI 또는 로그인 리디렉션 URI라고 할 수 있습니다. 운영 웹사이트에서 일반적으로 브라우저에서 Looker 인스턴스에 액세스하는 URL과 그 뒤에 오는 /openidconnect을 제공합니다. 예를 들면 https://instance_name.looker.com/openidconnect입니다.
운영자에게서 정보 얻기
OpenID Connect 인증을 위해 Looker를 구성하려면 OP에서 다음 정보가 필요합니다.
- 클라이언트 식별자 및 클라이언트 보안 비밀번호 이 헤더는 일반적으로 위에서 설명한 대로 리디렉션 URI를 구성할 때 웹사이트의 운영업체에서 제공합니다.
- OpenID Connect 인증 프로세스 중에 Looker는 세 가지 엔드포인트, 인증 엔드포인트, ID 토큰 엔드포인트, 사용자 정보 엔드포인트에 연결됩니다. 운영팀에서 이러한 각 엔드포인트에 사용하는 URL이 필요합니다.
- 각 OP는 범위라고 하는 세트로 사용자 정보를 제공합니다. OP에서 사용하는 범위의 이름을 알아야 합니다. OpenID Connect에는
openid범위가 필요하지만 OP에는 다른 범위(예:email,profile,groups)가 포함될 가능성이 높습니다. - OpenID Connect에서는 사용자 데이터를 저장하는 속성을 소유권 주장이라고 합니다. 운영자에게 Looker에 원하는 사용자 정보를 제공하려면 어떤 클레임이 Looker로 전달되는지 알아야 합니다. Looker에는 이메일 및 이름 정보가 포함된 소유권 주장이 필요하지만 시간대 또는 부서와 같은 다른 사용자 속성이 있는 경우 Looker에서 이러한 정보가 포함된 소유권 주장도 파악해야 합니다. 사용자 정보 엔드포인트 또는 ID 토큰 엔드포인트의 응답에 클레임을 포함할 수 있습니다. Looker는 두 엔드포인트에서 반환된 클레임을 Looker 사용자 속성에 매핑할 수 있습니다.
많은 OP를 통해 검색 문서의 형태로 OpenID Connect 구성에 관한 정보를 제공하므로 Looker OpenID Connect를 구성하는 데 필요한 정보 일부 또는 전부를 수집할 수 있습니다. 검색 문서에 액세스할 수 없는 경우 운영 또는 내부 인증팀으로부터 필요한 정보를 획득해야 합니다.
다음은 Google에서 제공하는 검색 문서의 예시 섹션입니다.
OpenID Connect 인증 설정 구성
OP 검색 문서, OP 또는 내부 인증팀에서 얻은 구성 정보를 사용하여 다음 필드에 연결 설정을 입력합니다.
식별자: Looker 인스턴스에 고유한 클라이언트 식별자입니다. OPS에서 제공해야 합니다.
보안 비밀: Looker 인스턴스에 고유한 클라이언트 보안 키입니다. OPS에서 제공해야 합니다.
Issuer(발급기관): 작업을 식별하는 보안 URL입니다.
잠재고객: 운영자에게 고객을 식별하는 식별자입니다. 식별자 값과 동일한 경우가 많지만 값이 다를 수 있습니다.
승인 URL: 인증 시퀀스가 시작되는 OP의 URL입니다. 검색 문서에서 authorization_endpoint라고 하는 경우가 많습니다.
토큰 URL: Looker가 승인된 후 Looker가 OAuth 토큰을 가져오는 URL입니다. 검색 문서에서 token_endpoint라고 하는 경우가 많습니다.
사용자 정보 URL: Looker에서 자세한 사용자 정보를 검색하는 URL입니다. 검색 문서에서 userinfo_endpoint라고 하는 경우가 많습니다.
범위: OPC에서 Looker에 사용자 정보를 제공하는 데 사용하는 쉼표로 구분된 범위 목록입니다. openid 범위와 Looker 인스턴스에 구성된 모든 사용자 속성을 포함하여 Looker에 필요한 정보가 포함된 모든 범위를 포함해야 합니다.
사용자 속성 설정 구성
이 섹션에서는 OP'의 소유권 주장을 Looker 사용자 속성에 매핑합니다.
사용자 속성 설정 섹션에서 각 입력란에 해당하는 정보가 포함된 OPS 소유권 주장의 이름을 입력합니다. 이는 로그인 시 Looker 사용자 정보에 이러한 클레임을 매핑하는 방법을 알려줍니다. Looker는 소유권 주장이 구성되는 방식에 국한되어 있지 않으며, 여기에 입력된 소유권 주장 정보가 OP에 정의된 소유권 주장과 일치하는 것이 중요합니다.
표준 소유권 주장
Looker에서 사용자 인증을 위해서는 사용자 이름 및 이메일 정보가 필요합니다. 이 섹션에 운영 중인 해당 소유권 주장 정보를 입력하세요.
이메일 소유권 주장: OP가 사용자 이메일 주소(예: email)에 사용하는 소유권 주장입니다.
이름 소유권 주장: OP가 사용자 이름에 사용하는 소유권 주장입니다(예: given_name).
성 소유권 주장: OP가 사용자 성에 대해 사용하는 소유권 주장입니다(예: family_name).
일부 OP는 이름과 성을 분리하지 않고 이름으로 단일 클레임을 사용합니다. OP의 경우 이름이 소유권 주장 및 이름 클레임 입력란 모두에 이름을 저장하는 소유권 주장을 입력합니다. 각 사용자에 대해 Looker는 첫 번째 공간까지의 콘텐츠를 이름으로 사용하고 이후에 모든 내용을 성으로 사용합니다.
속성 페어링
원하는 경우 OpenID Connect 클레임의 데이터를 사용하여 사용자가 로그인할 때 Looker 사용자 속성의 값을 자동으로 채울 수 있습니다. 예를 들어 OpenID Connect를 데이터베이스에 사용자별 연결을 구성하도록 구성한 경우 Looker에서 OpenID Connect 클레임을 Looker 사용자 속성과 페어링하여 데이터베이스 연결을 사용자별로 생성할 수 있습니다.
클레임을 해당 Looker 사용자 속성과 페어링하려면 다음 안내를 따르세요.
- OP에서 확인한 대로 클레임을 Claim 입력란에 입력하고 Looker 사용자 속성 입력란에 페어링할 Looker 사용자 속성을 입력합니다.
- 소유권 주장 필드에 값이 누락된 사용자 계정으로 로그인을 차단하려면 필수를 선택합니다.
- +를 클릭하고 위 단계를 반복하여 소유권 주장 및 속성 쌍을 더 추가합니다.
일부 OP는 '중첩된' 클레임을 가질 수 있습니다. 예를 들면 다음과 같습니다.
"zoneinfo": "America/Los Angeles",
"phone_number": "555-1235",
"address": {
"street_address": "1234 Main Street",
"locality": "Anyton",
"region": "IL",
"postal_code": "60609",
"country": "US"
},
위의 예에서 locality 클레임은 address 클레임 내에 중첩되어 있습니다. 중첩된 클레임의 경우 상위 및 중첩된 클레임을 슬래시 ( /) 문자로 구분하여 지정합니다. 위의 locality 클레임에 Looker를 구성하려면 address/locality를 입력합니다.
그룹 및 역할
Looker에서 외부 관리 OpenID Connect 그룹을 미러링하는 그룹을 만든 다음 미러링된 OpenID Connect 그룹을 기반으로 사용자에게 Looker 역할을 할당할 수 있습니다. OpenID Connect 그룹 멤버십을 변경하면 Looker의 그룹 구성에 변경사항이 자동으로 적용됩니다.
OpenID Connect 그룹을 미러링하면 외부에서 정의된 OpenID Connect 디렉터리를 사용하여 Looker 그룹과 사용자를 관리할 수 있습니다. 따라서 Looker와 같은 여러 Software as a Service (SaaS) 도구를 한 곳에서 관리할 수 있습니다.
OpenID Connect 그룹 미러링을 사용 설정하면 Looker가 시스템에 도입된 모든 OpenID Connect 그룹에 하나의 Looker 그룹을 만듭니다. 이러한 Looker 그룹은 Looker의 관리 섹션의 그룹 페이지에서 볼 수 있습니다. 그룹은 그룹 회원에게 역할을 할당하고 콘텐츠 액세스 제어를 설정하며 사용자 속성을 할당하는 데 사용할 수 있습니다.
기본 그룹 및 역할
기본적으로 OpenID Connect 그룹 미러링 스위치가 사용 중지되어 있습니다. 이 경우 새 OpenID Connect 사용자의 기본 그룹을 설정할 수 있습니다. 신규 사용자 그룹 및 새 사용자 역할 입력란에 새로운 Looker 사용자가 Looker에 처음 로그인할 때 할당할 Looker 그룹 또는 역할의 이름을 입력합니다.
이러한 그룹 및 역할은 최초 로그인 시 신규 사용자에게 적용됩니다. 기존 사용자에게 적용되지 않으며 최초 로그인 후 사용자 계정에서 삭제되면 다시 적용되지 않습니다.
나중에 OpenID Connect 그룹 미러링을 사용 설정하면 다음에 로그인할 때 사용자의 기본 설정이 삭제되고 OpenID Connect 그룹 미러링 섹션에 할당된 역할로 대체됩니다. 이 기본 옵션은 더 이상 사용되거나 할당되지 않으며 미러링된 그룹 구성으로 완전히 대체됩니다.
OpenID Connect 그룹 미러링 사용 설정
Looker에서 OpenID Connect 그룹을 미러링하려면 OpenID Connect Group 그룹 미러링 스위치를 사용 설정합니다.
그룹스 소유권 주장: OP가 그룹 이름을 저장하는 데 사용하는 소유권 주장을 입력합니다. Looker는 그룹스 클레임에 의해 시스템에 도입된 모든 OpenID Connect 그룹에 대해 하나의 Looker 그룹을 만듭니다. 이러한 Looker 그룹은 Looker 관리 섹션의 그룹 페이지에서 볼 수 있습니다. 그룹은 콘텐츠 액세스 제어를 설정하고 사용자 속성을 할당하는 데 사용할 수 있습니다.
선호하는 그룹 이름/역할/OpenID Connect 그룹 이름: 이 그룹 모음에서는 맞춤 그룹 이름과 Looker의 해당 OpenID Connect 그룹에 할당된 하나 이상의 역할을 할당할 수 있습니다.
OpenID Connect 그룹 이름 입력란에 OpenID Connect 그룹 이름을 입력합니다. OpenID Connect 그룹에 포함된 OpenID Connect 사용자는 Looker 내의 미러링된 그룹에 추가됩니다.
맞춤 이름 입력란에 미러링된 그룹의 맞춤 이름을 입력합니다. 이 이름은 Looker의 관리 섹션의 그룹 페이지에 표시됩니다.
맞춤 이름 입력란 오른쪽의 필드에서 그룹의 각 사용자에게 할당될 Looker 역할을 하나 이상 선택합니다.
+를 클릭하여 추가 필드 세트를 추가하여 미러링된 그룹을 추가로 구성합니다. 여러 그룹이 구성되어 있고 그룹 구성을 삭제하려면 해당 그룹의 필드 세트 옆에 있는X를 클릭하세요.
이 화면에서 이전에 구성된 미러링된 그룹을 수정하는 경우 그룹 구성은 변경되지만 그룹 자체는 그대로 유지됩니다. 예를 들어 그룹의 맞춤 이름을 변경하면 Looker의 그룹 페이지에 그룹이 표시되는 방식이 변경되지만 할당된 역할 및 그룹 회원은 변경되지 않습니다. OpenID Connect 그룹 ID를 변경하면 그룹 이름과 역할이 유지되지만 새 OpenID Connect 그룹 ID를 가진 외부 OpenID Connect 그룹의 구성원에 따라 그룹의 구성원이 다시 할당됩니다.
이 페이지에서 그룹을 삭제하면 Looker에서 해당 그룹이 더 이상 미러링되지 않으며, Looker의 구성원은 해당 그룹을 통해 더 이상 Looker의 역할을 할당받지 않습니다.
미러링된 그룹의 모든 변경사항은 다음에 Looker에 로그인할 때 해당 그룹의 사용자에게 적용됩니다.
고급 역할 관리
OpenID Connect 그룹스 그룹 미러링 스위치를 사용 설정한 경우 Looker에 이러한 설정이 표시됩니다. 이 섹션의 옵션에 따라 Looker 그룹 및 OpenID Connect에서 미러링된 사용자를 구성할 때 Looker 관리자의 유연성이 결정됩니다.
예를 들어 Looker 그룹과 사용자 구성이 OpenID Connect 구성과 엄격하게 일치하도록 하려면 다음 옵션을 사용 설정합니다. 처음 세 가지 옵션을 모두 사용 설정하면 Looker 관리자는 미러링된 그룹의 멤버십을 수정할 수 없으며 OpenID Connect 미러링 그룹을 통해서만 사용자에게 역할을 할당할 수 있습니다.
Looker에서 그룹을 더 유연하게 맞춤설정하려면 이 옵션을 사용 중지합니다. Looker 그룹은 OpenID Connect 구성을 그대로 미러링하지만 Looker 내에서 OpenID Connect 사용자를 추가하거나 OpenID Connect 사용자에게 Looker 역할을 직접 할당하는 등 추가 그룹 및 사용자 관리를 수행할 수 있습니다.
새 Looker 인스턴스 또는 이전에 미러링한 그룹이 없는 인스턴스의 경우 이 옵션은 기본적으로 사용 중지되어 있습니다.
현재 미러링된 그룹을 구성한 기존 Looker 인스턴스의 경우 이 옵션이 기본적으로 사용 설정됩니다.
보다 제한적인 설정을 사용하면 사용자가 Looker에서 직접 구성된 그룹 멤버십 또는 할당된 역할을 잃게 됩니다. 이 문제는 다음에 사용자가 Looker에 로그인할 때 발생합니다.
고급 역할 관리 섹션에는 다음 옵션이 포함됩니다.
개별 OpenID Connect 사용자가 직접 역할을 수신하지 못하도록 차단: 이 옵션을 사용 설정하면 Looker 관리자가 OpenID Connect 사용자에게 Looker 역할을 직접 할당할 수 없습니다. OpenID Connect 사용자는 그룹 멤버십을 통해서만 역할을 받게 됩니다. OpenID Connect 사용자가 미러링된 것이 아닌 기본 Looker 그룹에 멤버십을 허용하는 경우 미러링된 OpenID Connect 그룹과 기본 Looker 그룹 모두에서 역할을 상속받을 수 있습니다. 이전에 역할이 직접 할당된 OpenID Connect 사용자는 다음에 로그인할 때 해당 역할이 삭제됩니다.
이 옵션을 사용 중지하면 Looker 관리자는 기본적으로 Looker에서 구성된 것처럼 OpenID Connect 사용자에게 직접 Looker 역할을 할당할 수 있습니다.
OpenID Connect 외 그룹에서 직접 멤버십 방지: 이 옵션을 사용 설정하면 Looker 관리자가 OpenID Connect 사용자를 기본 Looker 그룹에 직접 추가할 수 없습니다. 미러링된 OpenID Connect 그룹이 기본 Looker 그룹의 구성원이 될 수 있는 경우 OpenID Connect 사용자는 모든 상위 Looker 그룹의 멤버십을 유지할 수 있습니다. 이전에 네이티브 Looker 그룹에 할당된 OpenID Connect 사용자는 다음에 로그인할 때 해당 그룹에서 삭제됩니다.
이 옵션을 사용 중지하면 Looker 관리자가 OpenID Connect 사용자를 기본 Looker 그룹에 직접 추가할 수 있습니다.
OpenID Connect 외 그룹의 역할 상속 방지: 이 옵션을 사용 설정하면 미러링된 OpenID Connect 그룹의 회원이 기본 Looker 그룹의 역할을 상속하지 않습니다. 이전에 상위 Looker 그룹에서 역할을 상속받은 모든 OpenID Connect 사용자는 다음에 로그인할 때 해당 역할을 잃게 됩니다.
이 옵션을 사용 중지하면 미러링된 OpenID Connect 그룹 또는 기본 Looker 그룹의 구성원으로 추가된 OpenID Connect 사용자가 상위 Looker 그룹에 할당된 역할을 상속합니다.
인증에 역할 필요: 이 옵션을 사용 설정하면 OpenID Connect 사용자에게 역할이 할당되어 있어야 합니다. 역할이 할당되지 않은 OpenID Connect 사용자는 Looker에 아예 로그인할 수 없습니다.
이 옵션을 사용 중지하면 할당된 역할이 없더라도 OpenID Connect 사용자가 Looker에 인증할 수 있습니다. 역할이 할당되지 않은 사용자는 Looker에서 데이터를 보거나 작업을 수행할 수 없지만 Looker에 로그인할 수 있습니다.
이전 옵션 구성
이 섹션에 설명된 대로 Looker를 사용하면 대체 로그인을 사용 설정하고 기존 사용자에게 병합 전략을 제공할 것을 권장합니다.
지정된 사용자의 보조 로그인
OpenID Connect 인증이 사용 설정된 경우 일반 사용자의 Looker 이메일/비밀번호 로그인은 항상 사용 중지됩니다. 지정된 사용자에 대한 대체 로그인 옵션을 사용하면 관리자 및 지정된 login_special_email 사용자에 대해 /login/email를 사용한 대체 이메일 기반 로그인이 사용 설정됩니다.
이 기능을 사용 설정하는 것은 나중에 OpenID Connect 설정 문제가 발생하는 경우 또는 OpenID Connect 디렉터리에 계정이 없는 일부 사용자를 지원해야 하는 경우 유용합니다.
Looker API를 사용하여 대체 로그인을 사용 설정하려면 대체 로그인 옵션 사용 설정 문서 페이지를 참조하세요.
OpenID Connect 사용자를 Looker 계정에 병합하는 데 사용할 방법을 지정합니다.
병합한 사용자 사용 입력란에 최초 OpenID Connect 로그인을 기존 사용자 계정에 병합하는 데 사용할 방법을 지정합니다. 옵션은 Looker Email/Password, Google, LDAP, SAML입니다.
여러 인증 시스템을 설정한 경우 이 입력란에 병합할 시스템을 2개 이상 지정할 수 있습니다. Looker는 지정된 순서대로 나열된 시스템에서 사용자를 조회합니다. 예를 들어 Looker 이메일/비밀번호를 사용하여 일부 사용자를 만든 다음 LDAP를 사용 설정하고 이제 OpenID Connect를 사용하려는 경우를 가정해 보겠습니다. 위의 예에서 Looker는 먼저 이메일/비밀번호로 병합한 다음 LDAP로 병합합니다.
사용자가 OpenID Connect로 처음 로그인할 때 이 옵션은 일치하는 이메일 주소가 있는 계정을 찾아 기존 계정에 연결합니다. 해당 사용자의 기존 계정이 없으면 새 사용자 계정이 생성됩니다.
사용자 인증 테스트
이 구성을 지정하는 동안 테스트 버튼을 클릭하여 OpenID Connect 구성을 테스트합니다.
테스트 결과를 주의 깊게 읽어보세요. 테스트의 일부 부분이 실패해도 다른 부분이 성공할 수 있습니다.
테스트가 엔드포인트로 리디렉션되고 새 브라우저 탭이 열립니다. 다음 항목이 표시됩니다.
- Looker가 다양한 엔드포인트와 통신하고 유효성을 검사할 수 있는지 여부
- 인증 엔드포인트 응답의 trace입니다.
- Looker가 사용자 정보 엔드포인트에서 가져온 사용자 정보
- 수신된 ID 토큰의 디코딩 및 원시 버전 모두
이 테스트를 사용하면 다양한 엔드포인트에서 수신한 정보가 올바른지 확인하고 오류 문제를 해결할 수 있습니다.
팁:
- OpenID Connect가 부분적으로 구성되어 있더라도 언제든지 이 테스트를 실행할 수 있습니다. 구성 실행 중에 테스트를 실행하면 어떤 매개변수가 구성되어야 하는지 확인할 수 있습니다.
- 테스트에는 OpenID Connect 인증 페이지에 입력한 설정이 사용됩니다. 이 설정이 저장되지 않은 경우에도 마찬가지입니다. 테스트는 해당 페이지의 설정에 영향을 주거나 변경하지 않습니다.
설정 저장 및 적용
먼저 구성을 테스트하고 테스트 결과를 주의 깊게 읽고 테스트의 모든 부분이 성공했는지 확인합니다. 잘못된 OpenID Connect 구성 정보를 저장하면 나와 다른 사용자가 Looker에 액세스할 수 없습니다.
정보 입력을 완료하고 모든 테스트를 통과한 경우 위의 구성을 확인하고 전역적으로 적용을 사용 설정을 선택한 후 설정 업데이트를 클릭하여 저장합니다.