Incorporation privée

En plus de l'intégration publique, vous pouvez également intégrer des Looks, 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 pouvez afficher un message d'erreur ou afficher un écran de connexion.

Les utilisateurs qui sont connectés et accèdent à un contenu intégré de manière privée sont soumis aux paramètres définis dans le panneau Sessions Admin qui déterminent la durée pendant laquelle ils peuvent rester connectés après une période d'activité, s'ils peuvent rester connectés et s'ils peuvent se déconnecter après une période d'activité.

Si vous avez besoin d'une solution intégrée 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 d'exploration, sélectionnez Obtenir une URL d'intégration dans le menu à trois points du tableau de bord, ou depuis le menu en forme de roue dentée d'exploration d'une exploration dans une exploration ou un Look.

L'écran Intégration privée comprend les éléments suivants:

  1. Le champ URL de contenu indique 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 une URL d'ingestion de tableau de bord ou d'exploration et que les thèmes personnalisés sont activés sur votre instance. Le thème sera appliqué lors de l'affichage du tableau de bord intégré ou de l'exploration.
  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 seront appliqués lors de l'affichage du contenu intégré.
  4. Sélectionnez le bouton Copy Link (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é.

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>

Intégrez 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 dont l'URL contient /embed vous permet de voir à quoi ressemblera le tableau de bord une fois intégré.

Par défaut, un tableau de bord intégré s'affiche selon 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 chaque 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.
  • Quel que soit le type de tableau de bord, vous pouvez utiliser l'argument d'URL _theme pour modifier des éléments de thème individuels.
  • 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.

L'argument d'URL theme, l'option Edit Embed Settings (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 sont appliqués. 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 intégrée si vous souhaitez présenter un écran de connexion aux utilisateurs qui ne se sont pas déjà 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.