Paramètres d'administration – Paramètres généraux

La page Paramètres de la section Général du menu Administration vous permet de configurer les paramètres de l'instance pour Looker.

Clé de licence

La clé de licence est propre à l'instance Looker que vous utilisez. Il active ou désactive certaines fonctionnalités de Looker en fonction de votre contrat de licence.

La clé de licence est masquée par défaut. Sélectionnez l'icône en forme d'œil pour afficher la clé de licence.

URL de l'hôte

L'URL hôte est la partie de base de l'URL de votre instance Looker. Il est utilisé spécifiquement lorsque des liens vers votre instance sont créés dans des e-mails programmés et dans toutes les URL absolues générées par Looker.

Assurez-vous que le paramètre URL de l'hôte utilise http:// ou https:// de manière appropriée, selon la configuration du serveur de votre instance.

La modification de l'URL de l'hôte peut affecter le fonctionnement de certaines fonctionnalités de Looker. Consultez la section Que se passe-t-il si l'URL change pour mon instance Looker ? "Bonnes pratiques" pour en savoir plus sur la modification des URL d'instances.

Contacts techniques

Les adresses e-mail ajoutées dans cette zone recevront des notifications concernant les mises à jour de sécurité, les corrections de bugs majeurs et les nouvelles versions de Looker. L'adresse e-mail doit appartenir à un utilisateur Looker valide. Si vous ajoutez une adresse e-mail qui n'appartient pas à un utilisateur Looker valide (par exemple, l'adresse e-mail d'une liste de diffusion), l'adresse e-mail s'affichera dans le champ Contact technique, mais Looker ne pourra pas envoyer de notifications à cette adresse.

L'assistance Looker requiert l'autorisation d'un contact technique pour effectuer l'une des opérations suivantes:

  • Provoquer un temps d'arrêt pour l'instance, qui peut être dû à une mise à jour non planifiée de la version, à une modification des performances de votre serveur Looker ou à d'autres raisons
  • Modifier un élément de votre licence Looker afin d'activer de nouvelles fonctionnalités pour vous

Fuseau horaire de l'application

Lors de l'affichage de données dans une exploration, une présentation ou un tableau de bord, Looker peut convertir les données temporelles du fuseau horaire de la base de données de la connexion dans le fuseau horaire approprié pour cet utilisateur.

Si l'option Fuseaux horaires spécifiques à l'utilisateur est activée, un administrateur peut définir le fuseau horaire par défaut de l'utilisateur ou les utilisateurs peuvent définir leur propre fuseau horaire par défaut. Si l'administrateur ou l'utilisateur n'a pas défini de fuseau horaire par défaut, le fuseau horaire de l'application est utilisé pour cet utilisateur, et toutes les données temporelles interrogées par cet utilisateur sont converties dans le fuseau horaire de l'application.

Le paramètre Fuseau horaire de l'application est également utilisé comme fuseau horaire par défaut pour la diffusion de contenu. Le fuseau horaire utilisé pour les planifications n'affecte pas les données temporelles renvoyées par une requête. Il n'affecte que l'heure d'envoi des données.

Pour en savoir plus, consultez la page de documentation Utiliser les paramètres de fuseau horaire.

Système fermé

Le paramètre système fermé est utilisé conjointement avec des groupes pour empêcher les utilisateurs d'un groupe d'en savoir plus sur les utilisateurs d'un autre groupe. Cela est souvent utile pour les installations mutualisées.

Dans Looker, les emplacements où les utilisateurs peuvent voir d'autres utilisateurs sont les suivants:

Lorsque le paramètre Closed System (Système fermé) est activé, les utilisateurs non administrateurs qui ne disposent pas de l'autorisation see_users ne voient que les autres utilisateurs avec lesquels ils partagent un groupe. De plus, ils ne pourront voir que les groupes dont ils sont membres.

Tous les administrateurs et tous les utilisateurs disposant de l'autorisation see_users peuvent afficher tous les utilisateurs et groupes de l'instance.

Lorsque cette option est activée, la configuration du consentement à la connexion affiche un écran de consentement à tous les utilisateurs qui tentent de se connecter à l'instance Looker. L'écran de consentement affiche le message saisi dans le champ Configuration du message. Les utilisateurs doivent cliquer sur le bouton J'accepte sur l'écran de consentement avant de pouvoir se connecter à l'instance. Une fois que vous avez activé la configuration du consentement à la connexion, le champ Configuration du message devient visible.

Configuration de message

Si l'option Configuration du consentement à la connexion est activée, saisissez le message qui s'affichera pour tous les utilisateurs qui tentent de se connecter à l'instance Looker dans le champ Configuration du message. Ce champ n'est visible qu'une fois que la configuration du consentement à la connexion est activée.

Dossiers personnels privés par défaut

Lorsque l'option Dossiers personnels privés par défaut est activée, le dossier personnel d'un utilisateur n'est visible par défaut que par cet utilisateur et par les administrateurs Looker. Par défaut, les autres utilisateurs ne voient pas ce dossier dans le dossier "Participants", et son contenu n'est pas visible sur les tableaux de bord ni dans les recherches de contenu.

Si vous souhaitez autoriser l'accès à un dossier personnel, vous pouvez accorder l'accès à d'autres utilisateurs ou à des groupes d'utilisateurs via l'option Gérer l'accès du menu en forme de roue dentée du dossier personnel.

Si vous désactivez l'option Dossiers personnels privés par défaut, le dossier personnel d'un utilisateur peut être consulté par n'importe quel utilisateur Looker du groupe Tous les utilisateurs.

Notification de nouveau compte

Le paramètre Notification de nouveau compte peut être activé ou désactivé. Lorsqu'elle est activée, tout administrateur Looker reçoit un e-mail à la création d'un compte Looker. (Les utilisateurs disposant d'une intégration signée sont une exception ; les e-mails ne sont pas générés lorsqu'un utilisateur d'intégration signée est créé.) L'e-mail contiendra l'adresse e-mail du nouvel utilisateur.

Guides intégrés à l'application

Les guides intégrés à l'application permettent à Looker de communiquer avec les utilisateurs de l'application par le biais de tutoriels, de bannières, d'alertes et d'enquêtes. Ces communications sont utilisées pour aider les utilisateurs à exploiter tout le potentiel de la plateforme, les alerter sur les nouvelles fonctionnalités, obtenir les commentaires des utilisateurs sur la plateforme et inviter les utilisateurs à des formations et des événements où ils pourront apprendre à mieux utiliser Looker.

Les administrateurs peuvent choisir de désactiver les guides pour leur instance, ce qui les désactive pour tous les utilisateurs de cette instance. Il n'est pas possible de désactiver de manière sélective les guides intégrés à l'application pour certains utilisateurs. Looker n'affichera pas de guides intégrés à l'application pour les utilisateurs intégrés ou les utilisateurs non administrateurs sur les instances d'étiquettes privées.

Les guides sont conçus et déployés par l'équipe Expérience client de Looker et évolueront au fil du temps. Looker utilise un logiciel tiers JavaScript (Pendo) pour fournir les guides. Looker vérifie les guides individuels et les ajoute à la liste d'autorisation. Lors de la récupération d'un guide depuis Pendo, Looker utilise des hachages d'intégrité SHA-256 pour vérifier que le guide n'a pas changé. Si le guide est modifié après l'examen de Looker, Looker empêche son utilisation. Si le navigateur d'un utilisateur ne parvient pas à se connecter au serveur Pendo, le guide n'est tout simplement pas affiché.

Lorsque ce paramètre est activé, une bannière de notification relative aux cookies s'affiche pour tous les utilisateurs de votre instance. Ce paramètre est désactivé par défaut.

Nous vous recommandons d'activer ce paramètre si vous devez respecter les réglementations de l'Union européenne sur la protection des données.

Lorsque la recherche sélective est activée, les utilisateurs peuvent rechercher du contenu dans les dossiers partagés, leurs dossiers personnels et les tableaux. Le contenu enregistré dans les dossiers personnels d'autres utilisateurs ne sera inclus dans les résultats que s'il est également épinglé à un tableau. Les résultats de recherche excluent tout contenu qui n'existe que dans les dossiers personnels des autres utilisateurs. Les utilisateurs ont la possibilité d'exclure le contenu des dossiers personnels en cliquant sur le bouton situé à côté du nom de la fonctionnalité Recherche sélective dans la fenêtre modale de recherche.

Limiter l'option "Actualiser automatiquement le tableau de bord"

Lorsqu'elle est activée, seuls les administrateurs Looker peuvent activer l'option Actualiser automatiquement le tableau de bord dans les tableaux de bord définis par l'utilisateur. Cela empêche les utilisateurs non administrateurs d'actualiser automatiquement les données des tableaux de bord et des vignettes. L'actualisation automatique des données d'un tableau de bord peut soumettre certains systèmes de base de données à une charge importante.

Numéro de projet Google Cloud

Vous devez indiquer le numéro de projet Google Cloud pour activer l'assistance via l'application. Vous pouvez obtenir cette valeur sur la page de présentation de Cloud dans la console Google Cloud.

La prise en compte de cette modification peut prendre jusqu'à deux heures. Pour implémenter la modification immédiatement, cliquez sur le bouton Mettre à jour à côté du paramètre Clé de licence après avoir saisi votre numéro de projet Google Cloud.

Si vous n'avez pas encore de projet Google Cloud pour Looker, vous pouvez en créer un en suivant notre guide Créer un projet Google Cloud ou notre documentation plus détaillée sur Créer et gérer des projets.

Utiliser Gravatar

Lorsqu'il est activé, ce paramètre affiche l'option Photo de profil dans le menu utilisateur, qui permet aux utilisateurs de sélectionner ou de créer un avatar pour leur compte à l'aide de l'application Gravatar.

Fuseaux horaires spécifiques à l'utilisateur

Lorsque vous ajoutez une connexion, vous devez indiquer le fuseau horaire dans lequel votre base de données stocke les informations temporelles, en tant que Fuseau horaire de la base de données.

Lorsque l'option Fuseau horaire spécifique à l'utilisateur est activée, un fuseau horaire est attribué à chaque utilisateur, et Looker convertit les données temporelles du fuseau horaire de la base de données dans le fuseau horaire de l'utilisateur lorsque celui-ci affiche les résultats de la requête ou interprète les filtres.

Lorsque l'option Fuseau horaire spécifique à l'utilisateur est désactivée, Looker convertit les données temporelles pour tous les utilisateurs en Query Time Zone (Fuseau horaire de la requête).

Pour en savoir plus, consultez la page de documentation Utiliser les paramètres de fuseau horaire.

Couleurs de visualisation par défaut

Le paramètre Couleurs par défaut de la visualisation vous permet de définir une collection de couleurs par défaut pour les visualisations et de créer des collections de couleurs à utiliser dans vos instances.

Définir une collection de couleurs par défaut

Chaque instance Looker doit avoir une collection de couleurs par défaut.

Pour définir une collection de couleurs préexistante comme collection par défaut, choisissez-la dans le menu déroulant, puis cliquez sur Mettre à jour. Remarque: La définition d'une nouvelle collection de couleurs par défaut mettra à jour toutes les visualisations des Looks et des tableaux de bord qui utilisent la collection de couleurs par défaut. Les visualisations enregistrées avec une collection de couleurs différente ou avec une palette personnalisée ne seront pas affectées.

Les premières palettes catégorielles, séquentielles et divergentes de chaque collection s'affichent directement dans le menu déroulant. Ce sont les palettes qui seront utilisées comme paramètres de visualisation par défaut. Pour afficher toutes les palettes de la collection de couleurs, consultez la page de documentation Collections de couleurs.

Créer une collection de couleurs personnalisée

Pour créer une collection de couleurs personnalisée, procédez comme suit:

  1. Sélectionnez la dernière option Nouvelle collection de couleurs dans le menu déroulant de la collection Couleurs de visualisation par défaut.
  2. Attribuez un nom unique à votre nouvelle collection dans la zone de texte Nom.
  3. Cliquez sur chaque palette de couleurs pour ouvrir le menu Couleurs de la palette.
  4. Sélectionnez des couleurs individuelles dans le menu Couleurs de la palette pour les modifier une par une, ou sélectionnez Tout modifier pour modifier toutes les couleurs en même temps.
  5. Répétez les étapes 3 et 4 pour chaque palette de couleurs.
  6. Une fois que vous avez terminé de modifier votre nouvelle collection de couleurs, cliquez sur Créer.

Les valeurs de couleur peuvent prendre la forme de chaînes hexadécimales (par exemple, #2ca6cd) ou de noms de couleurs CSS (par exemple, mediumblue). Vous pouvez également cliquer sur la roue des couleurs pour l'ouvrir et sélectionner une nuance dans le sélecteur de couleurs. Si vous choisissez de modifier toutes les couleurs, séparez-les par une virgule entre les noms. Pour ajouter ou supprimer une couleur, cliquez sur le signe + ou -.

La nouvelle collection deviendra automatiquement la collection par défaut de l'instance, mais vous pouvez en choisir une autre si vous le souhaitez.

Les ID de collection et de palette de toute nouvelle collection de couleurs personnalisée sont basés sur le nom de chaque collection. Cela permet aux tableaux de bord LookML qui utilisent ces collections de s'afficher de manière cohérente entre les instances si les deux instances ont les mêmes collections personnalisées portant un nom identique.

Supprimer une collection de couleurs personnalisée

Pour supprimer une collection de couleurs personnalisée, sélectionnez-la dans le menu déroulant, puis cliquez sur le bouton Supprimer qui s'affiche. Vous ne pouvez pas supprimer les collections de couleurs natives de Looker.

Charger les éléments depuis le CDN

Cette option n'est disponible que pour les instances hébergées par le client. Vous ne pouvez pas désactiver ce paramètre pour ces instances, car les instances hébergées par Looker chargent toujours les éléments à partir du CDN.

CDN est l'abréviation de Content Delivery Network. Un CDN est un réseau de serveurs qui stockent du contenu dans plusieurs emplacements géographiques afin de réduire le temps de chargement des pages pour les utilisateurs. Vos données ne sont jamais stockées sur ces serveurs ; seuls les éléments spécifiques à Looker (tels que les images) sont stockés sur le CDN.

Le paramètre Charger les éléments depuis CDN peut être activé ou désactivé. Lorsqu'il est activé, les pages Looker devraient se charger plus rapidement.

Faire persister les éléments dans le cache du navigateur

Lorsque ce paramètre est activé, les éléments statiques tels que les fichiers et les polices JavaScript sont mis en cache dans l'espace de stockage du navigateur de chaque utilisateur. Cela accélère les navigations ultérieures, car le navigateur n'a pas besoin de continuer à recharger ces éléments à partir du serveur Looker.

Accès des applications mobiles

Lorsque ce paramètre est activé, les utilisateurs peuvent se connecter à leur compte Looker sur l'instance à l'aide de l'application mobile Looker. Lorsqu'il est désactivé, toutes les sessions mobiles existantes sont arrêtées.

Forcer l'authentification mobile

Lorsque ce paramètre est activé, les utilisateurs doivent se connecter à l'application mobile Looker chaque fois qu'ils l'ouvrent sur leur appareil mobile. Les utilisateurs peuvent également activer la connexion biométrique lorsque l'option Forcer l'authentification mobile est activée.

Application de Content Security Policy

Lorsque ce paramètre est activé, les en-têtes CSP (Content Security Policy) conformes aux recommandations strictes de Google sur les CSP sont envoyés et appliqués. Les en-têtes CSP empêchent les scripts tiers de s'exécuter sur Looker et peuvent endommager certaines extensions de navigateur. Pour autoriser l'exécution de scripts tiers dans Looker, désactivez ce paramètre.

Cette option a été ajoutée pour laisser aux développeurs le temps d'ajuster leurs scripts afin de se conformer aux recommandations strictes de CSP. Elle sera supprimée dans une prochaine version de Looker.

URL publiques

Le paramètre URL publique peut être activé ou désactivé. Lorsque ce paramètre est activé, les utilisateurs Looker disposant des autorisations appropriées peuvent générer des URL publiques pour accéder aux données Looker.

Liste d'autorisation de domaines de messagerie pour les contenus programmés

Ce paramètre permet aux administrateurs Looker de définir les domaines de messagerie auxquels vos utilisateurs peuvent diffuser du contenu Looker (Looks, tableaux de bord, requêtes avec visualisations) ou notifications d'alerte par e-mail.

Pour limiter la diffusion de contenu et les notifications d'alerte aux adresses e-mail d'un domaine spécifique, vous pouvez saisir le domaine au format domain.suffix. Par exemple, pour limiter l'envoi d'e-mails aux domaines gmail.com et friendly_domain.org, vous pouvez spécifier ces domaines dans le champ Liste d'autorisation des domaines de messagerie pour les contenus programmés, puis accorder aux utilisateurs l'autorisation schedule_look_emails.

Pour en savoir plus sur l'impact de ce paramètre et des autorisations d'un utilisateur sur sa capacité à envoyer du contenu Looker et des notifications d'alerte, consultez la section Vue d'ensemble des autorisations de cette page.

looker_internal_email_domain_allowlist attribut utilisateur

Outre les domaines de messagerie inclus dans le champ global Liste d'autorisation des domaines de messagerie pour le contenu planifié, vous pouvez également spécifier des domaines de messagerie au niveau de chaque groupe à l'aide de l'attribut utilisateur looker_internal_email_domain_allowlist. L'attribut utilisateur accepte le même format de chaîne que le paramètre d'administration Liste d'autorisation de domaines de messagerie pour les contenus programmés.

Si plusieurs ensembles de domaines de messagerie sont attribués à un groupe (par exemple, s'il est membre de plusieurs groupes), les membres de ce groupe pourront envoyer des e-mails à tous les domaines attribués à chacune des valeurs d'attribut utilisateur, ainsi qu'aux domaines listés dans le paramètre d'administration Liste d'autorisation des domaines de messagerie pour le contenu planifié. En d'autres termes, l'ensemble des domaines de messagerie auxquels un groupe peut envoyer des e-mails combine les domaines de messagerie répertoriés dans le champ Liste d'autorisation des domaines de messagerie pour le contenu planifié et chaque ensemble de domaines de messagerie attribués au groupe par l'attribut utilisateur looker_internal_email_domain_allowlist.

Présentation des autorisations

Les utilisateurs intégrés et non intégrés doivent disposer au moins de l'autorisation schedule_look_emails pour pouvoir envoyer du contenu Looker par e-mail. Pour envoyer des notifications d'alerte, l'utilisateur doit également disposer des autorisations create_alerts.

Les utilisateurs intégrés ou non qui disposent de l'autorisation schedule_look_emails peuvent également se voir accorder l'autorisation schedule_external_look_emails (pour en savoir plus sur les autorisations et dépendances, consultez la page de documentation Rôles).

Pour découvrir l'impact des autorisations utilisateur sur les domaines auxquels les utilisateurs peuvent envoyer des diffusions de contenu Looker ou des notifications d'alerte, consultez le tableau suivant:

Type d'utilisateur Autorisations La liste d'autorisation de domaines de messagerie pour les contenus programmés contient le domaine friendly_domain.org La liste d'autorisation de domaines de messagerie pour les contenus programmés ne contient aucun domaine
Sans intégration schedule_look_emails Peut envoyer des diffusions de contenu et des notifications d'alerte par e-mail à leur propre adresse e-mail, à l'adresse e-mail d'un autre utilisateur Looker sur la même instance ou à une adresse e-mail appartenant au domaine friendly_domain.org Diffusion de contenu par e-mail et notifications d'alerte à n'importe quelle adresse e-mail
create_alerts
schedule_look_emails Diffusion de contenu par e-mail et notifications d'alerte à n'importe quelle adresse e-mail Diffusion de contenu par e-mail et notifications d'alerte à n'importe quelle adresse e-mail
schedule_external_look_emails
create_alerts
Intégration signée schedule_look_emails Peut diffuser du contenu par e-mail et envoyer des notifications d'alerte à une adresse e-mail appartenant au domaine friendly_domain.org Impossible d'envoyer du contenu Looker ou des notifications d'alerte par e-mail
create_alerts
schedule_look_emails Diffusion de contenu par e-mail et notifications d'alerte à n'importe quelle adresse e-mail Diffusion de contenu par e-mail et notifications d'alerte à n'importe quelle adresse e-mail
schedule_external_look_emails
create_alerts

Le contenu Looker intégré est accessible via un compte utilisateur intégré dédié, et non par des comptes utilisateur individuels. Lorsqu'une personne accède au contenu Looker via une intégration, il est peu probable que Looker connaisse l'adresse e-mail de l'utilisateur.

Une exception aux règles indiquées dans le tableau est la suivante: vous pouvez fournir à Looker l'adresse e-mail d'un utilisateur intégré en la définissant dans l'attribut utilisateur email de l'URL d'intégration signée. Exemple :

...&user_attributes={"email":"joe@domain.com"}

Si vous définissez l'attribut utilisateur email dans l'URL d'intégration, Looker autorise un utilisateur d'intégration qui dispose uniquement de l'autorisation schedule_look_emails à envoyer du contenu Looker par e-mail à sa propre adresse e-mail, même si son domaine de messagerie ne figure pas dans le champ Liste d'autorisation des domaines de messagerie pour les contenus programmés ou si le champ Liste d'autorisation du domaine de messagerie pour le contenu planifié est vide.

Liste d'autorisation d'URL pour les actions sur les données

Ce paramètre vous permet de définir des URL (comme https://looker.com) où vos utilisateurs peuvent traiter des actions sur les données.

Par exemple, si vous ajoutez l'URL https://looker.com à la liste d'autorisation des URL pour les actions sur les données, celles-ci ne pourront être traitées que sur https://looker.com. Les tentatives de traitement d'actions sur les données sur d'autres URL ne seront pas autorisées.

Si ce champ est vide, il n'existe aucune restriction d'URL pour les actions sur les données. Toutefois, si vous avez inclus un attribut utilisateur dans une action sur les données, ce champ est obligatoire. Dans ce cas, vous devez fournir des URL valides pour traiter les actions sur les données.

Bloquer les images intégrées dans les résultats de requête

Par défaut, Looker n'affiche pas les images encodées en Base64 dans les résultats de requête. Désactivez ce paramètre pour afficher les images encodées en base64 dans les résultats de requête.

Bloquer les formules et les macros dans les fichiers CSV et Excel

Lorsque ce paramètre est activé, Looker ajoute un caractère ' au début de toutes les valeurs pouvant être interprétées comme des formules ou des macros dans les requêtes téléchargées au format CSV ou Excel.

Jeton de webhook sortant

Si un utilisateur utilise un webhook pour envoyer du contenu, tel qu'un tableau de bord ou une présentation, la requête inclut un jeton Looker spécial qui peut être défini ici. Les serveurs qui reçoivent des webhooks peuvent ensuite vérifier que les requêtes contiennent cette valeur afin de s'assurer de leur légitimité.

Format d'exportation par défaut

Le paramètre Format d'exportation par défaut vous permet de choisir le format de fichier par défaut à utiliser lorsque les utilisateurs choisissent de télécharger des données. Les utilisateurs peuvent toujours choisir un autre format de fichier s'ils le souhaitent.

Format|Extension de fichier|Description --|--|-- TXT|.txt|Génère un fichier texte délimité par des tabulations. Feuille de calcul Excel|.xlsx|Génère un fichier de feuille de calcul au format Microsoft Excel 2007 et versions ultérieures. CSV|.csv|Génère un fichier texte délimité par des virgules. JSON|.json|Génère un fichier JSON avec un enregistrement par ligne. HTML|.html|Génère du code HTML de base pour afficher les données comme l'utilisateur les voit dans son navigateur. Cependant, la mise en forme n'est pas exactement la même, car le CSS de Looker ne sera pas inclus. Markdown|.md|Génère un fichier Markdown standard avec une table délimitée par |.

Intégration

Lorsque cette option est activée, les administrateurs et développeurs Looker qui se connectent à une nouvelle instance Looker voient le tutoriel d'intégration Looker, qui guide les utilisateurs à travers les quatre principales étapes nécessaires à l'utilisation d'une instance Looker:

  1. Ajouter une connexion
  2. Créer un projet
  3. Modification des fichiers du projet, si nécessaire
  4. Explorer les données

Une fois qu'une combinaison d'administrateurs ou de développeurs a suivi l'intégralité du guide, celui-ci cesse de s'afficher.

Le paramètre Guides intégrés à l'application doit être activé pour que l'option Intégration soit disponible.