Paramètres d'administration – Intégration

Remarque : Si vous utilisez une instance Looker (Google Cloud Core), cette page ne s'affiche que si vous utilisez l'édition Embed de Looker (Google Cloud Core).

La page Embed de la section Platform (Plate-forme) du menu Admin (Admin) vous permet de configurer les paramètres du contenu Looker intégré.

Remarque : Si vous disposez d'une autorisation qui vous permet d'accéder uniquement à certaines pages du panneau d'administration, comme manage_schedules, manage_themes ou see_admin, mais que vous ne disposez pas du rôle d'administrateur, il est possible que la ou les pages décrites ici ne soient pas visibles dans le panneau d'administration.

Liste d'autorisation de domaines intégrés

Vous devez utiliser ce paramètre pour utiliser des événements JavaScript afin de transmettre des données ou des actions entre une page parente et un iFrame Looker.

Dans ce cas, ajoutez le domaine dans lequel l'iFrame est utilisé dans ce champ, puis sélectionnez Update (Mettre à jour).

Important : N'incluez pas de barre oblique (/) à la fin de l'URL du domaine.

Protections de même origine pour les pages de connexion Looker

Pour la page de connexion Looker, vous pouvez utiliser le paramètre Same-Origin Protections for Looker Login Pages (Protections de même origine pour les pages de connexion Looker) pour indiquer si vous souhaitez autoriser ou non l'intégration multi-domaine :

• Disabled (Désactivé) : Looker autorise l'intégration multi-domaine.
• Enabled (Activé) : Looker n'autorise pas l'intégration multi-domaine.

Dans certains cas d'utilisation, vous devez autoriser l'affichage des pages de connexion Looker dans un iFrame Looker, même lorsque la page parente n'est pas compatible avec le nom de domaine de l'instance Looker. Dans ce cas, vous devez définir l'option Same-Origin Protections for Looker Login Pages (Protections de même origine pour les pages de connexion Looker) sur Disabled (Désactivé) :

• Si vous utilisez l'intégration privée de contenu Looker dans un iFrame d'une page Web hébergée par un domaine non Looker, vous devez désactiver l'option Same-Origin Protections for Looker Login Pages (Protections de même origine pour les pages de connexion Looker) afin que Looker puisse afficher la page de connexion dans l'iFrame et permettre aux utilisateurs de se connecter à Looker.

Définissez Same-Origin Protections for Looker Login Pages (Protections de même origine pour les pages de connexion Looker) sur Enabled (Activé) si l'une des conditions suivantes est remplie :

• Vous n'intégrez aucun contenu Looker.
• Vous n'utilisez que l'intégration signée, car la page de connexion Looker n'est pas utilisée pour les intégrations signées.

Pour modifier le paramètre de protection de même origine, utilisez le menu déroulant pour sélectionner l'option de votre choix, puis cliquez sur le bouton Update (Mettre à jour) pour enregistrer votre sélection.

Intégrer l'authentification SSO

La fonctionnalité Embed SSO Authentication (Intégrer l'authentification SSO) doit être activée si vous souhaitez utiliser la fonctionnalité d'intégration signée de Looker. Pour ce faire, sélectionnez Enabled (Activé), puis Update (Mettre à jour).

URL personnalisée pour les alertes et la programmation

Sauf si elle est désactivée, les livraisons par e-mail à partir de tableaux de bord intégrés, qu'il s'agisse d'alertes ou de livraisons programmées, incluent un lien indiquant View full dashboard (Afficher le tableau de bord complet). Ce lien permet aux destinataires de l'e-mail de se connecter à leur instance Looker et d'explorer plus en détail les données fournies dans l'e-mail.

L'option Alerts and scheduling custom url (URL personnalisée pour les alertes et la programmation) vous permet de configurer une URL personnalisée dans les alertes et les livraisons d'e-mails programmées qui redirigeront les utilisateurs intégrés vers l'application d'intégration, plutôt que vers une instance Looker.

Remarque : L'application d'intégration est responsable de l'authentification et de la validation de tout utilisateur qui clique sur le lien pour revenir à une URL personnalisée.

Intégrer le domaine pour la liste d'autorisation des programmations et des alertes

Spécifiez tous les domaines vers lesquels les URL personnalisées des livraisons par e-mail peuvent rediriger. Les domaines listés ici rempliront le champ Domain (Domaine) dans les boîtes de dialogue de programmation et d'alertes.

Si ce champ est laissé vide, les liens personnalisés ne sont pas disponibles, car aucun domaine ne sera disponible pour l'utilisateur dans la boîte de dialogue de programmation ou d'alertes.

Sélectionner le chemin d'accès au contenu

Ce menu déroulant vous permet de sélectionner le format de l'URL dans le lien personnalisé. Il comporte les options suivantes :

• Only embed domain (Domaine intégré uniquement) : l'URL du lien personnalisé n'inclut que le domaine sélectionné dans le champ Domain (Domaine) de la boîte de dialogue de programmation ou d'alertes. Exemple : app.customer.com.

• User defined url (URL définie par l'utilisateur) : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domain (Domaine) de la boîte de dialogue de programmation ou d'alertes, ainsi que le chemin d'accès saisi par l'utilisateur dans le champ Path (Chemin) de la boîte de dialogue de programmation ou d'alertes. Exemple : app.customer.com/my_embed_app.

• Embed domain URL with Looker IDs (Intégrer l'URL de domaine avec les ID Looker) : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domain (Domaine) de la boîte de dialogue de programmation ou d'alertes, ainsi que le chemin d'accès Looker au tableau de bord intégré, à l'aide de l'ID de contenu. Exemple : app.customer.com/dashboards/12.

  Remarque : Les instances pour lesquelles une fonctionnalité de licence spécifique est activée ajoutent le chemin d'accès Looker à l'aide du slug du tableau de bord, même lorsque cette option est sélectionnée. Si cela se produit et que vous souhaitez utiliser l'ID du tableau de bord dans l'URL du lien personnalisé, ouvrez une demande d'assistance.

• Embed domain URL with Looker slugs (Intégrer l'URL de domaine avec les slugs Looker) : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domain (Domaine) de la boîte de dialogue de programmation ou d'alertes, ainsi que le chemin d'accès Looker au tableau de bord intégré, à l'aide du slug de contenu. Exemple : app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

  Remarque : Le slug est une courte chaîne de caractères choisie de manière aléatoire qui est utilisée comme alternative à la valeur de l’ID de contenu dans les URL. Dans l’exemple précédent, CQ1fu99Z9Y1ggq2wcHDfMm est le slug du tableau de bord. Pour afficher le slug d'un tableau de bord, sélectionnez Get link (Obtenir le lien) dans le menu à trois points du tableau de bord.

L'option Select content path (Sélectionner le chemin d'accès au contenu) n'est pas disponible si le champ Embed domain for schedules and alerts allowlist (Intégrer le domaine pour la liste d'autorisation des programmations et des alertes) est laissé vide.

Libellé pour l'URL

Utilisez ce champ pour saisir un nouveau texte de lien par défaut, qui remplacera le texte View full dashboard (Afficher le tableau de bord complet) dans les livraisons par e-mail. Le texte par défaut peut être modifié dans les boîtes de dialogue de programmation et d'alertes.

Afficher les filtres sur les Looks intégrés

Définissez cette option sur Enabled (Activé) si vous souhaitez afficher les valeurs de filtre dans les Looks intégrés.

Définissez cette option sur Disabled (Désactivé) pour masquer les valeurs de filtre dans les Looks intégrés.

Sélectionnez Update (Mettre à jour) pour enregistrer votre paramètre.

Supprimer la navigation Look

La fonctionnalité Remove Look Navigation (Supprimer la navigation Look) permet aux administrateurs de personnaliser davantage le contenu intégré, en particulier les explorations intégrées et les tableaux de bord intégrés.

Supprimer la navigation Look des explorations intégrées

Par défaut, les utilisateurs intégrés disposant des explore et save_content autorisations voient les options suivantes dans le menu en forme d'engrenage**Explore Actions** d'une exploration intégrée :

• L'option Save as a Look (Enregistrer en tant que Look)
• L'option Save & Schedule (Enregistrer et programmer) (pour les utilisateurs intégrés disposant des autorisations d'envoi ou de programmation permissions)

Lorsque la fonctionnalité Remove Look Navigation (Supprimer la navigation Look) est définie sur Enabled (Activé), elle supprime toutes les références aux Looks, y compris les options Save as a Look (Enregistrer en tant que Look) et Save & Schedule (Enregistrer et programmer), du menu en forme d'engrenage Explore Actions (Actions d'exploration) de l'exploration intégrée.

Laissez l'option définie sur Disabled (Désactivé) pour conserver les références aux Looks et les options Save as a Look (Enregistrer en tant que Look) et Save &Schedule (Enregistrer et programmer) dans les explorations intégrées.

Supprimer la navigation Look des tableaux de bord intégrés

Lorsque l'option Remove Look Navigation (Supprimer la navigation Look) est définie sur Enabled (Activé), les références et les options de navigation vers les Looks à partir des explorations intégrées et des vignettes de tableau de bord liées à un Look sont supprimées.

Lorsque l'option Remove Look Navigation (Supprimer la navigation Look) est définie sur Disabled (Désactivé), les utilisateurs intégrés ont la possibilité de sélectionner View Look (Afficher le Look) dans le menu à trois points Tile actions (Actions de la vignette) des vignettes liées à un Look.

Navigation dans le contenu des tableaux de bord intégrés

Lorsque cette option est activée, les utilisateurs de tableaux de bord intégrés qui disposent des autorisations nécessaires peuvent afficher les dossiers, ainsi que les Looks et les tableaux de bord qu'ils contiennent à partir des tableaux de bord intégrés. L'activation de cette fonctionnalité est requise pour permettre aux utilisateurs de tableaux de bord intégrés de copier, de déplacer et de supprimer des tableaux de bord.

Gestion du contenu intégré

Lorsque cette option est activée, les utilisateurs de tableaux de bord intégrés qui disposent des autorisations nécessaires peuvent copier, déplacer et supprimer des tableaux de bord.

Intégration sans cookie

À partir de Looker 23.8, le domaine d'intégration peut être inclus lors de l'acquisition de la session sans cookie. Il s'agit d'une alternative à l'ajout du domaine d'intégration à l'aide du panneau Admin > Embed (Admin > Intégrer) de Looker. Looker enregistre le domaine d'intégration dans la base de données interne de Looker. Il ne s'affiche donc pas sur la page Embed (Intégrer) du panneau Admin (Admin). Au lieu de cela, le domaine d'intégration est associé à la session sans cookie et n'existe que pendant la durée de la session. Consultez les bonnes pratiques relatives à la sécurité si vous décidez de profiter de cette fonctionnalité.

Important : le paramètre Sessions persistantes du panneau Admin > Authentication > Sessions doit également être activé pour utiliser l'intégration sans cookie.

Intégrer le secret JWT

Remarque : Ce paramètre s'affiche lorsque l'option Embed SSO Authentication (Intégrer l'authentification SSO) est définie sur Enabled (Activé) et que l'option Cookieless Embed (Intégration sans cookie) est activée.

Un secret JWT (JSON Web Token) est requis pour utiliser la fonctionnalité d'intégration sans cookie. L'intégration sans cookie nécessite que l'option Embed SSO Authentication (Intégrer l'authentification SSO) soit activée, mais elle utilise Embed JWT Secret (Intégrer le secret JWT) au lieu de Embed Secret (Intégrer le secret).

Cette option vous permet de définir ou de réinitialiser le secret JWT intégré. Il n'est pas nécessaire de définir le secret JWT, car la toute première tentative de création d'une session d'intégration sans cookie créera le jeton JWT. Contrairement au secret d'intégration, le secret JWT intégré n'est jamais exposé, car il n'est utilisé qu'en interne par le serveur Looker.

La réinitialisation du jeton JWT invalide toutes les sessions d'intégration sans cookie actives.

Intégrer le secret

Remarque : Ce paramètre ne s’affiche que si l’option Embed SSO Authentication (Intégrer l’authentification SSO) est définie sur Enabled (Activé).

Un secret d'intégration est nécessaire pour utiliser la fonctionnalité d'intégration signée de Looker.

Pour récupérer le secret d'intégration, sélectionnez le bouton Set Secret (Définir le secret).

Remarque : Il est important de copier le secret et de l’enregistrer immédiatement dans un endroit sûr, car vous ne pourrez pas le récupérer sur cette page après l’avoir quittée.

Pour modifier votre secret, sélectionnez le bouton Reset Secret (Réinitialiser le secret). Sachez toutefois que cela interrompra toutes les intégrations signées existantes.

Valideur d'URI d'intégration

Remarque : Ce paramètre ne s'affiche que si le Embed Secret (Secret d'intégration) a été défini.

Après avoir généré une URL pour la fonctionnalité d'intégration signée de Looker, vous pouvez la tester en la collant dans le champ Embed URI Validator (Valideur d'URI d'intégration), puis en cliquant sur Test URI (Tester l'URI). Le valideur d'URI renvoie un message indiquant si l'URL d'intégration signée est valide.

Une fois que vous avez saisi une URL d'intégration signée, la section Embed URI quick check (Vérification rapide de l'URI d'intégration) affiche les paramètres et les valeurs inclus dans l'URL d'intégration signée.