Démo du SDK Embed

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 version de 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 accorde l'accès à toutes vos données. Par conséquent, tenez compte des points suivants:

• Ne partagez pas votre secret avec des personnes auxquelles vous ne voulez pas donner accès à votre instance.
• Ne réinitialisez pas le secret si vous l'utilisez déjà dans un autre contexte.
• Ne configurez pas votre code pour stocker le secret dans le navigateur Web.

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

Ce processus est décrit en détail sur la page de documentation sur l'intégration de l'authentification unique (SSO).

1. Accédez à Admin > Intégrer la plate-forme sur votre instance Looker. Vous devez disposer des droits d'administrateur.
2. Le serveur de démonstration s'exécute par défaut à http://localhost:8080. En ajoutant cette adresse à la liste des domaines autorisés, vous pouvez autoriser la démonstration à recevoir des messages de Looker.
3. Activez Embed Authentication.
4. Pour afficher votre secret d'intégration, vous devez le réinitialiser. Copiez le secret dans un endroit sécurisé.

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

Fournissez votre secret d'intégration au serveur. Pour ce faire, vous pouvez:

• Définissez-la sur LOOKER_EMBED_SECRET dans votre environnement 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 de l'hôte de l'instance Looker au serveur:

• Définissez-le sur LOOKER_EMBED_HOST dans votre environnement shell.
• Ajout de LOOKER_EMBED_HOST="yourinstance.looker.com:yourport" au fichier .env.

Modifiez le fichier demo/demo_config.ts en fonction des pages à 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 en fonction du 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: Créez et exécutez la démo

Serveur de nœuds

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

Le serveur affiche l'hôte et le port sur lesquels il s'exécute. Si elle est différente de http://localhost:8080, vous devez l'ajouter à votre liste d'autorisation de domaines intégrés.

Serveur Python

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

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

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