Incorporation privée

En plus de l'intégration publique, vous pouvez intégrer les styles, les explorations et les tableaux de bord en mode privé pour que l'authentification soit requise via une connexion Looker, Google OAuth ou OpenID Connect. Si un utilisateur n'est pas authentifié, vous pouvez afficher un message d'erreur ou afficher un écran de connexion.

Les paramètres des utilisateurs qui se connectent et accèdent au contenu intégré en mode privé sont définis dans le panneau Sessions Admin, qui déterminent la durée pendant laquelle ils peuvent rester connectés, s'ils peuvent se connecter depuis plusieurs navigateurs et s'ils seront déconnectés après une période d'inactivité.

Si vous avez besoin d'une solution intégrée plus avancée ou personnalisable, consultez notre page de documentation sur l'intégration de l'authentification unique (SSO).

Générer une URL d'intégration

Pour générer et copier une URL d'intégration privée pour un tableau de bord, un aperçu ou une visualisation de l'exploration, sélectionnez Obtenir l'URL d'intégration dans un menu à trois points du tableau de bord, ou dans le menu en forme de roue dentée d'exploration des explorations ou Look. Looker affiche la fenêtre Obtenir l'URL d'intégration.

La fenêtre Obtenir l'URL d'intégration comprend les éléments suivants:

  1. Le champ URL d'intégration affiche l'URL d'intégration privée complète.
  2. Le champ Appliquer le thème à l'URL du tableau de bord vous permet de sélectionner un thème à ajouter à l'URL d'intégration si vous générez un tableau de bord ou une URL d'intégration Explorer, et si les thèmes personnalisés sont activés sur votre instance. Le thème est appliqué lors de l'affichage du tableau de bord intégré ou de la fonctionnalité Explorer.
  3. Le bouton Inclure les paramètres actuels dans l'URL vous permet d'appliquer ou non les paramètres actuels, tels que les valeurs de filtre, à l'URL d'intégration. Si cette option est activée, ces paramètres sont appliqués lors de l'affichage du contenu intégré.
  4. Cliquez sur le bouton Copier le lien pour copier l'URL d'intégration complète dans le presse-papiers.

Une fois que vous avez généré et copié l'URL d'intégration, vous pouvez la coller dans une nouvelle fenêtre de navigateur ou dans un nouvel onglet pour prévisualiser le contenu intégré. Vous pouvez également utiliser cette URL pour intégrer le contenu dans un iFrame.

Prévisualiser le contenu intégré

Collez l'URL d'intégration dans votre navigateur pour prévisualiser le comportement et l'apparence de votre contenu intégré.

Afficher le contenu intégré dans un iFrame

Placez l'URL d'intégration dans un cadre iFrame. Exemple :

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Intégrez ensuite l'iFrame comme vous le souhaitez.

Modification de l'apparence d'incorporation d'un tableau de bord

Afficher un tableau de bord dont l'URL contient /embed vous montre comment le tableau de bord apparaît lorsqu'il est intégré.

Par défaut, un tableau de bord intégré s'affiche avec le thème par défaut de votre instance Looker. Vous pouvez modifier l'apparence de votre tableau de bord incorporé de plusieurs façons, en fonction du type de tableau de bord que vous utilisez :

  • Quel que soit le type de tableau de bord, vous pouvez modifier le thème utilisé pour afficher le tableau de bord en spécifiant un autre nom de thème dans l'URL d'intégration.
  • Pour n'importe quel type de tableau de bord, vous pouvez utiliser l'argument d'URL _theme pour modifier les différents éléments du thème du tableau de bord.
  • Pour un tableau de bord LookML, vous pouvez également modifier l'apparence intégrée d'un tableau de bord via le paramètre embed_style.

Avec l'argument d'URL theme, l'option Modifier les paramètres d'intégration ou le paramètre embed_style ne modifie que le tableau de bord auquel l'argument, l'option ou le paramètre est appliqué. Si vous souhaitez personnaliser l'apparence de plusieurs tableaux de bord intégrés, utilisez plutôt un thème.

Certains paramètres d'affichage en remplacent d'autres. Pour en savoir plus, consultez la page de documentation Créer et appliquer des thèmes pour les tableaux de bord intégrés et les explorations.

Activation de l'écran de connexion pour les incorporations privées

Vous pouvez ajouter le paramètre allow_login_screen=true à votre URL d'intégration si vous souhaitez présenter un écran de connexion aux utilisateurs qui ne se sont pas encore connectés. Exemple :

<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Si vous n'ajoutez pas ce paramètre, une erreur 401 s'affichera aux utilisateurs qui ne sont pas encore connectés.