Démo du SDK d'ingestion

Le dépôt du SDK Embed de Looker inclut un exemple de code et une démonstration simple du SDK Embed. En raison de l'attention portée par Looker à la sécurité, la démonstration nécessite un peu de configuration. La démonstration nécessite également votre secret d'intégration Looker. Le secret d'intégration donne accès à toutes vos données. Veuillez noter les points suivants:

  • Ne partagez pas votre secret avec qui que ce soit à qui vous ne souhaitez pas accorder un accès complet à votre instance.
  • Ne réinitialisez pas votre secret si vous l'utilisez déjà dans un autre contexte.
  • Ne configurez pas votre code pour qu'il stocke le secret dans le navigateur Web.

Étape 1: Activez l'intégration dans votre instance Looker

Pour en savoir plus, consultez la page de documentation sur l'intégration signée.

  1. Accédez à Admin > Intégration de la plate-forme dans votre instance Looker. Cette opération nécessite des droits d'administrateur.
  2. Par défaut, le serveur de démonstration s'exécute sur http://localhost:8080. En ajoutant cette adresse à la liste d'autorisation du domaine intégré, vous pouvez permettre à la démonstration de recevoir des messages de Looker.
  3. Activez l'option Intégrer l'authentification.
  4. Pour afficher votre secret d'intégration, vous devez le réinitialiser. Copiez le secret dans un emplacement sécurisé.

Étape 2 : Personnalisez les paramètres de démonstration de votre instance Looker

Fournissez votre secret d'intégration au serveur. Vous pouvez le faire de plusieurs manières :

  • Définissez-le en tant que LOOKER_EMBED_SECRET dans votre environnement de shell.
  • Créez un fichier nommé .env à la racine du répertoire du SDK. Ajoutez une ligne à ce fichier : LOOKER_EMBED_SECRET="YourLookerSecret"

Indiquez l'adresse hôte de votre instance Looker au serveur de l'une des manières suivantes:

  • Définissez-la en tant que LOOKER_EMBED_HOST dans votre environnement de shell.
  • Ajout de LOOKER_EMBED_HOST="yourinstance.looker.com:yourport" au fichier .env.

Modifiez le fichier demo/demo_config.ts pour qu'il corresponde aux pages que vous souhaitez intégrer.

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

Modifiez le fichier demo/demo_user.json pour qu'il corresponde au type d'utilisateur que vous souhaitez intégrer.

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

Étape 3 : Compiler et exécuter la démonstration

Serveur de nœud

  1. Exécuter npm install
  2. Exécuter npm start

Le serveur affichera l'hôte et le port sur lesquels il s'exécute. S'il est différent de http://localhost:8080, vous devez l'ajouter à votre liste d'autorisation de domaine intégrée.

Serveur Python

  1. Exécuter npm install
  2. Exécuter npm run python

Le serveur indique l'hôte et le port sur lesquels il s'exécute.

Vous devrez peut-être exécuter la commande pip install six pour installer la couche de compatibilité Python 2/3.