비공개 퍼가기 삽입하기

이 페이지에서는 비공개 임베딩을 설정하는 방법을 안내합니다. 비공개 삽입 옵션을 사용하려면 Looker 콘텐츠를 삽입하기 위해 <iframe> HTML 요소를 직접 관리해야 하며, 사용자가 호스트 애플리케이션과 별도로 Looker에 로그인해야 합니다.

비공개 임베딩 코드의 예시를 살펴보겠습니다.

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

참고: 삽입 가능한 모든 Looker 콘텐츠(대시보드, LookML 대시보드, 탐색, 보기, 쿼리 시각화, 확장 프로그램)에 적용됩니다.

1. 삽입 콘텐츠 URL 빌드

URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day에 있는 Looker 콘텐츠의 예를 살펴보겠습니다. 이 Looker 콘텐츠 URL에서 삽입 콘텐츠 URL을 생성하고 iframe의 src 속성을 설정합니다. 이 단계를 진행하면서 자신의 Looker 콘텐츠 URL을 사용해도 됩니다.

위 코드 샘플의 삽입 콘텐츠 URL은 다음과 같습니다.

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+day

삽입 콘텐츠 URL은 세 부분으로 구성됩니다.

호스트 이름: Looker 인스턴스의 호스트 이름
경로: /embed 접두사가 붙은 Looker 콘텐츠 URL 경로 (쿼리 시각화 추가 단계)
매개변수: 필터와 테마를 지정하는 URL 매개변수

프로토콜은 항상 https://이어야 합니다. 각 부분을 자세히 살펴보겠습니다.

참고: 콘텐츠 삽입 URL을 경로 접두어에 embed/를 추가한 완전한 Looker 콘텐츠 URL이라고 생각하면 됩니다 (아래의 쿼리 시각화를 삽입하지 않는 경우).

1부: 호스트 이름

Looker 콘텐츠로 이동합니다. Looker 콘텐츠 URL의 예: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
삽입 콘텐츠 URL 호스트 이름은 instance.looker.com입니다.

참고: 호스트 이름에는 포트 번호가 있습니다(예: instance.looker.com:9999

2부: 경로

삽입 콘텐츠 URL 경로는 삽입한 Looker 콘텐츠에 따라 다릅니다.

쿼리 시각화를 제외한 모든 Looker 콘텐츠 삽입

Looker 콘텐츠로 이동합니다. Looker 콘텐츠 URL 예: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
Looker 콘텐츠 URL의 경로(/dashboards/4)를 확인합니다.
Looker 콘텐츠 URL 경로에 /embed 프리픽스를 지정합니다. 삽입 콘텐츠 URL의 경로는 /embed/dashboards/4입니다.

쿼리 시각화 삽입

쿼리 시각화로 이동합니다. 예시 URL: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
쿼리의 클라이언트 ID를 확인합니다. qid 매개변수: 1234567890abcdefghij12는 쿼리와 시각화 설정을 나타내는 쿼리의 클라이언트 ID입니다.
삽입 콘텐츠 URL의 경로는 쿼리 클라이언트 ID와 함께 /embed/query-visualization/가 추가됩니다. 삽입 콘텐츠 URL의 경로 예는 /embed/query-visualization/1234567890abcdefghij12입니다.

참고:Looker API의 쿼리 가져오기 메서드를 Query 객체의 client_id 필드로 사용하여 쿼리의 클라이언트 ID를 찾을 수도 있습니다.

3부: 매개변수

삽입 콘텐츠 URL 매개변수는 삽입된 콘텐츠의 필터와 테마를 제어합니다.

필터

Looker 콘텐츠 URL로 이동합니다.
콘텐츠 필터를 원하는 대로 수동으로 조정합니다. 이 예에서 발생하는 Looker 콘텐츠 URL은 https://instance.looker.com/dashboards/4?Timeframe=14+day입니다.
삽입 콘텐츠 URL 매개변수는 Looker 콘텐츠 URL 매개변수입니다(예: Timeframe=14+day).

이 예시에서 매개변수 Timeframe=14+day는 대시보드의 Timeframe 필터 값을 설정합니다.

참고: 필터 매개변수는 필터를 만들지 않습니다. 사전에 대시보드에 존재해야 합니다.

테마 설정

테마 설정 가이드를 확인하여 삽입된 콘텐츠의 모양을 제어하는 방법을 알아보세요.

2. 삽입 콘텐츠 URL 테스트

브라우저에서 삽입 콘텐츠 URL을 열어 삽입 콘텐츠의 동작과 모양을 미리 봅니다.

3. iframe 만들기

호스트 애플리케이션에서 iframe 요소를 만듭니다.
src 속성을 삽입 콘텐츠 URL로 설정합니다.
삽입된 Looker 콘텐츠를 가장 잘 표시하는 데 필요한 항목에 width, height, 기타 속성을 정의합니다.

4. 사용자 액세스 문제 고려

사용자는 삽입된 콘텐츠를 보려면 Looker에 로그인해야 합니다. 로그인하지 않은 경우 iframe에 401 오류 페이지가 표시됩니다.

사용자 로그인 옵션

사용자는 다음 두 가지 방법 중 하나로 Looker에 로그인할 수 있습니다.

1. 미리 Looker에 로그인

사용자가 삽입된 콘텐츠를 보려면 동일한 브라우저에서 Looker에 로그인해야 합니다.

2. 삽입형 Looker 로그인 화면(선택사항) 사용 설정

사용자가 로그인하지 않은 경우 iframe에 Looker 로그인 화면을 표시하도록 allow_login_screen=true를 삽입 콘텐츠 URL 매개변수에 추가합니다. 삽입된 콘텐츠 URL의 예는 https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true입니다.

다음 두 가지 사항에 유의하세요.

iframe 삽입에서 Looker 로그인 화면을 사용 설정하려면 Looker 로그인 페이지의 Same-Origin Protection 설정을 사용 중지해야 합니다.
Looker 인스턴스가 ID 공급업체에 싱글 사인온 (SSO)을 통해 사용자를 인증하는 경우 ID 공급업체가 iframe 내에서 로그인 화면을 차단할 수 있습니다. 이 경우 옵션 1을 사용해야 합니다.

사용자 브라우저 쿠키 정책

Looker는 사용자 인증 및 세션 저장을 위해 쿠키를 사용합니다. 사용자가 Looker 인스턴스에 삽입된 콘텐츠 URL의 호스트 이름이 호스트 애플리케이션과 다른 도메인에 있는 경우 사용자의 브라우저에서 타사 쿠키를 사용 설정해야 합니다.

Firefox 및 Safari와 같은 일부 브라우저는 기본적으로 서드 파티 쿠키를 차단하는 쿠키 정책을 사용합니다. 사용자의 브라우저에서 서드 파티 쿠키를 허용할 수 없는 경우 호스트 애플리케이션을 사용하고 콘텐츠 URL의 hostnameLooker 인스턴스가 동일한 도메인에 있도록 Looker 인스턴스에 커스텀 도메인을 추가할 수 있습니다.

5. iframe과 상호작용

Looker 퍼가기 iframe 게시 메시지를 시작합니다.

다음 단계

삽입 SDK를 사용한 SSO 삽입을 시작하고 Looker 삽입으로 할 수 있는 작업의 예시를 확인하세요.