Demo Embed SDK

Repositori Embed SDK Looker menyertakan kode contoh dan demo sederhana Embed SDK. Karena perhatian Looker pada keamanan, demo memerlukan sedikit penyiapan. Demo ini juga memerlukan rahasia penyematan Looker Anda. Rahasia sematan memberikan akses ke semua data Anda, jadi perhatikan hal berikut:

  • Jangan bagikan rahasia kepada siapa pun yang tidak Anda izinkan untuk memiliki akses penuh ke instance Anda.
  • Jangan reset rahasia jika Anda sudah menggunakannya dalam konteks lain.
  • Jangan menyiapkan kode untuk menyimpan rahasia di browser web.

Langkah 1: Aktifkan penyematan di instance Looker Anda

Hal ini didokumentasikan secara lebih mendetail di halaman dokumentasi Penyematan yang ditandatangani.

  1. Buka Admin > Penyematan Platform di instance Looker Anda. Tindakan ini memerlukan hak istimewa Admin.
  2. Server demo berjalan secara default pada http://localhost:8080. Dengan menambahkan alamat tersebut ke Daftar Domain yang Diizinkan, Anda dapat mengaktifkan demo untuk menerima pesan dari Looker.
  3. Aktifkan Autentikasi Tersemat.
  4. Untuk melihat rahasia penyematan, Anda harus meresetnya. Salin rahasia ke tempat yang aman.

Langkah 2: Sesuaikan setelan demo untuk instance Looker Anda

Berikan rahasia penyematan ke server. Anda dapat melakukannya dengan beberapa cara:

  • Tetapkan sebagai LOOKER_EMBED_SECRET di lingkungan shell Anda.
  • Buat file bernama .env di root direktori sdk. Tambahkan baris ke file tersebut: LOOKER_EMBED_SECRET="YourLookerSecret"

Berikan alamat host instance Looker Anda ke server dengan:

  • Menyetelnya sebagai LOOKER_EMBED_HOST di lingkungan shell Anda.
  • Menambahkan LOOKER_EMBED_HOST="yourinstance.looker.com:yourport" ke file .env.

Edit file demo/demo_config.ts agar sesuai untuk halaman yang ingin Anda sematkan.

// 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

Edit file demo/demo_user.json agar sesuai untuk jenis pengguna yang ingin Anda sematkan.

{
  // 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" },
}

Langkah 3: Build dan jalankan demo

Server node

  1. Jalankan npm install
  2. Jalankan npm start

Server akan mencetak host dan porta yang menjalankannya. Jika domain tersebut berbeda dengan http://localhost:8080, Anda harus menambahkannya ke Daftar Domain yang Diizinkan yang Disematkan.

Server Python

  1. Jalankan npm install
  2. Jalankan npm run python

Server akan mencetak host dan porta yang menjalankannya.

Anda mungkin perlu pip install six untuk menginstal lapisan kompatibilitas Python 2/3.