Mail documentation - MaximeDanlee/admin2-projet GitHub Wiki

Mail Documentation

(Basé sur des sources en ligne et non sur une vraie configuration par manque de configuration mail dans notre projet)

Organisation des Fichiers

Les différents fichier de configurations sont modifiables uniquement par l'utilisateur root. Ci-dessous, l'organisation des différents fichiers de PostFix.

/  
└── etc  
    ├── postfix
    |       ├── main.cf
    |       ├── master.cf
    |       └── vmailbox
    |
    └── dovecot
            └── dovecot.conf

main.cf

Le fichier main.cf est le fichier de configuration principale du service. C'est ici que tous les éventuels autres fichiers de configuration se rejoignent. Par défaut et avant modification, le fichier possède 300 paramètres ce qui permet une grande flexibilité.

master.cf

C'est ce fichier que le demon PostFix va utiliser pour sa configuration. Il y est marqué les différents services de PostFix ainsi que comment ces services doivent fonctionner ensembles mais aussi individuellement. C'est un fichier qui est peu modifié dans la plupart des cas.

vmailbox

Dans ce fichier, on retrouve une liste de comptes utilisateurs ainsi que l'emplacement de leur mails dans le serveur. Ce fichier est utilisé lorsqu'on veut ajouter un utilisateur pour le mail sans ajouter un compte système sur le serveur mail.

dovecot.conf

Dans le dossier /etc/dovecot on retrouve uniquement le fichier dovecot.conf . Il arrive parfois qu'on retrouve en plus de ce fichier, un dossier conf.d avec les différents fichiers de configuration qui seront alors inclus dans le fichier dovecot.conf . Dovecot est le logiciel responsable des protocols POP3 et IMAP. C'est le fichier dovecot.conf qui est le fichier de configuration principale de Dovecot. Ceci veut dire que quand le service Dovecot démarre, c'est le premier fichier qu'il va lire pour sa configuration.

Ajouter, Modifier ou Suprimmer

À chaque modification de PostFix il est impératif de lancer la commande suivante.

postfix reload

Ceci vaut également pour des modifications de Dovecot, la seul différence est la commande a taper. On la trouve ci-dessous.

systemctl start dovecot

Configuration

PostFix
Pour modifier la configuration il suffit d'abord d'ouvrir le fichier main.cf . La configuration est composé de plusieurs ensembles clé-valeur. Ces ensembles se présentent de la façon suivante :

clé = valeur

Pour écrire une valeur sur plusieurs lignes, il suffit de rajouter un espace à chaque ligne successive faisant partie de la ligne précédente. Pour ajouter un commentaire il faut utiliser le caractère "#".

Dovecot
L'organisation de la configuration Dovecot est très similaire. En effet, il s'agit également d'une structure clé valeur. La seule différence est que pour les directives où il y a potentiellement besoin d'indiquer plusieurs valeurs, il est nécessaire de mettre des accolade comme l'exemple ci-dessous le montre.

plugin {
  autocreate = Trash
  autocreate2 = Sent
  autosubscribe = Trash
  autosubscribe2 = Sent
}

Utilisateurs

Il y a plusieurs façons d'ajouter uin utilisateur à PostFix. Premièrement, il y a simplemplement moyen d'ajouter un utilisateur sur le serveur linux même. Lorsqu'on ajoute un utiliateur de cette façon, PostFix le configure tout seul. Pour ajouter une utilisateur sur Linux, utiliser la commande suivante :

useradd -d /home/<nom> -g <groupe> <nom>

Une fois cette commande lancé, le programme demandera plusieurs informations à propos de cet utilisateur, completez les informations ou laissez les vide.

La deuxième façon d'ajouter un utilisateur est souvent utilisé lorsqu'on ne veut pas ajouter un utilisateur système comme le fait la première façon. Pour ce faire, il faut ajouter la ligne suivante dans le fichier /etc/postfix/vmailbox.

<utilisteur>@<nom de domaine>   chemin/vers/la/boite/mail

Toutes les boites mail se trouvent généralement dans le dossier /var/mail/vhosts.

Pour suprimmer un utilisateur de la première façon, il faut utiliser la commande suivante :

sudo deluser --remove-home <utilisateur>

Pour suprimmer un utilisateur ajouté de la deuxième façon, il suffit de modifier la ligne de configuration dans le fichier /etc/postfix/vmailbox.

Pour modifier un utilisateur ajouté avec la prmière commande, utiliser la commande suivante :

usermod <options> <utilisateur>

Pour la documentation complète de la commande usermod :
https://linux.die.net/man/8/usermod

Pour modifier un utilisateur ajouté avec la deuxième façon, il faut simplement retrouver la ligne de configuration de cet utilisateur dans le fichier /etc/psotfix/vmailbox et modifier les éléments à modifier.

Mises à Jour

PostFix

Pour mettre à jour le logiciel PostFix, entrez un par un les commandes suivantes.

postfix stop
apt update
apt install --only-upgrade postfix
postfix start

L'accès à l'utilisateur root est très probablement demandé.

Lors d'une mise à jour des fichiers de configurations du service postfix, il est impératif de lancer la commande postfix reload pour appliquer ces changements.

Dovecot

Pour mettre à jour le logiciel Dovecot, entrez un par un les commandes suivantes.

systemctl stop dovecot
apt update
apt install --only-upgrade dovecot-core dovecot-pop3d dovecot-imapd
systemctl start dovecot

L'accès à l'utilisateur root est très probablement demandé.

Lors d'une mise à jour des fichiers de configurations du service dovecot, il est impératif de lancer la commande systemctl restart dovecot pour appliquer ces changements.

Logs

Tous les logs peuvent être trouvés dans le fichier /var/log/mail.log. Pour des erreurs de Dovecot, veuillez consulter le fichier de log /var/log/mail.err. Dans le cas d'un problème au démarrage de Dovecot, consulter le fichier de log /var/log/upstart/dovecot.log.

Erreurs Fréquentes

Fermeture de Caractères de Délimitation

Cette partie s'applique pour les configurations et en particluier la configuration de Dovecot. Il faut donc bien vérifier que chaque accolade, guillement ou paranthèse d'ouverture soit suivie du même caractère fermant. Ceci peut causer beaucoup de problèmes, en particulier si les configurations sont écrites en console et non dans un éditeur de code. Vérifiez également qu'il n'y a pas de directives qui sont mal placés dans le fichier de configuration.

Chroot master.cf

Une erreur fréquente est d'activer le chroot dans le fichier master.cf sans passer par les étapes pour créer un environnement chroot. Ceci produit plusieurs erreurs puisque le demon PostFix n'a pas tous les fichier dont il a besoin. Pour solutionner ce problème il suffit simplement de désactiver le chroot dans le fichier master.cf, pour la pluspart des serveur mail le chroot n'est pas nécessaire. Si vous avez besoin d'un environnement chroot consultez le lien suivant : http://www.postfix.org/BASIC_CONFIGURATION_README.html#chroot_setup.

Commentaires

Aussi stupide que ça sonne, les commentaires sont souvent une source d'erreurs. En effet beaucoup de personnes oublient que les commentaires ne peuvent pas se mettre avant ou après une ligne de configuration. Ceci résulté souvent à des erreurs dont on n'arrive pas à identifier la cause.

Attention aux Espaces

Les espaces en début de ligne sont utilisés pour indiquer que la ligne de configuration fait partie de la ligne précédente. Ceci est très pratique mais veut également dire qu'un espace de trop résulte facilement à une erreur. Il faut donc faire très attention a ne pas mettre des espaces n'importe où.

Sources

⚠️ **GitHub.com Fallback** ⚠️