Envoi d'e-mails (SMTP)¶
L'instance envoie des e-mails pour vérifier les adresses (code à 6 chiffres), réinitialiser un mot de passe et prévenir le titulaire d'un compte. Sans SMTP, ces fonctions sont désactivées (voir Compte et connexion).
Réglages¶
| Clé | Rôle | Défaut |
|---|---|---|
smtp.host |
serveur SMTP ; vide = e-mail désactivé | vide |
smtp.port |
port | 587 |
smtp.tls |
none, starttls ou tls (SMTPS, en général port 465) |
starttls |
smtp.from |
adresse d'expédition (harness@exemple.org ou Nom <harness@exemple.org>) |
vide |
smtp.username |
identifiant ; vide = sans authentification | vide |
secret core/smtp_password |
mot de passe SMTP | — |
Les réglages se modifient par l'opération core.config.set, le mot de passe par core.secret.set (nom
core/smtp_password). Le mot de passe est chiffré et jamais relisible, ni par l'interface, ni par l'API, ni par
une opération. Exemple avec la CLI locale :
docker exec -i <web> harness-admin op core.config.set --json '{"key":"smtp.host","value":"smtp.exemple.org"}'
docker exec -i <web> harness-admin op core.secret.set --json '{"name":"core/smtp_password","secret_value":"…"}'
starttls et tls vérifient le certificat du serveur ; aucun repli en clair n'existe : si le serveur n'offre pas
STARTTLS, l'envoi échoue. N'utilisez none que sur un réseau de confiance (relais local).
Tester¶
L'opération core.smtp.test place un message de test dans la file (à votre adresse, ou à celle donnée dans to),
attend la première tentative d'envoi de la gateway (au plus 45 s) et renvoie le résultat réel : succès, ou l'erreur
en cas d'échec (authentification refusée, connexion impossible…), sans jamais citer le mot de
passe. Un message de test n'est jamais retenté. Sans réponse dans le délai (smtp_timeout), vérifiez que la gateway
tourne. Elle demande une ré-authentification récente.
File d'envoi et tentatives¶
Les e-mails applicatifs passent par une file en base : un incident SMTP temporaire ne perd rien. Chaque message est tenté jusqu'à 5 fois (attente 1, 2, 4, 8 minutes), puis marqué en échec ; les lignes terminées sont supprimées après 7 jours. Le contenu (lien, code) est chiffré dans la file et effacé dès l'envoi. Les journaux ne contiennent ni destinataire, ni sujet, ni contenu : seulement un identifiant de file, le nombre de tentatives et la nature de l'erreur.
Notifications d'administration¶
Toute nouvelle notification de niveau warning (plugin en erreur, mise à jour en échec, repli de modèle…) est
aussi envoyée par e-mail à chaque super-administrateur actif dont l'adresse est vérifiée (voir
Notifications). Sans SMTP, rien ne part ; la notification reste visible dans l'interface.
Réseau¶
Les e-mails sont envoyés par la gateway, seul rôle qui a une sortie réseau (egress) : web n'a aucune sortie
(réseaux edge, internal, runnet, tous internes) et se contente d'écrire dans la file. Le serveur SMTP doit donc
être joignable depuis la gateway : directement par egress, ou par un relais SMTP interne sur un réseau partagé avec
elle (cas de l'infrastructure nway : smtp-relay:25, smtp.tls=none).