Info:: apsi.net: GUIDE CREATION COMPTE

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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

  1. Prérequis
  2. Étapes URGENTES - À faire immédiatement
  3. Étapes IMPORTANTES - À faire dans les 24h
  4. É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é):

  1. Envoyez un email depuis Gmail/Outlook vers le nouveau compte
  2. 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

  1. Vérifier que le compte existe:

    mysql -u postfixadmin -p postfixadmin -e "SELECT username, active FROM mailbox WHERE username='contact@exemple.com';"
    
  2. Vérifier le mot de passe:

    doveadm auth test contact@exemple.com MotDePasse123!
    
  3. Vérifier les logs Dovecot:

    journalctl -u dovecot | grep contact@exemple.com | tail -20
    

Emails non reçus

  1. Vérifier que le compte est actif dans MySQL

  2. Vérifier les permissions du Maildir:

    ls -lan /home/contact@exemple.com/Maildir/
    

    Devrait afficher UID/GID 5000

  3. Vérifier les logs:

    grep "contact@exemple.com" /var/log/mail.log | tail -20
    

Emails envoyés marqués comme spam

  1. Vérifier la signature DKIM du domaine
  2. Tester avec mail-tester.com
  3. Vérifier les enregistrements DNS (SPF, DKIM, DMARC)
  4. Vérifier que l’IP n’est pas blacklistée

Quota dépassé

  1. Vérifier l’utilisation actuelle:

    du -sh /home/contact@exemple.com/Maildir/
    
  2. Augmenter le quota:

    mysql -u postfixadmin -p postfixadmin -e "UPDATE mailbox SET quota=2048000000 WHERE username='contact@exemple.com';"
    
  3. Nettoyer les anciens emails (dans Trash, Junk)



Ressources



Dernière mise à jour: 2026-01-03 Version: 2.0 (architecture rspamd + ClamAV)