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.
- Buka Admin > Penyematan Platform di instance Looker Anda. Tindakan ini memerlukan hak istimewa Admin.
- 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. - Aktifkan Autentikasi Tersemat.
- 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
- Jalankan
npm install
- 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
- Jalankan
npm install
- 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.