Courriel sortant
Tout ce qui, sur le serveur, envoie du courriel automatisé passe par un seul service externe : un choix, une adresse d’expédition, un identifiant. Un serveur qui expédie lui-même son courriel transactionnel finit dans les pourriels; vous utilisez donc un service d’envoi.
Ce qui en dépend
Section intitulée « Ce qui en dépend »- Les courriels de réinitialisation de mot de passe et les invitations du service de connexion (Keycloak). Voir Connexion et personnes.
- Les alertes de surveillance envoyées au courriel de l’administrateur : une tâche planifiée comme la sauvegarde en retard ou en échec, un service qui ne répond plus, un serveur qui manque d’espace disque, de mémoire ou de processeur. Voir Alertes.
- Les alertes du moniteur de ressources envoyées aux autres adresses qui y sont ajoutées.
- Les courriels des sites WordPress déployés depuis le catalogue, comme les formulaires de contact.
- Le courriel unique qui vous est envoyé quand votre abonnement payant se verrouille. Voir Abonnement.
Une application de messagerie déployée sur le serveur (un serveur de courriel) garde ses propres réglages, distincts. Son mot de passe de relais et sa clé Spamhaus se saisissent sur la carte du serveur de courriel, sous Applications; la valeur stockée n’est jamais réaffichée.
Prérequis
Section intitulée « Prérequis »- Un compte chez un service d’envoi, avec votre domaine d’envoi vérifié chez lui (voir les étapes côté compte plus bas), ou un relais SMTP existant.
- Une adresse de ce domaine à utiliser comme expéditeur.
Dans Paramètres > Courriel sortant, Envoyer le courriel par propose :
| Option | Sens |
|---|---|
| Aucun courriel sortant | Le courriel est désactivé. Cela désactive aussi les courriels de réinitialisation de mot de passe et les courriels d’alerte. |
| Resend (clé d’API) | Resend connaît son propre hôte et son port. |
| Brevo (clé d’API) | Brevo connaît son propre hôte et son port. |
| Serveur SMTP personnalisé | N’importe quel relais SMTP. |
Seuls les champs dont l’option choisie a besoin sont affichés :
| Champ | Resend | Brevo | Personnalisé |
|---|---|---|---|
| Adresse d’expédition | oui | oui | oui |
| Hôte du serveur SMTP | non | non | oui |
| Port du serveur SMTP | non | non | oui (587, ou 465 pour un serveur qui prend TLS dès le premier octet) |
| Nom d’utilisateur | non | oui | oui |
| Clé d’API ou mot de passe | oui | oui | oui |
Le secret est stocké et jamais réaffiché; un champ vide le conserve. Le choix du service est la seule valeur que le panneau valide (“Choisissez l’une des options proposées.”). La section se termine par Enregistrer et appliquer : les services qui expédient du courriel redémarrent brièvement.
Les réglages de courriel modifiés dans l’onglet Courriel propre au service de connexion (dans la console d’administration de Keycloak) restent, et cette section ne les modifie plus. L’exception est le mot de passe seul : un nouveau mot de passe saisi uniquement à cet endroit ne peut pas être détecté, de sorte que le mot de passe de cette section le remplace la prochaine fois que la configuration du serveur est appliquée.
Étapes côté compte
Section intitulée « Étapes côté compte »- Créez un compte Resend et ajoutez-y le domaine d’envoi.
- Ajoutez au domaine, dans Cloudflare, les enregistrements DNS que Resend liste, puis attendez que le domaine soit indiqué comme vérifié dans Resend.
- Créez une clé d’API.
- Dans le panneau, choisissez Resend (clé d’API), saisissez une adresse d’expédition du domaine vérifié et la clé d’API, puis appuyez sur Enregistrer et appliquer.
- Créez un compte Brevo, puis ajoutez-y et authentifiez-y le domaine d’envoi à l’aide des enregistrements DNS que Brevo liste.
- Dans le compte Brevo, repérez l’identifiant SMTP et créez la clé à utiliser avec le relais SMTP.
- Dans le panneau, choisissez Brevo (clé d’API), saisissez l’adresse d’expédition du domaine authentifié, l’identifiant SMTP dans Nom d’utilisateur et la clé dans Clé d’API ou mot de passe, puis appuyez sur Enregistrer et appliquer.
Serveur SMTP personnalisé
Section intitulée « Serveur SMTP personnalisé »Saisissez l’hôte et le port du relais, son nom d’utilisateur et son mot de passe, ainsi qu’une adresse d’expédition que le relais accepte.
Vérifier le fonctionnement
Section intitulée « Vérifier le fonctionnement »Après l’enregistrement, le lien de mot de passe oublié de la page de connexion, sur auth.yourdomain.com, envoie un courriel de réinitialisation à un compte existant. Si rien n’arrive, vérifiez le dossier des pourriels, puis l’état de vérification du domaine d’envoi chez le fournisseur. Le bouton Test de l’intégration de courriel de l’administrateur dans Healthchecks (healthchecks.yourdomain.com > Integrations) envoie une alerte d’essai.
Dépannage
Section intitulée « Dépannage »- Aucun courriel de réinitialisation après avoir choisi Aucun courriel sortant : attendu, cette option les désactive.
- Le fournisseur rejette l’expéditeur : l’adresse d’expédition doit appartenir à un domaine vérifié chez le fournisseur.
- Le courriel fonctionnait puis s’est arrêté : la clé a pu être révoquée ou le compte du fournisseur suspendu. Créez une nouvelle clé et enregistrez-la; un champ secret vide conserve l’ancienne, saisissez donc la nouvelle valeur.