Demo Incorpora SDK

Il repository SDK SDK di Looker include codice campione e una semplice demo dell'SDK Embed. A causa dell'attenzione di Looker per la sicurezza, la demo richiede un po' di configurazione. La demo richiede anche il tuo secret di incorporamento Looker. Il secret di incorporamento concede l'accesso a tutti i tuoi dati, quindi tieni presente quanto segue:

  • Non condividere il secret con nessuno 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 per memorizzare il secret nel browser web.

Passaggio 1: abilita l'incorporamento nell'istanza di Looker

Puoi trovare informazioni più dettagliate nella pagina della documentazione Incorporamento del Single Sign-On (SSO).

  1. Vai ad Amministrazione > Incorpora piattaforma sulla tua istanza di Looker. Sono necessari privilegi amministrativi.
  2. Il server dimostrativo viene eseguito per impostazione predefinita su http://localhost:8080. Se aggiungi questo indirizzo alla lista consentita del dominio incorporato, puoi abilitare la demo per ricevere i messaggi da Looker.
  3. Attiva Incorpora autenticazione.
  4. 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:

  • Imposta LOOKER_EMBED_SECRET come nell'ambiente shell.
  • Crea un file denominato .env nella directory principale dell'SDK. Aggiungi una riga al file: LOOKER_EMBED_SECRET="YourLookerSecret"

Fornisci l'indirizzo host dell'istanza di Looker al server in uno dei seguenti modi:

  • Impostarla come LOOKER_EMBED_HOST nell'ambiente shell.
  • Aggiunta di LOOKER_EMBED_HOST="yourinstance.looker.com:yourport" al file .env.

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

  1. Esegui npm install
  2. Esegui npm start

Il server stampa l'host e la porta su cui è in esecuzione. Se è diverso da http://localhost:8080, dovrai aggiungerlo alla Lista consentita del dominio incorporato.

Server Python

  1. Esegui npm install
  2. Esegui npm run python

Il server stampa l'host e la porta su cui è in esecuzione.

Potresti dover pip install six per installare il livello di compatibilità Python 2/3.