Info:: apsi.net: GUIDE CREATION COMPTE
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Guide de Création d’un Nouveau Compte Email
Serveur: ovh1 (mail.apsi.net) Architecture: Postfix + Dovecot + rspamd + ClamAV Ordre: Du plus urgent au moins urgent
Ce guide détaille toutes les étapes pour ajouter un nouveau compte email sur un domaine existant, organisées par ordre de priorité.
Table des matières
- Prérequis
- Étapes URGENTES - À faire immédiatement
- Étapes IMPORTANTES - À faire dans les 24h
- Étapes OPTIONNELLES - Configuration avancée
Prérequis
Avant de créer un compte email, assurez-vous que:
- ☐ Le domaine est déjà configuré (voir
/root/scripts/GUIDE_CREATION_DOMAINE.md) - ☐ Le domaine est actif dans MySQL (PostfixAdmin)
- ☐ Les enregistrements DNS du domaine sont configurés
- ☐ Vous avez un accès root au serveur
Vérifier qu’un domaine existe:
mysql -u postfixadmin -p postfixadmin -e "SELECT domain, active FROM domain WHERE domain='exemple.com';"
Devrait retourner:
+-------------+--------+ | domain | active | +-------------+--------+ | exemple.com | 1 | +-------------+--------+
Étapes URGENTES
Ces étapes sont nécessaires pour que le compte fonctionne. À effectuer immédiatement.
1. Créer le compte dans PostfixAdmin (MySQL)
Pourquoi: C’est la source de vérité pour Postfix et Dovecot. Sans cela, le serveur ne reconnaît pas le compte.
Option A: Utiliser le script automatisé (RECOMMANDÉ):
/root/scripts/add-account.sh contact@exemple.com "MotDePasse123!"
Ou interactivement:
/root/scripts/add-account.sh
Le script fait automatiquement: - Création du compte dans MySQL - Création de la structure Maildir - Configuration des permissions (vmail 5000:5000) - Affichage des paramètres de connexion
Option B: Création manuelle:
DB_USER="postfixadmin"
DB_PASS="fromspace"
DB_NAME="postfixadmin"
EMAIL="contact@exemple.com"
DOMAIN="exemple.com"
PASSWORD="MotDePasse123!"
NAME="Service Contact"
# Générer le hash du mot de passe (BLF-CRYPT recommandé)
HASH=$(doveadm pw -s BLF-CRYPT -p "$PASSWORD")
# Insérer le compte dans MySQL
mysql -u "$DB_USER" -p"$DB_PASS" "$DB_NAME" <<EOF
INSERT INTO mailbox (username, password, name, maildir, quota, local_part, domain, active, created, modified)
VALUES (
'$EMAIL',
'$HASH',
'$NAME',
'$EMAIL/',
0, -- quota illimité (0)
'\${EMAIL%%@*}', -- partie avant @
'$DOMAIN',
1, -- actif
NOW(),
NOW()
);
EOF
Vérification:
mysql -u postfixadmin -p postfixadmin -e "SELECT username, name, domain, active FROM mailbox WHERE username='contact@exemple.com';"
Devrait afficher:
+---------------------+-----------------+-------------+--------+ | username | name | domain | active | +---------------------+-----------------+-------------+--------+ | contact@exemple.com | Service Contact | exemple.com | 1 | +---------------------+-----------------+-------------+--------+
Dépannage: - Si “Duplicate entry”: le compte existe déjà - Si “Foreign key constraint fails”: le domaine n’existe pas dans MySQL - Si erreur MySQL: vérifier les credentials
2. Créer la structure Maildir
Pourquoi: Dovecot a besoin de cette structure de répertoires pour stocker les emails.
Automatique avec le script: Le script add-account.sh fait ceci automatiquement.
Manuel:
EMAIL="contact@exemple.com"
MAILDIR="/home/\${EMAIL}/Maildir"
# Créer la structure Maildir
mkdir -p "$MAILDIR"/{cur,new,tmp}
mkdir -p "$MAILDIR"/.Junk/{cur,new,tmp}
mkdir -p "$MAILDIR"/.Trash/{cur,new,tmp}
mkdir -p "$MAILDIR"/.Sent/{cur,new,tmp}
mkdir -p "$MAILDIR"/.Drafts/{cur,new,tmp}
# Permissions (vmail:vmail, user ID 5000:5000)
chown -R 5000:5000 "$MAILDIR"
chmod -R 700 "$MAILDIR"
Vérification:
ls -lan /home/contact@exemple.com/Maildir/
Devrait afficher:
drwx------ 7 5000 5000 4096 Jan 3 16:00 . drwxr-xr-x 3 root root 4096 Jan 3 16:00 .. drwx------ 2 5000 5000 4096 Jan 3 16:00 cur drwx------ 2 5000 5000 4096 Jan 3 16:00 new drwx------ 2 5000 5000 4096 Jan 3 16:00 tmp drwx------ 5 5000 5000 4096 Jan 3 16:00 .Junk drwx------ 5 5000 5000 4096 Jan 3 16:00 .Sent ...
Dépannage: - Si permissions incorrectes: vérifier avec ls -lan (devrait afficher UID/GID 5000) - Si erreur “Permission denied” lors de réception: vérifier les permissions avec chmod -R 700
Étapes IMPORTANTES
Ces étapes doivent être faites dans les 24 heures pour vérifier que le compte fonctionne correctement.
3. Tester la réception d’emails
Pourquoi: Vérifier que Postfix et Dovecot peuvent bien livrer les emails dans le compte.
Test A: Depuis un autre serveur (recommandé):
- Envoyez un email depuis Gmail/Outlook vers le nouveau compte
- Vérifier la réception:
ls -la /home/contact@exemple.com/Maildir/new/
Devrait afficher le fichier de l’email reçu.
Test B: Depuis le serveur:
echo "Test de réception" | mail -s "Test" -r test@gmail.com contact@exemple.com
Vérifier les logs:
tail -f /var/log/mail.log | grep contact@exemple.com
Vous devriez voir:
postfix/lmtp[xxx]: xxx: to=<contact@exemple.com>, relay=mail.apsi.net[...], status=sent (250 2.0.0 OK ...)
Dépannage: - Si “User unknown”: le compte n’existe pas dans MySQL ou Postfix ne trouve pas le compte - Si “Permission denied”: vérifier les permissions du Maildir - Si logs montrent “relay access denied”: le domaine n’est pas dans virtual_mailbox_domains
4. Tester l’envoi d’emails
Pourquoi: Vérifier que le compte peut envoyer des emails via SMTP authentifié.
Test avec telnet/openssl:
# Générer le login base64
echo -ne "\0contact@exemple.com\0MotDePasse123!" | base64
# Résultat: AGNvbnRhY3RAZXhlbXBsZS5jb20ATW90RGVQYXNzZTEyMyE=
# Se connecter en SMTP avec STARTTLS
{
sleep 1
echo "EHLO localhost"
sleep 1
echo "AUTH PLAIN AGNvbnRhY3RAZXhlbXBsZS5jb20ATW90RGVQYXNzZTEyMyE="
sleep 1
echo "MAIL FROM:<contact@exemple.com>"
sleep 1
echo "RCPT TO:<destination@gmail.com>"
sleep 1
echo "DATA"
sleep 1
echo "Subject: Test envoi depuis contact@exemple.com"
echo "From: contact@exemple.com"
echo "To: destination@gmail.com"
echo ""
echo "Test d'envoi d'email depuis le compte nouvellement créé."
echo ""
echo "."
sleep 1
echo "QUIT"
} | nc localhost 25
Réponse attendue:
235 2.7.0 Authentication successful 250 2.1.0 Ok 250 2.1.5 Ok 354 End data with <CR><LF>.<CR><LF> 250 2.0.0 Ok: queued as XXXXXXXXX
Vérifier les logs:
tail -f /var/log/mail.log | grep contact@exemple.com
Devrait afficher la signature DKIM et l’envoi réussi.
Dépannage: - Si “Authentication failed”: vérifier le mot de passe ou le hash dans MySQL - Si “Relay access denied”: l’authentification a échoué - Si email rejeté par destinataire: vérifier SPF/DKIM du domaine
5. Tester la connexion IMAP
Pourquoi: Vérifier que le compte peut se connecter via IMAP (Thunderbird, Outlook, etc.).
Test manuel:
# Test IMAP sur port 993 (IMAPS)
timeout 10 openssl s_client -connect mail.apsi.net:993 -servername mail.apsi.net <<EOF
a1 LOGIN contact@exemple.com MotDePasse123!
a2 LIST "" "*"
a3 SELECT INBOX
a4 LOGOUT
EOF
Réponse attendue:
a1 OK [CAPABILITY ...] Logged in a2 OK List completed * FLAGS (\Answered \Flagged \Deleted \Seen \Draft) a3 OK [READ-WRITE] Select completed * BYE Logging out a4 OK Logout completed
Test avec un client mail:
Paramètres de configuration:
Serveur IMAP: mail.apsi.net Port: 993 Sécurité: SSL/TLS Nom d'utilisateur: contact@exemple.com Mot de passe: MotDePasse123! Serveur SMTP: mail.apsi.net Port: 587 Sécurité: STARTTLS Authentification: Oui (même identifiants)
Dépannage: - Si “Authentication failed”: vérifier le mot de passe - Si timeout: vérifier que Dovecot écoute sur le port 993 - Si certificat invalide: vérifier le certificat SSL avec openssl s_client
6. Vérifier que les emails sortants sont bien signés DKIM
Pourquoi: S’assurer que les emails envoyés depuis ce compte ont la signature DKIM du domaine.
Envoi d’un email de test:
{
sleep 1
echo "EHLO localhost"
sleep 1
echo "MAIL FROM:<contact@exemple.com>"
sleep 1
echo "RCPT TO:<contact@exemple.com>"
sleep 1
echo "DATA"
sleep 1
echo "Subject: Test DKIM"
echo "From: contact@exemple.com"
echo "To: contact@exemple.com"
echo ""
echo "Test de signature DKIM pour ce compte."
echo ""
echo "."
sleep 1
echo "QUIT"
} | nc localhost 25
# Attendre quelques secondes pour la livraison
sleep 5
# Vérifier la signature DKIM dans l'email reçu
grep -r "DKIM-Signature" /home/contact@exemple.com/Maildir/new/
Résultat attendu:
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=exemple.com; s=mail;
Dépannage: - Si pas de signature: vérifier la configuration rspamd pour le domaine - Si signature invalide: vérifier que la clé DNS correspond à la clé privée - Voir les logs rspamd: journalctl -u rspamd | grep -i dkim | tail -20
Étapes OPTIONNELLES
Configuration avancée pour améliorer l’expérience utilisateur.
7. Configurer un quota pour le compte (optionnel)
Pourquoi: Limiter l’espace disque utilisé par le compte.
Définir un quota de 1 GB:
mysql -u postfixadmin -p postfixadmin <<EOF
UPDATE mailbox SET quota = 1024000000 WHERE username = 'contact@exemple.com';
EOF
Vérifier le quota:
doveadm quota get -u contact@exemple.com
Devrait afficher:
Quota name Type Value Limit % user STORAGE 0 1024 0 user MESSAGE 0 - 0
Dépannage: - Si quota non appliqué: vérifier /etc/dovecot/conf.d/90-quota.conf - Si erreur: vérifier les logs Dovecot: journalctl -u dovecot | grep quota
8. Créer des alias pour ce compte (optionnel)
Pourquoi: Permettre à plusieurs adresses d’arriver dans la même boîte.
Exemple: info@exemple.com → contact@exemple.com
mysql -u postfixadmin -p postfixadmin <<EOF
INSERT INTO alias (address, goto, domain, active, created, modified)
VALUES ('info@exemple.com', 'contact@exemple.com', 'exemple.com', 1, NOW(), NOW());
EOF
Vérification:
echo "Test alias" | mail -s "Test" -r externe@gmail.com info@exemple.com
# Vérifier que l'email arrive dans contact@exemple.com
ls -la /home/contact@exemple.com/Maildir/new/
Dépannage: - Si email non livré: vérifier que l’alias existe dans MySQL - Si erreur de boucle: ne pas créer d’alias qui pointe vers lui-même
9. Configurer des règles Sieve personnalisées (optionnel)
Pourquoi: Permettre le tri automatique des emails (filtres par expéditeur, sujet, etc.).
Créer un script Sieve personnel:
EMAIL="contact@exemple.com"
SIEVE_DIR="/home/\${EMAIL}/sieve"
SIEVE_FILE="$SIEVE_DIR/default.sieve"
# Créer le répertoire
mkdir -p "$SIEVE_DIR"
# Créer le script Sieve
cat > "$SIEVE_FILE" <<'EOF'
require ["fileinto", "imap4flags"];
# Déplacer spam vers Junk
if header :contains "X-Spam" "Yes" {
fileinto "Junk";
stop;
}
# Déplacer emails de certains expéditeurs vers un dossier spécial
if address :is "from" "newsletter@exemple.com" {
fileinto "Newsletters";
stop;
}
# Marquer les emails importants
if header :contains "subject" "URGENT" {
setflag "\\\\Flagged";
}
EOF
# Compiler le script
sievec "$SIEVE_FILE"
# Permissions
chown -R 5000:5000 "$SIEVE_DIR"
chmod -R 700 "$SIEVE_DIR"
Créer les dossiers IMAP nécessaires:
mkdir -p "/home/contact@exemple.com/Maildir/.Newsletters"/{cur,new,tmp}
chown -R 5000:5000 "/home/contact@exemple.com/Maildir/.Newsletters"
Test:
Envoyer un email avec “URGENT” dans le sujet et vérifier qu’il est marqué comme important.
Dépannage: - Si règle ne s’applique pas: vérifier la syntaxe avec sievec -d - Si dossier non créé: le créer manuellement avec mkdir -p - Vérifier les logs: grep sieve /var/log/mail.log
10. Documenter le compte
Créer un fichier de référence:
mkdir -p /root/docs
nano /root/docs/contact@exemple.com-info.txt
Contenu suggéré:
Compte Email: contact@exemple.com Domaine: exemple.com Date de création: 2026-01-03 Créé par: admin === Informations de connexion === Nom complet: Service Contact Serveur IMAP: mail.apsi.net:993 (SSL/TLS) Serveur SMTP: mail.apsi.net:587 (STARTTLS) Authentification: contact@exemple.com / [mot de passe] === Configuration === Quota: 1 GB (1024000000 octets) Maildir: /home/contact@exemple.com/Maildir/ Sieve: /home/contact@exemple.com/sieve/ === Alias === - info@exemple.com → contact@exemple.com === Règles Sieve === - Spam vers Junk automatiquement - Newsletters vers dossier Newsletters - Emails URGENT marqués comme importants === Tests === - Réception: OK (2026-01-03) - Envoi: OK (2026-01-03) - IMAP: OK (2026-01-03) - SMTP: OK (2026-01-03) - Signature DKIM: OK (2026-01-03) === Notes === - Utilisé pour le service client - Surveiller le quota régulièrement
Scripts utiles
Lister tous les comptes d’un domaine
mysql -u postfixadmin -p postfixadmin -e "SELECT username, name, quota, active FROM mailbox WHERE domain='exemple.com';"
Changer le mot de passe d’un compte
EMAIL="contact@exemple.com"
NEW_PASSWORD="NouveauMotDePasse456!"
# Générer le hash
HASH=$(doveadm pw -s BLF-CRYPT -p "$NEW_PASSWORD")
# Mettre à jour dans MySQL
mysql -u postfixadmin -p postfixadmin -e "UPDATE mailbox SET password='$HASH', modified=NOW() WHERE username='$EMAIL';"
echo "Mot de passe mis à jour pour $EMAIL"
Supprimer un compte
ATTENTION: Cette opération est irréversible !
EMAIL="contact@exemple.com"
# Supprimer de MySQL
mysql -u postfixadmin -p postfixadmin <<EOF
DELETE FROM mailbox WHERE username='$EMAIL';
DELETE FROM alias WHERE goto='$EMAIL';
EOF
# Supprimer le Maildir
rm -rf "/home/\${EMAIL}"
echo "Compte $EMAIL supprimé"
Vérifier l’utilisation du quota
# Pour un compte spécifique
doveadm quota get -u contact@exemple.com
# Pour tous les comptes
mysql -u postfixadmin -p postfixadmin -e "SELECT username, quota, ROUND(quota/1024/1024, 2) AS quota_mb FROM mailbox WHERE quota > 0;"
Checklist finale
Avant de considérer le compte comme “en production”:
- ☐ Compte créé dans MySQL (PostfixAdmin)
- ☐ Structure Maildir créée avec bonnes permissions
- ☐ Test de réception réussi (depuis Gmail/Outlook)
- ☐ Test d’envoi réussi (vers Gmail/Outlook)
- ☐ Connexion IMAP fonctionnelle
- ☐ Connexion SMTP authentifiée fonctionnelle
- ☐ Signature DKIM vérifiée sur emails sortants
- ☐ Quota configuré (si nécessaire)
- ☐ Alias créés (si nécessaire)
- ☐ Règles Sieve configurées (si nécessaire)
- ☐ Documentation créée
- ☐ Paramètres communiqués à l’utilisateur
Dépannage général
Impossible de se connecter en IMAP
Vérifier que le compte existe:
mysql -u postfixadmin -p postfixadmin -e "SELECT username, active FROM mailbox WHERE username='contact@exemple.com';"
Vérifier le mot de passe:
doveadm auth test contact@exemple.com MotDePasse123!
Vérifier les logs Dovecot:
journalctl -u dovecot | grep contact@exemple.com | tail -20
Emails non reçus
Vérifier que le compte est actif dans MySQL
Vérifier les permissions du Maildir:
ls -lan /home/contact@exemple.com/Maildir/
Devrait afficher UID/GID 5000
Vérifier les logs:
grep "contact@exemple.com" /var/log/mail.log | tail -20
Emails envoyés marqués comme spam
- Vérifier la signature DKIM du domaine
- Tester avec mail-tester.com
- Vérifier les enregistrements DNS (SPF, DKIM, DMARC)
- Vérifier que l’IP n’est pas blacklistée
Quota dépassé
Vérifier l’utilisation actuelle:
du -sh /home/contact@exemple.com/Maildir/
Augmenter le quota:
mysql -u postfixadmin -p postfixadmin -e "UPDATE mailbox SET quota=2048000000 WHERE username='contact@exemple.com';"
Nettoyer les anciens emails (dans Trash, Junk)
Ressources
- Guide création domaine:
/root/scripts/GUIDE_CREATION_DOMAINE.md - Documentation Dovecot: https://doc.dovecot.org/
- Documentation Sieve: https://doc.dovecot.org/configuration_manual/sieve/
- Tester compte email: https://www.smtper.net/
Dernière mise à jour: 2026-01-03 Version: 2.0 (architecture rspamd + ClamAV)