Premiers pas avec l'intégration privée

Cette page vous aide à configurer une intégration privée. L'option d'intégration privée nécessite que vous gériez l'élément HTML <iframe> directement pour intégrer votre contenu Looker, et l'utilisateur doit se connecter à Looker indépendamment de l'application hôte.

Voici un exemple de code de représentation vectorielle continue privé:

<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 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 construire 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 tout au long de ces étapes.

L'URL de contenu intégré de l'exemple de code ci-dessus est la suivante:

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

L'URL d'intégration de contenu comprend trois parties:

  • Nom d'hôte: nom d'hôte de votre instance Looker
  • Chemin d'accès: l'URL de contenu Looker est précédée de /embed (avec des étapes supplémentaires pour les visualisations de requêtes).
  • Paramètres: paramètres d'URL indiquant des filtres et des thèmes

Le protocole doit toujours être https://. Créons ensemble chaque partie.

Partie 1: Nom d'hôte

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

  1. Accédez à votre contenu Looker. Voici 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 de votre URL d'intégration de contenu 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 est l'ID client de votre requête qui représente les paramètres de requête et de visualisation.
  3. Le chemin de votre URL d'intégration de contenu est /embed/query-visualization/ et de votre ID client de requête. Exemple de chemin d'accès à l'URL de contenu intégré : /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

  1. Accédez à l'URL de votre contenu Looker.
  2. Ajustez manuellement les filtres de contenu selon vos besoins. Pour cet exemple, l'URL de contenu Looker qui en résulte est https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. Les paramètres d'URL de contenu d'intégration 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 démarrage pour savoir comment contrôler l'apparence de votre contenu intégré.

2. Tester l'URL de 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 et height, ainsi que d'autres attributs, selon ce dont vous avez besoin pour mieux afficher 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 d'URL de contenu d'intégration pour présenter un écran de connexion Looker dans le cadre iFrame si l'utilisateur n'est pas connecté. L'exemple d'URL de contenu intégré devient https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Attention:

Looker utilise des cookies pour l'authentification des utilisateurs et le stockage de sessions. Le navigateur de votre utilisateur doit activer les cookies tiers s'il accède au nom d'hôte de l'URL du contenu intégré de votre instance Looker 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 blocage des 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 l'application hôte et l'instance hostnameLooker de l'URL de contenu résident dans le même domaine.

5. Interagir avec votre iFrame

Commencez à intégrer les messages iFrame de Looker à une publication.

Étapes suivantes

Découvrez l'intégration SSO à l'aide de notre SDK Embed et consultez des exemples de ce que vous pouvez faire avec l'intégration Looker.