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 au niveau 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 de l'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, en fonction de 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 Que se passe-t-il si l'URL change pour mon instance Looker ? pour en savoir plus sur la modification des URL d'instance.

Contacts techniques

Les adresses e-mail ajoutées à cette zone recevront des notifications concernant les mises à jour de sécurité, les corrections de bugs majeures 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, une adresse e-mail pour une liste de diffusion), elle apparaîtra dans le champ Contact technique, mais Looker ne pourra pas envoyer de notifications à cette adresse.

Le support Looker a besoin d'une autorisation de la part d'un contact technique pour effectuer l'une des opérations suivantes:

  • a provoqué un temps d'arrêt de l'instance, qui peut être dû à une mise à jour de version non planifiée, à des changements de performances sur votre serveur Looker ou à d'autres raisons.
  • Modifier un élément de votre licence Looker, éventuellement pour activer de nouvelles fonctionnalités

Fuseau horaire de l'application

Lors de l'affichage des 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 au 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. 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 les diffusions de contenu. Le fuseau horaire utilisé pour les planifications n'affecte pas les données temporelles renvoyées par une requête. Il affecte uniquement l'heure à laquelle un envoi de données est envoyé.

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 de connaître les utilisateurs d'un autre groupe. Cela s'avère 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 Système fermé est activé, les utilisateurs non administrateurs qui ne disposent pas de l'autorisation see_users peuvent uniquement voir 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 voir tous les utilisateurs et groupes de l'instance.

Lorsque cette option est activée, la configuration du consentement à la connexion entraîne l'affichage d'un écran de consentement pour tous les utilisateurs qui tentent de se connecter à l'instance Looker. L'écran d'autorisation affiche le message saisi dans le champ Configuration du message. Les utilisateurs devront 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 des messages devient visible.

Configuration de message

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

Dossiers personnels privés par défaut

Par défaut, lorsque l'option Dossiers personnels privés par défaut est activée, le dossier personnel d'un utilisateur est visible uniquement par cet utilisateur et par les administrateurs Looker. Par défaut, les autres utilisateurs ne verront pas le dossier dans le dossier Personnes, et le contenu du dossier ne sera pas visible dans les tableaux ni dans les recherches de contenus.

Si vous souhaitez accorder 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 dans le menu en forme de roue dentée du dossier personnel.

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

Notification de nouveau compte

Le paramètre Notification de nouveau compte peut être activé ou désactivé. Lorsque cette option est activée, tout administrateur Looker reçoit un e-mail lorsqu'un compte Looker est créé. (Les utilisateurs disposant d'un élément intégré signé font exception : les e-mails ne sont pas générés lors de la création d'un utilisateur intégrateur signé.) 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 à tirer le meilleur parti de la plateforme, pour les informer des nouvelles fonctionnalités, pour recueillir leurs commentaires sur la plateforme et pour les inviter à 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. Les guides sont alors désactivés pour tous les utilisateurs de l'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 des instances de marque privée.

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 le logiciel tiers (Pendo) JavaScript pour diffuser les guides. Looker examine 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 l'utilisation du guide modifié. Si le navigateur d'un utilisateur ne parvient pas à accéder au serveur Pendo, le guide n'est tout simplement pas affiché.

Lorsque ce paramètre est activé, une bannière de notification des 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 des dossiers partagés, leur dossier personnel et des 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 les contenus qui n'existent que dans les dossiers personnels des autres utilisateurs. Les utilisateurs ont la possibilité d'exclure le contenu de leurs dossiers personnels en sélectionnant le bouton bascule 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 de tableau de bord. L'actualisation automatique des données des tableaux 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 appliquer 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 spécifiez le fuseau horaire dans lequel votre base de données stocke les informations temporelles dans le champ Database Time Zone (Fuseau horaire de la base de données).

Lorsque l'option User Specific Time Zones 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 d'un utilisateur lorsque celui-ci affiche les résultats de sa requête ou interprète les filtres.

Lorsque l'option User Specific Time Zones (Fuseaux horaires spécifiques à l'utilisateur) est désactivée, Looker convertit les données temporelles pour tous les utilisateurs en la valeur 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 de visualisation par défaut 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 comporter une collection de couleurs par défaut.

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

Vous pouvez afficher les premières palettes catégorielles, séquentielles et divergentes de chaque collection directement dans le menu déroulant. Ce sont les palettes qui seront utilisées comme valeurs par défaut de la visualisation. 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. Dans la zone de texte Nom, attribuez un nom unique à votre nouvelle collection.
  3. Cliquez sur chaque palette de couleurs pour ouvrir le menu Couleurs de la palette.
  4. Dans le menu Couleurs de la palette, sélectionnez des couleurs individuelles pour les modifier une par une, ou sélectionnez Tout modifier pour modifier toutes les couleurs simultanément.
  5. Répétez les étapes 3 et 4 pour chaque palette de couleurs.
  6. Lorsque 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, comme mediumblue. Vous pouvez également cliquer sur la roue des couleurs pour ouvrir et sélectionner une nuance dans le sélecteur de couleur. Si vous décidez de modifier toutes les couleurs, séparez-les par une virgule. Pour ajouter ou supprimer une couleur, cliquez sur les signes + ou -.

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

Les ID de collection et les ID de palette des nouvelles collections de couleurs personnalisées 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 le même nom.

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 des éléments depuis CDN

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

CDN est l'abréviation de Content Delivery Network. Un CDN est un réseau de serveurs qui stocke 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 (comme les images) sont stockés sur le CDN.

Le paramètre Charger des éléments depuis CDN peut être activé ou désactivé. Lorsque cette option est activée, les pages Looker se chargent plus rapidement.

Conserver les éléments dans le cache du navigateur

Lorsque ce paramètre est activé, les éléments statiques tels que les polices et les fichiers JavaScript sont mis en cache dans l'espace de stockage du navigateur de chaque utilisateur. Cela accélère les navigations suivantes, car le navigateur n'a pas besoin de continuer à recharger ces composants à 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'elle est désactivée, 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 ouvrent l'application 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 Content Security Policy (CSP) conformes aux recommandations CSP strictes de Google 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 sur Looker, désactivez ce paramètre.

Cette option a été ajoutée pour donner 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 envoyer du contenu Looker (présentations, 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 la distribution des e-mails aux adresses e-mail des 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 Présentation des autorisations de cette page.

Attribut utilisateur looker_internal_email_domain_allowlist

En plus des domaines de messagerie inclus dans le champ Liste d'autorisation des domaines de messagerie pour les contenus programmés, vous pouvez également spécifier des domaines de messagerie pour chaque groupe à l'aide de l'attribut utilisateur looker_internal_email_domain_allowlist. Le format de chaîne de l'attribut utilisateur est identique à celui du paramètre d'administration Liste d'autorisation des domaines de messagerie pour les contenus programmés.

Si un groupe se voit attribuer plusieurs ensembles de domaines de messagerie (par exemple, s'il appartient à plusieurs groupes), les membres de ce groupe pourront envoyer des e-mails à tous les domaines associés à chacune des valeurs d'attribut utilisateur, ainsi qu'aux domaines figurant 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 l'ensemble des 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 avec ou sans intégration 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, un utilisateur doit également disposer des autorisations create_alerts.

L'autorisation schedule_external_look_emails peut également être accordée aux utilisateurs "Embed" et "non intégré" disposant de l'autorisation schedule_look_emails (pour en savoir plus sur les autorisations et dépendances, consultez la page de documentation Rôles).

Pour découvrir comment les autorisations utilisateur affectent les domaines auxquels les utilisateurs peuvent envoyer du contenu Looker ou des notifications d'alerte, consultez le tableau suivant:

Type d'utilisateur Autorisations La liste d'autorisation de domaines de messagerie pour le contenu programmé contient le domaine friendly_domain.org La liste d'autorisation de domaines de messagerie pour le contenu programmé ne contient aucun domaine
Non intégré schedule_look_emails Peut envoyer des contenus 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 avec le domaine friendly_domain.org Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à n'importe quelle adresse e-mail
create_alerts
schedule_look_emails Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à n'importe quelle adresse e-mail Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à n'importe quelle adresse e-mail
schedule_external_look_emails
create_alerts
Intégration signée schedule_look_emails Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à une adresse e-mail appartenant au domaine friendly_domain.org Impossible d'envoyer par e-mail des notifications d'alerte ou de contenu Looker
create_alerts
schedule_look_emails Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à n'importe quelle adresse e-mail Possibilité d'envoyer des contenus et de recevoir des notifications d'alerte par e-mail à 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 d'utilisateurs individuels. Lorsqu'une personne accède au contenu Looker par le biais d'une intégration, Looker n'est pas censé connaître l'adresse e-mail de l'utilisateur en question.

Voici une exception aux règles stipulées dans ce tableau: vous pouvez fournir à Looker l'adresse e-mail d'un utilisateur d'intégration 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 permettra à un utilisateur d'intégration qui ne dispose que de l'autorisation schedule_look_emails d'envoyer du contenu Looker à sa propre adresse e-mail, même si son domaine de messagerie ne figure pas dans le champ Liste d'autorisation de domaines de messagerie pour les contenus programmés ou si le champ Liste d'autorisation de domaines de messagerie pour les contenus programmés 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) vers lesquelles 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 des actions sur les données associées à d'autres URL ne seront pas autorisées.

Si ce champ est vide, cela signifie qu'il n'existe aucune restriction liée aux 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 d'images encodées en Base64 dans les résultats de la requête. Désactivez ce paramètre pour afficher les images encodées en base64 dans les résultats de la requête.

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

Lorsque ce paramètre est activé, Looker ajoute le 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 diffuser du contenu (un tableau de bord ou une présentation, par exemple), la requête inclut un jeton Looker spécial qui peut être défini ici. Les serveurs qui reçoivent des requêtes webhook peuvent ensuite vérifier que les requêtes contiennent cette valeur afin de vérifier 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 à utiliser par défaut lorsque les utilisateurs choisissent de télécharger des données. Les utilisateurs peuvent toujours choisir un format de fichier différent 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 une 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 de la même manière que l'utilisateur les voit dans son navigateur. Cependant, la mise en forme n'est pas exactement la même, car le CSS de Looker n'est 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 les développeurs Looker qui se connectent à une nouvelle instance Looker verront le tutoriel d'intégration Looker, qui guide les utilisateurs à travers les quatre principales étapes à suivre pour utiliser une instance Looker:

  1. Ajouter une connexion
  2. Créer un projet
  3. Modifier les fichiers du projet si vous le souhaitez
  4. Explorer les données

Lorsque des administrateurs ou des développeurs ont terminé le guide complet, 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.