La page Intégrer de la section Plate-forme du menu Admin vous permet de configurer les paramètres du contenu Looker intégré.
Liste d'autorisation des domaines intégrés
Vous devez utiliser ce paramètre pour exploiter les é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 où l'iframe est utilisé dans ce champ, puis sélectionnez Mettre à jour.
Protections de même origine pour les pages de connexion Looker
Pour la page de connexion Looker, vous pouvez utiliser le paramètre Protections de même origine pour les pages de connexion Looker pour indiquer si vous souhaitez autoriser ou non l'intégration multi-origines :
- Désactivé : Looker autorise l'intégration multi-origines.
- 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 si 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 Protections de même origine pour les pages de connexion Looker sur 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 autre que Looker, vous devez désactiver les protections de même origine pour les pages de connexion Looker. Cela permettra à Looker d'afficher la page de connexion dans l'iFrame et aux utilisateurs de se connecter à Looker.
Définissez Protections de même origine pour les pages de connexion Looker sur 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 veillez à sélectionner le bouton Mettre à jour pour enregistrer votre sélection.
Intégrer l'authentification SSO
La fonctionnalité Authentification SSO incorporée doit être activée si vous souhaitez utiliser la fonctionnalité Incorporation signée de Looker. Pour ce faire, sélectionnez Activé, puis Mettre à jour.
URL personnalisée pour les alertes et la programmation
Sauf si elle est désactivée, les livraisons d'e-mails à partir de tableaux de bord intégrés, qu'il s'agisse d'alertes ou de livraisons programmées, incluent un lien intitulé 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 URL personnalisée pour les alertes et la programmation vous permet de configurer une URL personnalisée dans les alertes et les e-mails programmés. Cette URL redirige les utilisateurs intégrés vers l'application d'intégration, et non vers une instance Looker.
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 dans les e-mails peuvent rediriger. Les domaines listés ici rempliront le champ 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 proposé à 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 propose les options suivantes :
Intégrer le domaine uniquement : l'URL du lien personnalisé n'inclut que le domaine sélectionné dans le champ Domaine de la boîte de dialogue de planification ou d'alertes. Par exemple,
app.customer.com
.URL définie par l'utilisateur : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domaine de la boîte de dialogue de planification ou d'alertes, ainsi que le chemin d'accès saisi par l'utilisateur dans le champ Chemin d'accès de la boîte de dialogue de planification ou d'alertes. Par exemple,
app.customer.com/my_embed_app
.URL de domaine à intégrer avec les ID Looker : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domaine de la boîte de dialogue de planification ou d'alerte, ainsi que le chemin Looker vers le tableau de bord intégré, à l'aide de l'ID de contenu. Par exemple,
app.customer.com/dashboards/12
.Intégrer l'URL de domaine avec les slugs Looker : l'URL du lien personnalisé inclut le domaine sélectionné dans le champ Domaine de la boîte de dialogue de planification ou d'alertes, ainsi que le chemin Looker vers le tableau de bord intégré, à l'aide du slug de contenu. Par exemple,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm
.
L'option Sélectionner le chemin d'accès au contenu n'est pas disponible si le champ 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 Afficher le tableau de bord complet dans les envois d'e-mails. 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 Activé si vous souhaitez afficher les valeurs de filtre dans les Looks intégrés.
Définissez cette option sur Désactivé pour masquer les valeurs de filtre dans les Looks intégrés.
Sélectionnez Mettre à jour pour enregistrer votre paramètre.
Supprimer la navigation Look
La fonctionnalité Supprimer la navigation dans les looks permet aux administrateurs de personnaliser davantage le contenu intégré, en particulier les Explores intégrés 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 autorisations explore
et save_content
verront les options suivantes dans le menu en forme de roue dentée Actions d'exploration d'une exploration intégrée :
- L'option Enregistrer en tant que présentation
- L'option Enregistrer et programmer (pour les utilisateurs d'intégrations disposant des autorisations d'envoi ou de programmation)
Lorsque l'option Supprimer la navigation dans les Looks est définie sur Activé, elle supprime toutes les références aux Looks, y compris les options Enregistrer en tant que Look et Enregistrer et planifier, du menu en forme de roue dentée Actions d'exploration de l'exploration intégrée.
Laissez l'option définie sur Désactivé pour conserver les références aux Looks et aux options Enregistrer en tant que Look et Enregistrer et planifier dans les Explorations intégrées.
Supprimer la navigation Look des tableaux de bord intégrés
Lorsque l'option Supprimer la navigation dans les Looks est activée, 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 aux Looks intégrées sont supprimées.
Lorsque l'option Supprimer la navigation dans les looks est désactivée, les utilisateurs intégrés peuvent afficher le look dans le menu à trois points Actions sur les tuiles des tuiles associées à un look.
Navigation dans le contenu des tableaux de bord intégrés
Lorsque cette option est activée, les lecteurs 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. Vous devez activer cette fonctionnalité pour permettre aux lecteurs de tableaux de bord intégrés de copier, déplacer et supprimer des tableaux de bord.
Gestion de contenu intégré
Lorsque cette option est activée, les lecteurs 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 > 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 Intégrer du panneau Admin. Le domaine d'intégration est associé à la session sans cookie et n'existe que pendant la durée de la session. Si vous décidez d'utiliser cette fonctionnalité, consultez les bonnes pratiques de sécurité.
Intégrer le secret JWT
Un secret de jeton Web JSON (JWT) est requis pour utiliser la fonctionnalité d'intégration sans cookie. L'intégration sans cookie nécessite que l'authentification SSO pour l'intégration soit activée, mais elle utilise Secret JWT pour l'intégration au lieu de Secret pour l'intégration.
Cette option vous permet de définir ou de réinitialiser le secret JWT d'intégration. 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 d'intégration n'est jamais exposé, car il n'est utilisé qu'en interne par le serveur Looker.
La réinitialisation du jeton JWT invalidera toutes les sessions d'intégration sans cookie actives.
Intégrer un secret
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 Définir le secret.
Pour modifier votre secret, sélectionnez le bouton Réinitialiser le secret. Sachez que cela interrompra tous les intégrations signées existantes.
Validateur d'URI d'intégration
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 Validateur d'URI d'intégration, puis en cliquant sur Tester l'URI. Le validateur 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 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.