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로 설정합니다.
  • .env 파일에 LOOKER_EMBED_HOST="yourinstance.looker.com:yourport"를 추가합니다.

삽입하려는 페이지에 맞게 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를 수행해야 할 수 있습니다.