Demo Embed SDK

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

  • Jangan bagikan secret Anda kepada siapa pun yang tidak Anda inginkan untuk memiliki akses lengkap ke instance Anda.
  • Jangan reset secret jika Anda sudah menggunakannya dalam konteks lain.
  • Jangan siapkan kode Anda untuk menyimpan secret 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 > Platform Embed di instance Looker Anda. Tindakan ini memerlukan hak istimewa Admin.
  2. Server demo berjalan secara default di http://localhost:8080. Dengan menambahkan alamat tersebut ke Daftar yang Diizinkan Domain Tersemat, Anda dapat mengaktifkan demo untuk menerima pesan dari Looker.
  3. Aktifkan Sisipkan Autentikasi.
  4. Untuk melihat secret sematan, Anda harus meresetnya. Salin secret ke tempat yang aman.

Langkah 2: Sesuaikan setelan demo untuk instance Looker Anda

Berikan secret sematan Anda 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:

  • Menetapkan 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 dengan 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 dengan 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 port tempat server berjalan. Jika berbeda dengan http://localhost:8080, Anda harus menambahkannya ke Daftar yang Diizinkan Domain Tersemat.

Server Python

  1. Jalankan npm install
  2. Jalankan npm run python

Server akan mencetak host dan port tempat server berjalan.

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