Paramètres d'administration – SMTP

La page SMTP (SMTP est l'acronyme de Simple Mail Transfer Protocol) de la section Plate-forme du menu Admin vous permet de configurer vos paramètres de messagerie. Les instances Looker envoient des e-mails dans de nombreuses situations, y compris pour les notifications de nouveaux utilisateurs, les réinitialisations de mot de passe et les notifications administratives, ainsi que lorsque les utilisateurs distribuent du contenu tel que des tableaux de bord et des Looks.

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.

Paramètres de messagerie

Obsolète : Pour les instances Looker hébergées par le client, le service de messagerie Looker par défaut n'est pas disponible et les options SMTP ne sont pas visibles. Vous devez configurer un autre service de messagerie pour toutes les nouvelles instances hébergées par le client.

Dans le panneau Admin de Looker, sélectionnez SMTP pour afficher et modifier les paramètres SMTP de votre instance. Vous pouvez utiliser les paramètres de messagerie par défaut pour profiter du service de messagerie de Looker, sans avoir besoin de configuration supplémentaire.

Pour utiliser un autre service de messagerie, sélectionnez Utiliser des paramètres de messagerie personnalisés. Looker est compatible avec deux méthodes d'authentification pour le SMTP personnalisé : l'authentification de base (nom d'utilisateur et mot de passe) et OAuth 2.0.

Vous pouvez configurer des paramètres de messagerie personnalisés pour les serveurs SMTP compatibles avec les protocoles d'authentification PLAIN et LOGIN ou OAuth 2.0.

Paramètres de messagerie personnalisés

Saisissez les valeurs appropriées pour les paramètres SMTP de votre service de messagerie :

• Serveur de messagerie : URL de votre serveur SMTP. Toute modification de ce paramètre nécessite que l'administrateur Looker modifie également le mot de passe du serveur SMTP.
• De : nom à afficher comme expéditeur de vos e-mails Looker (voir Tester les paramètres d'e-mail personnalisés pour obtenir un exemple). Vous pouvez saisir une chaîne de nom et une adresse e-mail entre crochets (par exemple, Nom à afficher <[e-mail]>) ou une adresse e-mail sans crochets (par exemple, [e-mail]). Les caractères spéciaux autres que le symbole @ dans une adresse e-mail et les chevrons qui l'entourent, le cas échéant, ne sont pas acceptés.
• Nom d'utilisateur : nom d'utilisateur nécessaire pour accéder à votre serveur SMTP.
• Mot de passe : mot de passe requis pour accéder à votre serveur SMTP.

• Port : port à utiliser pour votre serveur SMTP. Toute modification de ce paramètre nécessite que l'administrateur Looker modifie également le mot de passe du serveur SMTP.

  Remarque : Les instances Looker hébergées sur Google Cloud ne peuvent pas utiliser le port 25 pour le protocole SMTP. Google Cloud bloque tout le trafic sur le port 25. Pour en savoir plus, consultez la page Envoyer des e-mails depuis une instance dans la documentation Google Cloud . Il est déconseillé d'utiliser le port 25 pour SMTP sur les instances Looker hébergées sur Microsoft Azure, car cela peut entraîner des erreurs. Pour en savoir plus, consultez la page Résoudre les problèmes de connectivité SMTP sortante dans la documentation Azure.

• TLS/SSL : sélectionnez cette option si votre serveur SMTP utilise les protocoles TLS ou SSL pour sécuriser davantage les e-mails. Looker affiche un menu déroulant des versions TLS et SSL compatibles. Sélectionnez la version du protocole. Pour TLS, TLS 1.2 est recommandé.

• Type d'authentification : sélectionnez Authentification de base pour configurer un nom d'utilisateur et un mot de passe pour l'authentification auprès de votre serveur SMTP, ou sélectionnez OAuth pour configurer l'authentification OAuth 2.0.

  Remarque : Vous pouvez passer d'un type d'authentification à un autre sans interrompre le service de messagerie.

Authentification de base

Saisissez le nom d'utilisateur et le mot de passe requis pour vous authentifier auprès de votre serveur SMTP.

Authentification OAuth 2.0

Sélectionnez cette option si votre fournisseur SMTP utilise OAuth 2.0 pour l'authentification. Cette méthode est requise pour les services tels que Microsoft Office 365, qui abandonne l'authentification de base.

Saisissez les informations suivantes fournies par votre fournisseur de messagerie :

• ID client : ID client de l'application que vous avez créée dans la console d'administration de votre fournisseur de messagerie.
• Code secret du client : code secret du client pour l'application.
• URL du jeton : URL où Looker échangera les identifiants contre un jeton d'accès.
• Niveaux d'accès : URL des niveaux d'accès requis par votre fournisseur de messagerie. Par exemple, pour attribuer le champ d'application .default de la plate-forme d'identité Microsoft, saisissez https://outlook.office365.com/.default.

Générer des identifiants OAuth

Vous devrez créer une application sur la plate-forme de votre fournisseur de messagerie pour générer l'ID client, le code secret du client et l'URL du jeton. Pour en savoir plus sur la création d'une application, consultez les pages suivantes :

• Utiliser OAuth 2.0 pour accéder aux API Google
• Types d'applications pour la plate-forme Microsoft Identity

Enregistrement des paramètres SMTP

Une fois que vous avez saisi vos paramètres SMTP, cliquez sur le bouton Enregistrer pour enregistrer votre configuration. Vous pouvez également tester vos paramètres ou actualiser la page pour vérifier si votre configuration comporte des erreurs.

Remarque : Si vous utilisez des paramètres de messagerie personnalisés pour le protocole SMTP, ajoutez les adresses IP de Looker à la liste autorisée IP de votre serveur SMTP afin que celui-ci autorise le trafic entrant provenant de Looker.

Looker limite la fréquence à laquelle les administrateurs Looker peuvent enregistrer ou tester les paramètres SMTP pour éviter que cette fonctionnalité ne soit utilisée pour rechercher des ports ouverts.

Tester les paramètres de messagerie personnalisés

Pour tester la configuration de votre adresse e-mail personnalisée, cliquez sur le bouton Envoyer un e-mail de test. Ce test fonctionne à la fois pour les paramètres d'authentification de base et d'OAuth 2.0. Looker tentera d'envoyer un e-mail de test à l'utilisateur qui a appuyé sur le bouton. L'e-mail de test présente les attributs suivants :

• L'expéditeur est [e-mail].
• Le sujet est Looker Mail Test.
• Le corps de l'e-mail est Looker mail is working!

Pour empêcher les agents malveillants de rechercher des ports ouverts, Looker limite la fréquence à laquelle les administrateurs Looker peuvent tester les paramètres SMTP.

Messages d'erreur SMTP

En cas de problème avec votre configuration SMTP, Looker alerte tous les administrateurs aux emplacements suivants :

• Un message d'avertissement sur la page SMTP
• Icône d'avertissement à côté de la liste SMTP dans la barre latérale Admin

Ces erreurs sont visibles par tous les administrateurs de votre instance Looker. Vous pouvez vérifier immédiatement si des erreurs se sont produites en actualisant la page après avoir enregistré les paramètres de messagerie personnalisés.

Les erreurs liées aux tests des paramètres de messagerie personnalisés s'affichent sous les boutons Enregistrer et Envoyer un e-mail de test en bas de la page SMTP.