Incorporation privée

En plus de l'intégration publique, vous pouvez également intégrer des présentations, des explorations et des tableaux de bord en privé. Avec l'intégration privée, vous pouvez exiger qu'un utilisateur s'authentifie à l'aide d'un identifiant Looker, Google OAuth ou OpenID Connect. Si un utilisateur n'est pas authentifié, vous avez la possibilité d'afficher un message d'erreur ou d'afficher un écran de connexion.

Les utilisateurs connectés et accédant à du contenu intégré en privé sont soumis aux paramètres du panneau Sessions Administration, qui déterminent la durée pendant laquelle ils peuvent rester connectés, s'ils peuvent se connecter à partir de plusieurs navigateurs et s'ils seront déconnectés après une période d'inactivité.

Si vous avez besoin d'une solution d'intégration plus avancée ou personnalisable, consultez notre page de documentation sur l'intégration signée.

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, une présentation ou une visualisation de l'exploration, sélectionnez Obtenir l'URL d'ingestion dans le menu à trois points d'un tableau de bord, ou dans le menu Outils d'action d'exploration d'une exploration ou d'une présentation.

L'écran Private Embed (Intégration privée) contient les éléments suivants :

  1. Le champ URL de contenu 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 que des thèmes personnalisés sont activés pour votre instance. Le thème est appliqué lorsque le tableau de bord ou l'exploration intégrés sont affichés.
  3. Le bouton bascule Inclure les paramètres actuels dans l'URL vous permet de choisir 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 s'appliquent lorsque le contenu intégré est consulté.
  4. Sélectionnez 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 ou un nouvel onglet de navigateur 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é.

Affichage du contenu intégré dans un iFrame

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

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

puis intégrez l'iFrame comme vous le souhaitez.

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

L'affichage d'un tableau de bord dont l'URL contient /embed vous montre comment le tableau de bord apparaîtra lorsqu'il sera 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 :

  • Vous pouvez indiquer un nom de thème différent dans l'URL d'intégration pour tout type de tableau de bord afin de changer le thème utilisé pour afficher le tableau de bord.
  • Pour tout type de tableau de bord, vous pouvez utiliser l'argument d'URL _theme pour modifier des éléments individuels 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 à l'aide du paramètre embed_style.

L'argument d'URL theme, l'option Modifier les paramètres d'intégration ou le paramètre embed_style ne modifient 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 et les explorations intégrés.

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

Vous pouvez ajouter le paramètre allow_login_screen=true à votre URL d'incorporation si vous souhaitez afficher un écran de connexion aux utilisateurs qui ne 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.