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 demander à un utilisateur de s'authentifier à l'aide d'une connexion Looker, de Google OAuth ou d'OpenID Connect. Lorsqu'un utilisateur n'est pas authentifié, vous avez la possibilité d'afficher un message d'erreur ou 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 Admin, 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'incorporation personnalisable ou plus avancée, consultez notre page de documentation sur l'incorporation 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 d'exploration, sélectionnez Obtenir l'URL d'intégration dans le menu à trois points d'un tableau de bord ou dans le menu en forme de roue dentée d'action d'exploration sur une exploration ou une présentation.

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

  1. Le champ URL du contenu affiche l'URL d'intégration privée complète.
  2. Le champ Appliquer un 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 une URL d'intégration de tableau de bord ou d'Exploration et que les thèmes personnalisés sont activés dans votre instance. Le thème sera appliqué lorsque le tableau de bord ou l'exploration intégrés seront consultés.
  3. Le bouton Inclure les paramètres actuels dans l'URL vous permet de choisir si vous souhaitez appliquer 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 votre 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 iFrame. Exemple :

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

Incorporez ensuite l'iFrame comme vous le souhaitez.

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

L'affichage d'un tableau de bord avec /embed dans l'URL vous montre comment il s'affiche 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 :

  • Pour tout type de tableau de bord, vous pouvez spécifier un nom de thème différent dans l'URL d'intégration pour modifier 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 de thème de tableau de bord spécifiques.
  • 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'utilisation de l'argument d'URL theme, de l'option Modifier les paramètres d'intégration ou du 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 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.