Vous consultez la documentation de Looker 22.16. Pour accéder à la documentation la plus récente, cliquez ici.

Incorporation privée

En plus de l'intégration publique, vous pouvez intégrer des looks, des explorations et des tableaux de bord en mode privé. Vous devez donc vous authentifier à l'aide d'une connexion Looker, de Google OAuth ou de 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 au contenu intégré privé sont soumis aux paramètres du panneau Sessions Admin. Ils déterminent pendant combien de temps ils peuvent rester connectés, s'ils peuvent se connecter à partir de plusieurs navigateurs et s'ils sont 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).

Le contenu intégré reflète toujours la version de production du contenu. Les modifications effectuées en mode Développement qui affectent le contenu et qui n'ont pas été déployées en production n'apparaîtront pas dans une intégration.

Incorporation d'un Look

Pour intégrer une visualisation de Look, procédez comme suit:

Ouvrez une présentation enregistrée.
Copiez l'URL.
Dans l'URL, remplacez /looks/ par /embed/looks/. Par exemple, cette expression :
```
https://instance_name.looker.com/looks/4
```
doit être modifiée par :
```
https://instance_name.looker.com/embed/looks/4
```

Placez votre nouvelle URL dans un iFrame. Exemple :

  <iframe
      src="https://instance_name.looker.com/embed/looks/4"
      width="600"
      height="300"
      frameborder="0">
  </iframe>

Incorporez l'iFrame tel que vous le souhaitez.

Incorporation d'une exploration

Pour intégrer une visualisation de l'onglet "Explorer" :

Choisissez Explorer à partir d'ici à partir d'un look enregistré, ou accédez à la page Explorer et créez la visualisation souhaitée.
Copiez l'URL de la page Explore. Si vous souhaitez modifier ou ajouter des paramètres d'URL, sélectionnez Partager dans le menu représenté par une roue dentée en haut à droite, puis copiez l'URL étendue.

Dans l'URL, remplacez /explore/ par /embed/explore/. Par exemple, cette expression :

https://instance_name.looker.com/explore/my_model/my_explore?...

doit être modifiée par :

https://instance_name.looker.com/embed/explore/my_model/my_explore?...

Placez votre nouvelle URL dans un iFrame. Exemple :

  <iframe
      src="https://instance_name.looker.com/embed/explore/my_model/my_explore?..."
      width="1000"
      height="1000"
      frameborder="0">
  </iframe>

Incorporez l'iFrame tel que vous le souhaitez.

Incorporation d'un tableau de bord

Pour incorporer une présentation, procédez comme suit :

Ouvrez un tableau de bord enregistré.
Copiez l'URL.
Pour un tableau de bord utilisant la nouvelle interface de tableau de bord, remplacez /dashboards/ par /embed/dashboards/ dans l'URL. Pour un ancien tableau de bord, remplacez /dashboards-legacy/ par /embed/dashboards-legacy/ dans l'URL. Par exemple, cette expression :
```
https://instance_name.looker.com/dashboards/1
```
doit être modifiée par :
```
https://instance_name.looker.com/embed/dashboards/1
```

Placez votre nouvelle URL dans un iFrame. Exemple :

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

Incorporez l'iFrame tel que 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 indique comment le tableau de bord apparaîtra lorsqu'il sera intégré. Pour un ancien tableau de bord, vous pouvez également sélectionner Prévisualiser le tableau de bord dans le menu représenté par une roue dentée pour voir comment votre tableau de bord apparaîtra lorsqu'il sera intégré.

Par défaut, un tableau de bord intégré s'affiche à l'aide du 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 indiquer un nom de thème différent dans l'URL d'intégration afin de modifier le thème utilisé.
Quel que soit le type de tableau de bord, vous pouvez utiliser l'argument d'URL _theme pour modifier les éléments d'un thème de tableau de bord.
Pour un ancien tableau de bord, vous pouvez également modifier l'apparence intégrée d'un tableau de bord à l'aide de l'option Modifier les paramètres d'intégration du menu représenté par une roue dentée.
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 Créer et appliquer des thèmes pour les tableaux de bord intégrés et les explorations.

Paramètres d'incorporation du tableau de bord hérité

Les paramètres d'intégration d'un ancien tableau de bord seront remplacés par tout autre thème par défaut spécifié dans l'URL d'intégration du tableau de bord ou par tous les éléments de thème spécifiés dans l'URL.

Pour configurer l'affichage d'un ancien tableau de bord lorsqu'il est intégré:

Cliquez sur le menu représenté par une roue dentée, puis sélectionnez Modifier les paramètres d'intégration. Le volet des paramètres d'intégration s'ouvre :
Choisissez d'afficher ou de masquer le titre ou les filtres du tableau de bord.
Cliquez sur les cases des couleurs afin d'ajuster la couleur des éléments du tableau de bord.
Vous pouvez également cliquer sur Annuler les modifications pour revenir aux derniers paramètres d'intégration enregistrés pour le tableau de bord. Vous pouvez également cliquer sur Rétablir les paramètres par défaut pour rétablir les paramètres par défaut utilisés pour tous les tableaux de bord intégrés sur votre instance Looker.
Cliquez sur Enregistrer pour enregistrer vos modifications ou sur Annuler pour fermer la fenêtre sans enregistrer les modifications.

Suppression des paramètres d'incorporation d'un tableau de bord hérité

Pour supprimer les paramètres d'incorporation spéciaux d'un tableau de bord hérité :

Cliquez sur le menu représenté par une roue dentée et sélectionnez Modifier les paramètres d'intégration pour ouvrir le volet des paramètres d'intégration.
Cliquez sur Rétablir les valeurs par défaut.
Cliquez sur Enregistrer.

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.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.

L'utilisation de protections de même origine pour vos pages de connexion Looker peut vous empêcher d'activer un écran de connexion pour les intégrations privées.