Premiers pas avec l'intégration privée

Cette page vous explique comment configurer l'intégration privée. L'option d'intégration privée nécessite que vous gériez l'élément HTML <iframe> directement pour intégrer votre contenu Looker. L'utilisateur doit se connecter à Looker indépendamment de l'application hôte.

Nous allons examiner cet exemple de code d'intégration privée:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

1. Créer l'URL du contenu intégré

Prenons l'exemple du contenu Looker accessible à l'URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. À partir de cette URL de contenu Looker, nous allons créer l'URL d'intégration de contenu et y définir l'attribut src de l'iFrame. N'hésitez pas à utiliser votre propre URL de contenu Looker tout au long de la procédure.

L'URL d'intégration du contenu de l'exemple de code ci-dessus est la suivante:

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+jour

L'URL d'intégration de contenu se compose de trois parties:

  • Nom d'hôte: nom d'hôte de votre instance Looker
  • Chemin: chemin d'URL du contenu Looker précédé de /embed (avec des étapes supplémentaires pour les visualisations de requêtes)
  • Paramètres: paramètres d'URL spécifiant les filtres et la thématisation

Le protocole doit toujours être https://. Créons chaque partie en détail.

Partie 1: Nom d'hôte

  1. Accédez à votre contenu Looker. En suivant l'exemple d'URL de contenu Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. Le nom d'hôte de votre URL d'intégration de contenu est instance.looker.com.

Partie 2: Chemin d'accès

Le chemin de l'URL de votre contenu intégré dépend du contenu Looker que vous intégrez.

Intégrer tout le contenu Looker, sauf les visualisations de requête

  1. Accédez à votre contenu Looker. En suivant l'exemple d'URL de contenu Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. Identifiez le chemin d'accès de votre URL de contenu Looker: /dashboards/4.
  3. Ajoutez le préfixe /embed au chemin de l'URL de contenu Looker. Le chemin de votre URL d'intégration de contenu est /embed/dashboards/4.

Intégrer une visualisation de requête

  1. Accédez à la visualisation de votre requête. Exemple d'URL : instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. Identifiez votre ID client de requête. Le paramètre qid: 1234567890abcdefghij12 est l'ID client de votre requête qui représente la requête et les paramètres de visualisation.
  3. Le chemin de l'URL de contenu intégré est /embed/query-visualization/ suivi de votre ID client de requête. Exemple de chemin d'accès de l'URL de contenu intégré : /embed/query-visualization/1234567890abcdefghij12

Partie 3: Paramètres

Les paramètres d'URL de votre contenu intégré contrôlent les filtres et la thématisation de votre contenu intégré.

Filtres

  1. Accédez à l'URL de votre contenu Looker.
  2. Ajustez manuellement les filtres du contenu selon vos besoins. Pour cet exemple, l'URL de contenu Looker obtenue est la suivante: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Les paramètres d'URL de contenu d'intégration correspondent aux paramètres d'URL de contenu Looker, par exemple Timeframe=14+day

Dans cet exemple, le paramètre Timeframe=14+day définit la valeur du filtre Timeframe du tableau de bord.

Thématisation

Consultez le guide de thématisation pour savoir comment contrôler l'apparence de votre contenu intégré.

2. Tester l'URL d'intégration de contenu

Ouvrez l'URL du contenu intégré dans votre navigateur pour prévisualiser le comportement et l'apparence du contenu intégré.

3. Créer votre iFrame

  1. Créez votre élément iFrame dans l'application hôte.
  2. Définissez l'attribut src sur l'URL d'intégration de contenu.
  3. Définissez les attributs width et height, ainsi que d'autres attributs, afin d'afficher au mieux le contenu Looker intégré.

4. Examiner les problèmes d'accès des utilisateurs

L'utilisateur doit être connecté à Looker pour afficher votre contenu intégré. L'iFrame affiche une page d'erreur 401 si l'utilisateur n'est pas connecté.

Options de connexion des utilisateurs

Votre utilisateur peut se connecter à Looker de deux manières:

1. Se connecter à Looker au préalable

Votre utilisateur doit se connecter à Looker sur le même navigateur avant de pouvoir afficher le contenu intégré.

2. Activer un écran de connexion Looker facultatif avec intégration

Ajoutez allow_login_screen=true aux paramètres d'URL de contenu d'intégration pour présenter un écran de connexion Looker dans le cadre iFrame si l'utilisateur n'est pas connecté. Voici un exemple d'URL de contenu intégré: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Deux points à noter:

Looker utilise les cookies pour l'authentification des utilisateurs et le stockage des sessions. Le navigateur de votre utilisateur doit activer les cookies tiers si l'utilisateur accède au nom d'hôte de l'URL d'intégration de votre instance Looker sur un domaine différent de celui de votre application hôte.

Certains navigateurs, comme Firefox et Safari, utilisent par défaut des règles pour bloquer les cookies tiers. Si le navigateur de l'utilisateur ne peut pas autoriser les cookies tiers, vous pouvez ajouter un domaine personnalisé à votre instance Looker. Votre application hôte et l'instance hostnameLooker de l'URL de contenu résideront ainsi dans le même domaine.

5. Interagir avec votre iFrame

Premiers pas avec l'intégration de Looker dans l'intégration de messages de messages iFrame.

Étapes suivantes

Lancez-vous avec l'intégration SSO avec notre SDK Embed et consultez des exemples de ce que vous pouvez faire avec l'intégration Looker.