Embed SDK 데모

Looker Embed SDK 저장소에는 샘플 코드와 Embed SDK의 간단한 데모가 포함되어 있습니다. Looker는 보안에 각별히 신경을 쓰고 있으므로 데모를 사용하려면 약간의 설정이 필요합니다. 또한 데모에는 Looker 삽입 보안 비밀이 필요합니다. 삽입된 보안 비밀은 모든 데이터에 대한 액세스 권한을 부여하므로 다음 사항에 유의하세요.

  • 인스턴스에 대한 전체 액세스 권한을 부여하고 싶지 않은 사용자와 보안 비밀을 공유하지 마세요.
  • 이미 다른 컨텍스트에서 보안 비밀을 사용하고 있다면 재설정하지 마세요.
  • 웹브라우저에 비밀번호를 저장하도록 코드를 설정하지 마세요.

1단계: Looker 인스턴스에서 삽입 사용 설정

자세한 내용은 서명된 삽입 문서 페이지에 자세히 설명되어 있습니다.

  1. Looker 인스턴스에서 관리자 > 플랫폼 삽입으로 이동합니다. 이 경우 관리자 권한이 필요합니다.
  2. 데모 서버는 기본적으로 http://localhost:8080에서 실행됩니다. 이 주소를 삽입된 도메인 허용 목록에 추가하면 데모에서 Looker의 메시지를 수신하도록 설정할 수 있습니다.
  3. 인증 삽입을 사용 설정합니다.
  4. 삽입 보안 비밀을 보려면 초기화해야 합니다. 보안 비밀을 안전한 장소에 복사합니다.

2단계: Looker 인스턴스의 데모 설정 맞춤설정하기

서버에 삽입 보안 비밀을 제공합니다. 이 작업은 몇 가지 방법으로 수행할 수 있습니다.

  • 셸 환경에서 이를 LOOKER_EMBED_SECRET으로 설정합니다.
  • SDK 디렉터리의 루트에 .env라는 파일을 만듭니다. 해당 파일에 다음 줄을 추가합니다. LOOKER_EMBED_SECRET="YourLookerSecret"

다음 중 하나를 사용하여 서버에 Looker 인스턴스 호스트 주소를 제공합니다.

  • 셸 환경에서 이를 LOOKER_EMBED_HOST로 설정합니다.
  • LOOKER_EMBED_HOST="yourinstance.looker.com:yourport".env 파일에 추가합니다.

삽입하려는 페이지에 적합하도록 demo/demo_config.ts 파일을 수정합니다.

// The address of your Looker instance. Required.
export const lookerHost = 'self-signed.looker.com:9999'

// A dashboard that the user can see. Set to 0 to disable dashboard.
export const dashboardId = 1
// A Look that the user can see. Set to 0 to disable look.
export const lookId = 1

삽입하려는 사용자 유형에 적합하도록 demo/demo_user.json 파일을 수정합니다.

{
  // External embed user ID. IDs are not shared with regular users. Required
  "external_user_id": "user1",
  // First and last name. Optional
  "first_name": "Pat",
  "last_name": "Embed",
  // Duration before session expires, in seconds. Required.
  "session_length": 3600,
  // Enforce logging in with these permissions. Recommended.
  "force_logout_login": true,
  // External embed group ID. Optional.
  "external_group_id": "group1",
  // Looker Group IDs. Optional
  "group_ids": [],
  // Permissions. See documentation for details. Required.
  // Can any combination of:
  //   access_data
  //   see_looks
  //   see_user_dashboards
  //   see_lookml_dashboards
  //   explore
  //   create_table_calculations
  //   download_with_limit
  //   download_without_limit
  //   see_drill_overlay
  //   see_sql
  //   save_content
  //   embed_browse_spaces
  //   schedule_look_emails
  //   send_to_sftp
  //   send_to_s3
  //   send_outgoing_webhook
  //   schedule_external_look_emails
  "permissions": [
    "access_data",
    "see_looks",
    "see_user_dashboards",
    "explore"
    "save_content",
    "embed_browse_spaces"
  ],
  // Model access permissions. Required.
  "models": ["powered_by", "thelook"],
  // User attributes. Optional.
  "user_attributes": { "locale": "en_US" },
}

3단계: 데모 빌드 및 실행

노드 서버

  1. npm install 실행
  2. npm start 실행

서버가 실행 중인 호스트와 포트를 출력합니다. http://localhost:8080과 다른 경우 삽입된 도메인 허용 목록에 추가해야 합니다.

Python 서버

  1. npm install 실행
  2. npm run python 실행

서버가 실행 중인 호스트와 포트를 출력합니다.

Python 2/3 호환성 레이어를 설치하려면 pip install six를 수행해야 할 수 있습니다.