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ébergée.
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 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 construire l'URL du contenu intégré et définir l'attribut src de l'iframe sur cette URL. N'hésitez pas à utiliser l'URL de votre propre contenu Looker lorsque vous suivez ces étapes.
L'URL du contenu intégré de l'exemple de code précédent est la suivante :
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://. Cet exemple va créer chaque partie en détail.
Partie 1 : Nom d'hôte
- 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. - Le nom d'hôte de l'URL de votre contenu intégré est
instance.looker.com.
Partie 2 : Chemin
Le chemin d'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
- 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 - Identifiez le chemin d'accès de l'URL de votre contenu Looker :
/dashboards/4. - Ajoutez le préfixe
/embedau chemin d'accès de l'URL de votre contenu Looker. Le chemin d'accès de l'URL de votre contenu intégré est/embed/dashboards/4.
Intégrer une visualisation de requête
- Accédez à la visualisation de votre requête. Exemple d'URL :
instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12 - Identifiez l'ID client de votre requête. Le paramètre
qid:1234567890abcdefghij12est l'ID client de votre requête qui représente la requête et les paramètres de visualisation. - Le chemin d'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 d'URL de votre contenu intégré contrôlent les filtres et le thème de votre contenu intégré.
Filtres
- Accédez à l'URL de votre contenu Looker.
- Ajustez manuellement les filtres de contenu selon vos préférences. Dans cet exemple, l'URL du contenu Looker obtenue est la suivante :
https://instance.looker.com/dashboards/4?Timeframe=14+day - Les paramètres d'URL de votre contenu intégré sont les paramètres d'URL du 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 découvrir 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 son comportement et son apparence.

3. Créer votre iFrame
- Créez votre élément iframe dans votre application hôte.
- Définissez l'attribut
srcsur l'URL de votre contenu intégré. - Définissez les attributs
width,heightet d'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 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. Connectez-vous à 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 d'URL de votre 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
Gardez à l'esprit deux mises en garde :
- Vous devez désactiver le paramètre "Protections de même origine pour les pages de connexion Looker" pour activer l'écran de connexion Looker dans l'iframe intégrée.
- Si votre instance Looker authentifie les utilisateurs à l'aide de l'authentification unique (SSO) avec un fournisseur d'identité, celui-ci peut bloquer l'écran de connexion dans votre iFrame. Dans ce cas, vous devrez utiliser l'option 1.
Règles relatives aux cookies du navigateur de l'utilisateur
Looker utilise des cookies pour l'authentification des utilisateurs et le stockage des sessions. Le navigateur de l'utilisateur doit autoriser les cookies tiers si le nom d'hôte de l'URL du contenu intégré de votre instance Looker auquel l'utilisateur accède se trouve dans un domaine différent de celui de votre application hôte.
Certains navigateurs, comme Firefox et Safari, utilisent par défaut une règle qui bloque les cookies tiers. Si le navigateur de l'utilisateur n'autorise pas 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 du contenu intégré de l'instance Looker résident sous le même domaine.
5. Interagir avec votre iFrame
Découvrez comment utiliser la messagerie iFrame Looker Embedded.
Étapes suivantes
Lancez-vous dans 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.