FAQ

Configurations SMTP

De MappingDoc
Révision datée du 12 octobre 2020 à 19:47 par Nsmet (discussion | contributions) (Configuration d'un container Docker Postfix)

Différentes méthodes de configuration SMTP pour l'envoi d'emails avec MAPPING

Utilisation d'un serveur SMTP relais entre Mapping et Office365

Pour des raisons d'authentification et/ou de chiffrement (TLS), il peut être nécessaire d'utiliser un serveur SMTP relais intermédiaire entre Mapping (compatible TLS 1.0) et le serveur SMTP "Office365".

Tout type de serveur SMTP peut faire l'affaire, les plus courants étant d'une part le serveur SMTP Microsoft (composant enfichable de IIS) sur plateforme Windows et d'autre part Postfix sur plateforme Linux.

Nous allons illustrer ici la configuration d'un serveur SMTP Postfix monté via une image Docker, ce qui a l'avantage de pouvoir être mis en oeuvre aussi bien sur un serveur Windows que sur un serveur Linux. De plus, sa configuration est très simple et rapide à mettre en oeuvre.

Configuration d'un container Docker Postfix

Il s'agit d'un exemple illustré à partir d'une image Docker simple à configurer. Toute autre image Docker Postfix pouvant répondre au même besoin.


Image : freinet/postfix-relay


Paramètres d'environnement

  • MAILNAME : Nom logique du serveur SMTP (libre)
  • RELAYHOST : Serveur SMTP cible (smtp.office365.com)
  • RELAYHOST_AUTH: Booleen (true or false) indiquant si la connexion au serveur Office 365 doit se faire ou non avec une authentification
  • RELAYHOST_PASSWORDMAP : Dans le cas où une identification est nécessaire, c'est à travers ce paramètre que sont fournis l'identifiant et le mot de passe de connexion au serveur SMTP cible, sous la forme "Addresse_SMTP_cible:Identifiant:mot_de_passe"
  • USE_TLS : Boolean permet de spécifier si le chiffrement TLS doit être activé pour atteindre ce serveur relais
  • MYNETWORKS : Liste des sous réseau pouvant utiliser le relais SMTP (127.0.0.0/8, 10.0.0.0/8 ...)


Ports :

  • 25
  • 587

Démarrer un container Postfix en ligne de commande

La commande ci-dessous permet de lancer une instance Docker de postfix. Nécessite l'installation de Docker. Cette image est disponible sur registry "Docker hub".

docker run -d -p 587:587 -e MAILNAME=mail.mycompany.com -e RELAYHOST=smtp.office365.com -e RELAYHOST_AUTH=false -e USE_TLS=true freinet/postfix-relay

Exemple de docker-compose.yml :

version: '3'
services:
  smtp:
    image: freinet/postfix-relay
    restart: unless-stopped
    environment:
        MAILNAME: "mail.mycompany.com"
        RELAYHOST: "smtp.office365.com:587"
        RELAYHOST_AUTH: "yes"
        RELAYHOST_PASSWORDMAP: "smtp.office365.com:user@domain.com:mypassword"
        USE_TLS: "yes"
    ports:
        587:587

Configuration SMTP côté Mapping

Pour utiliser ce service relais SMTP, la configuration SMTP côté Mapping doit être la suivante :

  • server : mail.mycompany.com (remplacer par le nom ou l'IP du serveur SMTP docker)
  • Pas de login ni de mot de passe, le relais SMTP Postfix doit être configuré pour accepter uniquement certaines adresses IP émettrices des emails.