Cette page vous explique comment configurer l'intégration privée. Pour utiliser l'option d'intégration privée, vous devez gérer l'<iFrame> élément HTML directement pour intégrer votre contenu Looker et nécessite que l'utilisateur se connecte à Looker séparément de l'application hôte.
Nous allons étudier 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 un exemple de 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égré et y définir l'attribut src
de l'iFrame. N'hésitez pas à utiliser votre propre URL de contenu Looker au cours de ces étapes.
L'URL de contenu intégré de l'exemple de code précédent se présente comme suit:
L'URL de contenu intégré se compose de trois parties:
- Nom d'hôte: le nom d'hôte de votre instance Looker
- Chemin: chemin de l'URL du contenu Looker précédé de
/embed
(avec des étapes supplémentaires pour les visualisations des requêtes) - Paramètres: paramètres d'URL spécifiant des filtres et un thème.
Le protocole doit toujours être https://
. Construisons chaque partie
en détail.
Partie 1: Nom d'hôte
- Accédez à votre contenu Looker. Après 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 du contenu intégré est
instance.looker.com
.
Partie 2: Chemin d'accès
Le chemin de l'URL du contenu intégré dépend du contenu Looker que vous intégrez.
Intégration de tout le contenu Looker, à l'exception des visualisations de requêtes
- Accédez à votre contenu Looker. Après 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
/embed
au chemin d'accès de votre URL de contenu Looker. Le chemin 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
:1234567890abcdefghij12
correspond à l'ID client de votre requête, qui représente la requête et les paramètres des visualisations. - Le chemin de l'URL du contenu intégré est
/embed/query-visualization/
, suivi de l'ID client de votre requête. Le chemin de l'exemple d'URL de contenu intégré est/embed/query-visualization/1234567890abcdefghij12
Partie 3: Paramètres
Les paramètres d'URL du contenu intégré contrôlent les filtres et la thématisation de votre contenu intégré.
Filtres
- Accédez à l'URL de votre contenu Looker.
- Ajustez manuellement les filtres du contenu en fonction de vos besoins. Dans cet exemple, l'URL de contenu Looker obtenue est
https://instance.looker.com/dashboards/4?Timeframe=14+day
. - Les paramètres d'URL du 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 de thématisation pour découvrir comment contrôler l'apparence de votre contenu intégré.
2. Tester l'URL du contenu intégré
Ouvrez l'URL du contenu intégré dans votre navigateur pour prévisualiser le comportement et l'apparence de ce contenu.
3. Créer votre iFrame
- Créez votre élément iFrame dans votre application hôte.
- Définissez l'attribut
src
sur l'URL de votre contenu intégré. - Définissez les attributs
width
,height
et d'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 pouvoir consulter votre contenu intégré. Si l'utilisateur n'est pas connecté, l'iFrame affiche une page d'erreur 401.
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 pour 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 du contenu intégré pour présenter un écran de connexion Looker dans l'iFrame si l'utilisateur n'est pas connecté. Notre exemple d'URL de contenu intégré devient: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true
Gardez à l'esprit les deux mises en garde suivantes:
- Vous devez désactiver le paramètre "Protections de même origine pour les pages de connexion Looker" afin d'activer l'écran de connexion Looker dans l'intégration iFrame.
- Si votre instance Looker authentifie les utilisateurs à l'aide de l'authentification unique (SSO) avec un fournisseur d'identité, il est possible que votre fournisseur d'identité bloque l'écran de connexion dans votre iFrame. Dans ce cas, vous devez 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 votre utilisateur doit activer les cookies tiers si celui-ci accède à votre instance Looker. Le nom d'hôte de l'URL du contenu incorporé se trouve sous un domaine différent de celui de votre application hôte.
Certains navigateurs, tels que Firefox et Safari, appliquent par défaut des règles relatives aux cookies qui bloquent 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 l'instance Looker du nom d'hôte de l'URL du contenu intégré résident dans le même domaine.
5. Interagir avec votre iFrame
Faites vos premiers pas avec l'intégration de messages iFrame à Looker.
Étapes suivantes
Faites vos premiers pas avec l'intégration signée à l'aide de notre SDK Embed et consultez des exemples de ce que vous pouvez faire avec l'intégration Looker.