La page Intégrer de la section Plate-forme du menu Administration 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 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 à ce champ le domaine où l'iFrame est utilisé, puis sélectionnez Update (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-origine:
- Désactivé: Looker autorise l'intégration multi-origine.
- Activé: Looker n'autorise pas l'intégration multi-origine.
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, l'option Protections de même origine pour les pages de connexion Looker doit être définie sur Désactivée:
- Si vous utilisez l'intégration privée du contenu Looker dans l'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 afin que Looker puisse afficher la page de connexion dans l'iFrame et permettre aux utilisateurs de se connecter à Looker.
Définissez l'option Protections de même origine pour les pages de connexion Looker sur Activé dans les cas suivants:
- Vous n'intégrez aucun contenu Looker.
- Vous n'utilisez que des intégrations signées, car la page de connexion de Looker n'est pas utilisée pour les intégrations signées.
Pour modifier le paramètre de la protection de la même origine, sélectionnez l'option de votre choix dans le menu déroulant, puis n'oubliez pas de sélectionner le bouton Mettre à jour pour enregistrer votre sélection.
Authentification SSO intégrée
La fonctionnalité Authentification SSO intégrée doit être activée si vous souhaitez utiliser la fonctionnalité d'intégration signée de Looker. Pour ce faire, sélectionnez Activé, puis Mettre à jour.
URL personnalisée pour les alertes et la programmation
À moins qu'ils soient désactivés, les envois par e-mail des tableaux de bord intégrés, à partir d'alertes ou de envois planifiés, incluent un lien 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 Alertes et planification d'URL personnalisée vous permet de configurer une URL personnalisée dans les alertes et les envois d'e-mails programmés qui associent les utilisateurs intégrés à l'application d'intégration plutôt qu'à 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 envois d'e-mails peuvent renvoyer. Les domaines listés ici sont renseignés dans le champ Domaine des boîtes de dialogue de planification et d'alerte.
Si vous ne renseignez pas ce champ, les liens personnalisés ne sont pas disponibles, car l'utilisateur ne peut sélectionner aucun domaine dans la boîte de dialogue de planification ou d'alertes.
Sélectionner le chemin d'accès au contenu
Cette liste déroulante vous permet de sélectionner la mise en forme de l'URL du lien personnalisé. Il propose les options suivantes:
Intégrer uniquement le domaine : 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. Exemple :
app.customer.comURL 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.Intégrer l'URL de domaine avec les ID Looker : l'URL du lien personnalisé inclura 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 Looker au tableau de bord intégré, à l'aide de Content ID. Exemple :
app.customer.com/dashboards/12Inté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 d'accès Looker au tableau de bord intégré, à l'aide du slug de contenu. 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 planifications et des alertes est 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 par e-mail. Le texte par défaut peut être modifié dans les boîtes de dialogue de planification et d'alerte.
Afficher les filtres sur les Looks intégrés
Définissez cette option sur Activé si vous souhaitez afficher les valeurs de filtre dans des 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 le paramètre.
Supprimer la navigation de Look
La fonctionnalité Supprimer la navigation dans les Looks permet aux administrateurs de personnaliser davantage le contenu intégré, en particulier les explorations et les tableaux de bord intégrés.
Suppression de la navigation de présentation des explorations intégrées
Par défaut, les utilisateurs de l'intégration qui disposent des autorisations explore et save_content verront les options suivantes dans le menu en forme de roue dentée des Actions d'exploration d'une exploration intégrée:
- L'option Enregistrer en tant que Look
- Option Enregistrer et planifier (pour les utilisateurs d'intégration qui disposent des autorisations d'envoi ou de planification)
Lorsqu'elle est activée, la fonctionnalité Supprimer la navigation de Look supprime toutes les références aux Looks, y compris les options Enregistrer en tant que présentation 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 présentation et Enregistrer et planifier dans les explorations intégrées.
Suppression de la navigation de présentation des tableaux de bord intégrés
Lorsque l'option Supprimer la navigation de Look est activée, les références et options de navigation vers les Looks provenant d'explorations intégrées et les vignettes de tableau de bord liées à une présentation sont supprimées.
Lorsque l'option Supprimer la navigation du Look est désactivée, les utilisateurs d'intégrations ont l'option Afficher le Look dans le menu à trois points Actions des vignettes des vignettes liées à une présentation.
Navigation dans le contenu intégré au tableau de bord
Lorsque cette option est activée, les lecteurs de tableaux de bord intégrés qui ont reçu les 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.
Intégrer la gestion de contenu
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 la version 23.8 de Looker, le domaine intégré peut être inclus lorsque la session sans cookie est acquise. Il s'agit d'une alternative à l'ajout du domaine d'intégration via le panneau Admin > Intégrer de Looker. Looker enregistre le domaine intégré dans la base de données interne de Looker. Il n'apparaît donc pas sur la page Intégrer du panneau Administration. Au lieu de cela, le domaine intégré est associé à la session sans cookie et n'existe que pendant la durée de la session. Consultez les bonnes pratiques de sécurité si vous décidez d'utiliser cette fonctionnalité.
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 l'activation de l'authentification SSO intégrée, mais l'intégration sans cookie 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 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 génère le jeton JWT. Contrairement au secret d'intégration, le secret JWT d'incorporation n'est jamais exposé, car il est utilisé uniquement en interne par le serveur Looker.
La réinitialisation du jeton JWT invalidera toutes les sessions d'intégration sans cookie actives.
Intégrer le 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 code secret de l'intégration, sélectionnez le bouton Définir le secret.
Pour modifier votre code secret, sélectionnez le bouton Réinitialiser le secret. Sachez toutefois que cela endommagera les intégrations signées existantes.
Outil de validation d'URI intégré
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, puis en cliquant sur Test URI (Tester l'URI). Le programme de validation 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.