Il repository SDK Embed di Looker include codice campione e una semplice demo dell'SDK Embed. Data l'attenzione di Looker alla sicurezza, la demo richiede un po' di configurazione. La demo richiede anche il secret di incorporamento di Looker. Il secret di incorporamento concede l'accesso a tutti i dati, quindi tieni presente quanto segue:
- Non condividere il tuo secret con persone a cui non vuoi concedere l'accesso completo all'istanza.
- Non reimpostare il secret se lo stai già utilizzando in un altro contesto.
- Non configurare il codice in modo che memorizzi il segreto nel browser web.
Passaggio 1: abilita l'incorporamento nell'istanza Looker
Per maggiori dettagli, consulta la pagina della documentazione relativa all'incorporamento firmato.
- Vai ad Admin > Platform Embed (Amministrazione > Incorporamento della piattaforma) sull'istanza di Looker. Sono necessari privilegi amministrativi.
- Il server demo viene eseguito per impostazione predefinita alle ore
http://localhost:8080
. Aggiungendo l'indirizzo alla lista consentita dei domini incorporati, puoi abilitare la demo per ricevere messaggi da Looker. - Attiva Incorpora autenticazione.
- Per visualizzare il secret di incorporamento, devi reimpostarlo. Copia il secret in un luogo sicuro.
Passaggio 2: personalizza le impostazioni della demo per l'istanza di Looker
Fornisci il tuo secret di incorporamento al server. Puoi farlo in due modi:
- Impostalo come
LOOKER_EMBED_SECRET
nel tuo ambiente shell. - Crea un file denominato
.env
nella directory principale della directory SDK. Aggiungi una riga al file:LOOKER_EMBED_SECRET="YourLookerSecret"
Fornisci l'indirizzo host dell'istanza Looker al server in uno dei seguenti modi:
- L'impostazione come
LOOKER_EMBED_HOST
nel tuo ambiente shell. - Aggiunta di
LOOKER_EMBED_HOST="yourinstance.looker.com:yourport"
al file.env
in corso...
Modifica il file demo/demo_config.ts
in modo che sia appropriato per le pagine che vuoi incorporare.
// 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
Modifica il file demo/demo_user.json
in modo che sia appropriato per il tipo di utente che vuoi incorporare.
{
// 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" },
}
Passaggio 3: crea ed esegui la demo
Server nodo
- Esegui
npm install
- Esegui
npm start
Il server stamperà l'host e la porta su cui è in esecuzione. Se è diverso da http://localhost:8080
, dovrai aggiungerlo alla lista consentita dei domini incorporati.
Server Python
- Esegui
npm install
- Esegui
npm run python
Il server stamperà l'host e la porta su cui è in esecuzione.
Potrebbe essere necessario pip install six
per installare il livello di compatibilità Python 2/3.