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

Nous allons passer en revue l'exemple de code d'intégration privée suivant :

<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 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 du contenu intégré 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égré 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é comporte trois parties :

  • Nom d'hôte : nom d'hôte de votre instance Looker
  • Chemin de l'URL : chemin 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 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 de contenu intégré 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, à 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 de l'URL de votre contenu Looker : /dashboards/4.
  3. Ajoutez /embed au début du chemin d'accès de l'URL de votre contenu Looker. Le chemin d'accès de votre URL de contenu intégré est /embed/dashboards/4.

Intégrer une visualisation de requête

  1. Accédez à votre visualisation de 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 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 votre contenu intégré est /embed/query-visualization/ suivi de l'ID client de votre requête. Le chemin d'accès de l'exemple d'URL de contenu intégré est /embed/query-visualization/1234567890abcdefghij12

Partie 3 : Paramètres

Les paramètres de votre URL de 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 comme vous le souhaitez. Dans cet exemple, l'URL de votre contenu Looker est la suivante : https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Les paramètres de votre URL de contenu intégré sont les paramètres de l'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 découvrir comment contrôler l'apparence de votre contenu intégré.

2. Tester votre URL de contenu intégré

Ouvrez votre URL de 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 votre URL de contenu intégré.
  3. Définissez les attributs width, height et autres attributs en fonction de vos besoins 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 affiche une page d'erreur 401 si l'utilisateur n'est pas connecté.

Options de connexion utilisateur

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 intégré facultatif

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

N'oubliez pas deux mises en garde :

  • Vous devez désactiver le paramètre "Protections Same-Origin pour les pages de connexion Looker" pour activer l'écran de connexion Looker dans l'intégration de l'iFrame.
  • Si votre instance Looker authentifie les utilisateurs à l'aide de l'authentification unique (SSO) avec un fournisseur d'identité, il est possible que ce dernier bloque l'écran de connexion dans votre iFrame. Dans ce cas, vous devrez utiliser l'option 1.

Looker utilise des 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 de contenu intégré de votre instance Looker sous un domaine différent de celui de votre application hôte.

Certains navigateurs, tels que Firefox et Safari, utilisent 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 votre application hôte et le nom d'hôte de l'URL de contenu intégré de l'instance Looker résident sous le même domaine.

5. Interagir avec votre iFrame

Premiers pas avec la messagerie post-iFrame d'intégration Looker.

Étapes suivantes

Premiers pas avec l'intégration signée à l'aide de notre SDK d'intégration et découvrez des exemples de ce que vous pouvez faire avec l'intégration Looker.