Envoi d'e-mails

La connexion globale au serveur SMTP est configurée via l’interface web. Cette connexion est nécessaire si Relution doit envoyer activement des courriels. Il peut s’agir, par exemple, de courriels de réinitialisation de mot de passe, d’inscriptions ou de notifications. La connexion à un serveur SMTP est facultative.


Configuration

Pour les administrateurs système, la configuration du serveur SMTP est disponible dans l’organisation Global sous Paramètres → Configuration du courrier électronique. Elle comprend les champs suivants :

  • Hôte et Port
  • Sécurité des connexions : Aucun, STARTTLS, STARTTLS (REQUIRETLS) ou SSL/TLS. Avec STARTTLS, Relution passe à une connexion chiffrée si le serveur la prend en charge ; avec STARTTLS (REQUIRETLS), l’envoi échoue si le serveur ne propose pas STARTTLS.
  • Utiliser l’option “Extended Hello” (EHLO) : condition préalable pour STARTTLS et STARTTLS (REQUIRETLS).
  • Nom d’hôte local pour HELO/EHLO : si le champ reste vide, le nom d’hôte externe du serveur est utilisé ; si l’URL externe est une adresse IP, elle est annoncée sous la forme [adresse IP].
  • Nom d’utilisateur et Mot de passe : si le champ du mot de passe reste vide lors de la modification, le mot de passe existant n’est conservé, à l’enregistrement comme lors du test, que tant que Hôte, Port et Sécurité des connexions restent inchangés (voir ci-dessous).
  • Adresse de l’expéditeur : champ obligatoire ; cette adresse est utilisée comme expéditeur des e-mails sortants.

Dans la section de test de la configuration (affichée dans l’interface sous Configuration de l’e-mail de test), Envoyer envoie un e-mail de test avec les valeurs actuellement saisies, pas encore enregistrées, à l’adresse e-mail de l’utilisateur connecté. Si aucune adresse e-mail n’est enregistrée pour le compte connecté, le test échoue. Comme la configuration elle-même, le test n’est disponible que dans l’organisation Global.

Lorsque le champ du mot de passe est vide, Relution n’utilise le mot de passe enregistré que si Hôte, Port et Sécurité des connexions sont inchangés par rapport à la configuration enregistrée. Un champ Port vide correspond au port 25. Les modifications de Nom d’utilisateur, Adresse de l’expéditeur, Utiliser l’option “Extended Hello” (EHLO) et Nom d’hôte local pour HELO/EHLO ne sont pas prises en compte. Cette règle s’applique au test à partir de Relution 26.5.5 et, à partir de Relution 27.0.1, également à l’enregistrement.

Si l’une des trois valeurs a été modifiée, Relution refuse l’enregistrement et le test avec un champ de mot de passe vide. Mot de passe devient un champ obligatoire, l’espace réservé et l’indication « Laisser vide pour conserver le mot de passe existant » disparaissent, et le message « Le point de terminaison de connexion a changé. Veuillez saisir à nouveau le mot de passe ou le secret. » s’affiche sous le champ. Dans ce cas, la configuration n’est pas enregistrée. Une fois le mot de passe saisi à nouveau, la configuration peut être enregistrée ou le test relancé via Envoyer. Si aucun mot de passe n’est encore enregistré, cette vérification n’a pas lieu.

Tant qu’aucun serveur SMTP n’est configuré, Relution affiche aux administrateurs système dans l’organisation Global la notification SMTP n’est pas configuré. En cas de configuration via le fichier application.yml, elle ne disparaît que lorsque l’adresse de l’expéditeur est définie via mail.smtp.from en plus du serveur de messagerie (voir Options supplémentaires pour la session de messagerie →).


Priorité entre l’interface web et application.yml

La configuration enregistrée dans l’interface web est prioritaire. Les valeurs du fichier application.yml ou des variables d’environnement ne sont utilisées que tant qu’aucune configuration n’est enregistrée dans l’interface web. Une configuration existante est supprimée dans la catégorie Configuration du serveur de messagerie, section Effacer la configuration, via le bouton de suppression (libellé Clair dans le portail) ; Relution utilise alors le fichier application.yml.

Les modifications du fichier application.yml ne prennent effet qu’après un redémarrage du serveur Relution.


application.yml

relution:
  mail:
    username:
    password:
    host: localhost
    port: 25
  smtp:
    starttls: false
    ssl: false
    ehlo: true

Les paramètres indiqués ci-dessus sont les valeurs par défaut s’ils ne sont pas configurés. La connectivité SMTP est testée dans le cadre du contrôle de santé du serveur, qui est affiché dans le portail du système.

L’ancienne clé ttls à la place de starttls est toujours prise en compte. Si ssl et starttls valent tous deux true, Relution utilise SSL/TLS.

Relution lit la configuration de messagerie exclusivement sous relution.mail et relution.smtp. Les entrées sous spring.mail sont ignorées. Si la configuration s’y trouve, Relution tente d’envoyer les e-mails via localhost sur le port 25.

Les valeurs peuvent également être définies via des variables d’environnement, par exemple dans une installation Docker :

Variable d’environnementClé dans application.yml
SMTP_HOSTrelution.mail.host
SMTP_PORTrelution.mail.port
SMTP_USERNAMErelution.mail.username
SMTP_PASSWORDrelution.mail.password
SMTP_TTLSrelution.smtp.starttls
SMTP_SSLrelution.smtp.ssl
SMTP_EHLOrelution.smtp.ehlo

Une valeur définie explicitement dans le fichier application.yml est prioritaire sur la variable d’environnement.


Options supplémentaires pour la session de messagerie

D’autres options peuvent être transmises directement à la bibliothèque de messagerie (Jakarta Mail) via relution.mail.properties. Les entrées sont reprises telles quelles et remplacent les valeurs définies par Relution. Elles ne s’appliquent que tant que la configuration provient du fichier application.yml, c’est-à-dire qu’aucune configuration n’est enregistrée dans l’interface web.

relution:
  mail:
    host: smtp.example.com
    port: 587
    username: "relay@example.com"
    password: "xxx"
    properties:
      "[mail.smtp.from]": "mdm@example.com"
      "[mail.smtp.starttls.required]": "true"
      "[mail.smtp.ssl.trust]": "smtp.example.com"
  smtp:
    starttls: true
    ssl: false
    ehlo: true

Les clés contiennent des points et sont donc placées entre crochets et guillemets. Options fréquemment utilisées :

OptionEffet
mail.smtp.fromAdresse de l’expéditeur. Sans indication, Relution forme une adresse à partir du domaine de l’URL externe du serveur (no-reply+relution@<domaine>, par ex. no-reply+relution@example.com pour mdm.example.com).
mail.smtp.localhostNom d’hôte annoncé dans la commande EHLO. Sans indication, le nom d’hôte de l’URL externe du serveur est utilisé.
mail.smtp.starttls.requiredInterrompt l’envoi si le serveur ne propose pas STARTTLS.
mail.smtp.ssl.trustHôtes dont le certificat est accepté sans vérification. Utile pour les serveurs de messagerie dont la chaîne de certificats est incomplète.

mail.smtp.ssl.trust doit contenir le nom d’hôte précis du serveur de messagerie. La valeur * fait confiance à tout certificat de tout serveur. La meilleure solution reste d’ajouter le certificat de l’autorité de certification émettrice au truststore.

Si le niveau de log de io.relution.setting.system.email.SystemEmailConfigurationService est réglé sur DEBUG, Relution écrit l’intégralité de la communication SMTP sur la sortie standard à chaque envoi (avec Docker dans docker logs), et pas nécessairement dans le fichier journal de Relution. Pour l’e-mail de test, le réglage prend effet immédiatement. Pour l’envoi normal, il ne prend effet qu’après un nouvel enregistrement de la configuration e-mail ou un redémarrage du serveur. Cela vaut aussi pour le retour à INFO. Définir le niveau de journalisation →


Amazon Simple Email Service (SES) SMTP

Les paramètres recommandés pour la connexion à Amazon SES sont les suivants :

relution:
  mail:
    username: ABCDEFGHIJKLMNOPQ123
    password: "abcdefghijklmnopqrstuvwxyz/BASE64+1234567890"
    host: email-smtp.eu-central-1.amazonaws.com
    port: 587
  smtp:
    starttls: true
    ssl: false
    ehlo: true

Les paramètres SMTP username et password sont une clé d’accès AWS et une clé secrète d’un utilisateur IAM avec les permissions AmazonSesSendingAccess, qui accordent les droits ses:SendRawEmail. S’assurer que la bonne région est spécifiée dans host. Ces paramètres peuvent être trouvés sur la page SMTP Settings du service SES dans la console AWS.


Microsoft Office365 SMTP

Les paramètres recommandés pour pouvoir envoyer du courrier via Office 365 sont les suivants :

L’Adresse de l’expéditeur sous Paramètres → Configuration du courrier électronique doit correspondre au nom d’utilisateur du compte. Si la configuration est effectuée via le fichier application.yml, l’adresse de l’expéditeur est définie via mail.smtp.from (voir Options supplémentaires pour la session de messagerie →). SMTP AUTH doit être activé pour le compte.

relution:
  mail:
    username: "email@somewhere.com"
    password: "xxx"
    host: smtp.office365.com
    port: 587
  smtp:
    starttls: true
    ssl: false
    ehlo: true

Cet article a-t-il été utile ?