SDK 데모 삽입

Looker Embed SDK 저장소에는 샘플 코드와 Embed SDK의 간단한 데모가 포함되어 있습니다. Looker에서 보안에 집중하기 때문에 데모를 사용하려면 약간의 설정이 필요합니다. 데모에는 Looker 삽입 비밀번호도 필요합니다. 삽입 보안 비밀은 모든 데이터에 대한 액세스 권한을 부여하므로 다음을 참고하세요.

  • 인스턴스에 대한 액세스 권한을 모두 갖고 싶지 않은 사람과 보안 비밀을 공유하지 마세요.
  • 이미 다른 컨텍스트에서 사용 중인 보안 비밀은 재설정하지 마세요.
  • 웹브라우저에 보안 비밀을 저장하도록 코드를 설정하지 마세요.

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

이 내용은 싱글 사인온 (SSO) 삽입 문서 페이지에 자세히 설명되어 있습니다.

  1. Looker 인스턴스에서 Admin > Platform Embed로 이동합니다. 관리자 권한이 필요합니다.
  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이 다른 경우 Embedded Domain Allowlist(삽입된 도메인 허용 목록)에 추가해야 합니다.

Python 서버

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

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

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