Premiers pas avec l'intégration privée

Vérifiez vos connaissances:cette page part du principe que vous connaissez les principes de base des éléments HTML <iframe>, des URL (Uniform Resource Locators) et des cookies tiers. Consultez la documentation Web MDN sur les iframes pour vous familiariser avec les principes de base.

Cette page 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. L'utilisateur doit également se connecter à Looker séparément de l'application hôte.

Nous allons passer en revue 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>

Remarque :Les instructions suivantes s'appliquent à tous les contenus Looker pouvant être intégrés: tableaux de bord, tableaux de bord LookML, explorations, présentations, visualisations de requêtes et extensions.

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

Remarque :Cette page explique comment créer manuellement l'URL du contenu intégré. Vous pouvez également générer une URL d'intégration à partir d'un tableau de bord, d'une présentation ou d'une exploration Looker.

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 y définir l'attribut src de l'iframe. 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é se compose de trois parties:

• Nom d'hôte: nom d'hôte de votre instance Looker
• Chemin: chemin d'accès de l'URL du contenu Looker avec un préfixe /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.

Remarque :Pour simplifier, considérez l'URL du contenu intégré comme l'URL complète du contenu Looker avec le préfixe embed/ ajouté au chemin (sauf si vous intégrez des visualisations de requête).

Partie 1: Nom d'hôte

1. Accédez à votre contenu Looker. Voici un 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.

Remarque : Le nom d'hôte inclut le numéro de port, le cas échéant, par exemple : instance.looker.com:9999.

Partie 2: Parcours

Le chemin d'URL du 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. Voici un exemple d'URL de contenu Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
2. Identifiez le chemin de l'URL de votre contenu Looker: /dashboards/4.
3. Ajoutez le préfixe /embed au chemin de l'URL de votre contenu Looker. Le chemin de l'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. 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 d'accès de votre contenu intégré est /embed/query-visualization/ suivi de votre ID client de requête. Le chemin d'accès de l'URL d'exemple du contenu intégré est /embed/query-visualization/1234567890abcdefghij12.

Remarque :Vous pouvez également trouver l'ID client de la requête avec la méthode Get Query (Obtenir la requête) de l'API Looker en tant que champ client_id de l'objet Query.

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 préférences. Dans cet exemple, l'URL du contenu Looker obtenue 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 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.

Remarque :Le paramètre de filtre ne crée pas le filtre. Il doit déjà exister dans le 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 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

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 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 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 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 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 points importants:

• 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'intégration d'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 fournisseur bloque l'écran de connexion dans votre iframe. Dans ce cas, vous devrez utiliser l'option 1.

Règles concernant les 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 activer les cookies tiers si l'URL du contenu intégré de votre instance Looker est sous un domaine différent de celui de votre application hôte.

Certains navigateurs, comme Firefox et Safari, utilisent par défaut une règle de 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 l'instance Looker du nom d'hôte de l'URL du contenu intégré se trouvent sur le même domaine.

Remarque :Vous pouvez consulter la liste des cookies utilisés par Looker sur la page de documentation Liste des cookies Looker.

5. Interagir avec votre iFrame

Commencez à utiliser l'iframe intégré de Looker pour la messagerie post-achat.

Étapes suivantes

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