비공개 삽입 시작하기

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

비공개 삽입 코드 예시를 살펴보겠습니다.

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

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://여야 합니다. 각 부분을 자세히 빌드해 보겠습니다.

1부: 호스트 이름

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

2부: 경로

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

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

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

쿼리 시각화 삽입

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

3부: 매개변수

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

필터

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

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

테마 설정

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

2. 삽입 콘텐츠 URL 테스트

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

3. iframe 만들기

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

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

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

사용자 로그인 옵션

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

1. Looker에 미리 로그인

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

2. 선택적 삽입 Looker 로그인 화면 사용 설정

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

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

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

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

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

5. iframe과 상호작용

Looker 삽입 게시물 게시 메시지를 시작합니다.

다음 단계

삽입 SDK를 사용하여 서명된 삽입을 시작하고 Looker 삽입으로 수행할 수 있는 작업의 예시를 확인합니다.