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 vous oblige à gérer directement l'élément HTML <iframe> pour intégrer votre contenu Looker. Elle exige également que l'utilisateur se connecte à Looker séparément de l'application hôte.

Nous allons parcourir 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égrer

Prenons l'exemple d'un contenu Looker à 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 de contenu à intégrer et définir l'attribut src de l'iframe sur cette URL. N'hésitez pas à utiliser votre propre URL de contenu Looker lorsque vous suivez ces étapes.

L'URL du contenu à intégrer de l'exemple de code précédent est la suivante :

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

L'URL du contenu intégré se compose de trois parties :

  • Nom d'hôte : nom d'hôte de votre instance Looker
  • Chemin d'accès : chemin d'accès de l'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 qui spécifient les filtres et le thème

Le protocole doit toujours être https://. Développons 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 l'URL de votre contenu intégré est instance.looker.com.

Partie 2 : Parcours

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

Intégrer tous les contenus Looker, à l'exception des visualisations de requêtes

  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 à l'URL de votre contenu Looker : /dashboards/4.
  3. Ajoutez le préfixe /embed au chemin d'accès de l'URL de votre contenu Looker. Le chemin d'URL de votre contenu intégré 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 l'ID client de votre requête. Le paramètre qid : 1234567890abcdefghij12 correspond à l'ID client de votre requête, qui représente les paramètres de requête et de visualisation.
  3. Le chemin d'accès de l'URL de votre contenu intégré est /embed/query-visualization/, auquel est ajouté l'ID client de votre requête. Le chemin d'accès de l'URL du contenu intégré de l'exemple est /embed/query-visualization/1234567890abcdefghij12.

Partie 3 : Paramètres

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

Filtres

  1. Accédez à l'URL de votre contenu Looker.
  2. Ajustez manuellement les filtres du contenu comme vous le souhaitez. Dans cet exemple, l'URL du contenu Looker obtenu est la suivante : https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Les paramètres d'URL de votre contenu intégré sont les 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 sur les thèmes pour savoir comment contrôler l'apparence de votre contenu intégré.

2. Tester l'URL de votre contenu intégré

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

3. Créer votre iframe

  1. Créez votre élément iframe dans votre application hôte.
  2. Définissez l'attribut src sur l'URL de votre contenu intégré.
  3. Définissez les attributs width, height et autres en fonction de ce dont vous avez besoin pour afficher au mieux votre contenu Looker intégré.

4. Tenir compte des problèmes d'accès des utilisateurs

L'utilisateur doit être connecté à Looker pour afficher votre contenu intégré. L'iframe affichera 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 dans le même navigateur avant de pouvoir afficher le contenu intégré.

2. Activer un écran de connexion Looker intégré facultatif

Ajoutez allow_login_screen=true aux paramètres de l'URL de contenu à intégrer pour afficher un écran de connexion Looker dans l'iframe si l'utilisateur n'est pas connecté. L'URL de contenu intégré de notre exemple devient : https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true

Veillez à tenir compte des deux points suivants :

Looker utilise des cookies pour l'authentification des utilisateurs et le stockage des sessions. Le navigateur de votre utilisateur doit autoriser les cookies tiers si le nom d'hôte de l'URL du contenu intégré de votre instance Looker se trouve sous un domaine différent de celui de votre application hôte.

Certains navigateurs, comme Firefox et Safari, appliquent par défaut une règle relative aux cookies qui bloque 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 afin que le nom d'hôte de l'URL de l'application hôte et du contenu intégré réside sous le même domaine que l'instance Looker.

5. Interagir avec votre iFrame

Commencez à utiliser la messagerie post-iframe d'intégration Looker.

Étapes suivantes

Commencez à utiliser l'intégration signée avec notre SDK Embed et consultez des exemples de ce que vous pouvez faire avec l'intégration Looker.