Aller au contenu

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).