From dec895003655a089b37470448ae1950c0db2c886 Mon Sep 17 00:00:00 2001
From: whirigoyen <whirigoyen+intra@evolix.fr>
Date: Tue, 23 Jan 2024 18:10:22 +0100
Subject: [PATCH] Ajout section Erreur SMTP

---
 HowtoMail/Roundcube.md | 92 ++++++++++++++++++++++++++++++++++--------
 1 file changed, 76 insertions(+), 16 deletions(-)

diff --git a/HowtoMail/Roundcube.md b/HowtoMail/Roundcube.md
index cb61e498..3c277741 100644
--- a/HowtoMail/Roundcube.md
+++ b/HowtoMail/Roundcube.md
@@ -15,7 +15,9 @@ La configuration se fait dans `/etc/roundcube/config.inc.php`.
 Il ne faut pas modifier le fichier de configuration par défaut (`/etc/roundcube/defaults.inc.php`).
 
 
-## Plugin sieve
+## Plugins
+
+### Plugin sieve
 
 Celui-ci permet l'usage de filtres, notamment l'envoi de messages d’absence ou de vacances (utilisé à Evolix pour les comptes mails virtuels).
 
@@ -32,7 +34,7 @@ $config['plugins'] = array('sieverules');
 La configuration des règles se feront dans `/etc/roundcube/plugins/sieverules/config.inc.php`.
 
 
-## Plugin vacation
+### Plugin vacation
 
 Pour envoyer des messages d'absence, on privilégie l'utilisation de [filtres Sieve](#plugin-sieve) dans Roundcube (Préférences > Filtres). A Evolix, on l'utilise pour les comptes mails virtuels configurés dans LDAP.
 
@@ -41,7 +43,7 @@ Pour les comptes mails Unix, on utilise le plugin Roundcube vacation suivant (at
 Sinon, on peut utiliser ce fork qui englobe la traduction française : <https://github.com/leeroyke/roundcube-vacation-plugin>
 
 
-### Installation du plugin vacation
+#### Installation du plugin vacation
 
 On utilise généralement ce plugin avec le driver FTP lorsque l'on est dans un setup avec les utilisateurs en compte Unix.
 Il faut donc préalablement avoir installé Proftpd, avec le module ldap `proftpd-mod-ldap` et bien charger le module dans la configuration de proftpd.
@@ -82,14 +84,14 @@ always_keep_message = true
 Il ne faut pas oublier également d'installer le paquet *vacation*.
 
 
-### Utilisation du plugin vacation
+#### Utilisation du plugin vacation
 
 Voir [/HowtoPostfix#forward]() et [/HowtoPostfix#vacation]()
 
 Attention : Il est important de préciser les alias dans l'interface, sinon le mail de vacation ne sera pas envoyé.
 
 
-## Plugin password
+### Plugin password
 
 Son utilisé résulte sur la possibilité de changer son propre mot de passe avec de nombreux connecteurs tel que dovecot, LDAP, etc.
 
@@ -113,17 +115,14 @@ $config['password_ldap_encodage'] = 'ssha';
 ~~~
 
 
-## Mailbox doesn’t exist
+## Import de contacts en CSV 
 
-Si nous avons par exemple l'erreur suivante : "UID MOVE : Mailbox doesn’t exist : Trash"
+<https://www.pokorra.de/2017/01/import-contacts-via-csv-into-roundcube/>
 
-On devra activer cette option :
 
-~~~
-$config['create_default_folders'] = true;
-~~~
+## FAQ / Troubleshooting
 
-## Mode debug
+### Mode debug
 
 On spécifie le mode file pour sélectionner le debug que l'on souhaite activer :
 
@@ -153,13 +152,18 @@ $config['ldap_debug'] = false;
 $config['smtp_debug'] = false;
 ~~~
 
-## Import de contacts en CSV 
 
-<https://www.pokorra.de/2017/01/import-contacts-via-csv-into-roundcube/>
+### Mailbox doesn’t exist
+
+Si nous avons par exemple l'erreur suivante : "UID MOVE : Mailbox doesn’t exist : Trash"
+
+On devra activer cette option :
+
+~~~
+$config['create_default_folders'] = true;
+~~~
 
 
-## FAQ
- 
 ### Problème d’envoi de pièce jointe
 
 Il n'y a aucune erreur affichée dans l'interface web de Rouncube, mais les pièces jointes ne sont plus envoyées.
@@ -183,3 +187,59 @@ Pour solutionner temporairement le problème :
 # chown www-roundcube:roundcube /var/lib/roundcube/temp
 ```
 
+
+### `Erreur SMTP (220) : échec d’authentification`
+
+Le port par défaut est maintenant 587.
+
+Si Roundcube se connecte à Postfix en local, on peut repasser sur le port 25.
+
+Si on a besoin de rester sur le port 587, il peut manquer les options de configuration TLS dans `/etc/roundcube/config.inc.php` :
+
+Debian >= 12 (`smtp_server` renommé `smtp_host` et inclue le port) :
+
+~~~
+## SSL
+$config['smtp_host'] = 'localhost:587';
+## ou TLS
+$config['smtp_host'] = 'tls://localhost:587';
+
+$config['smtp_conn_options'] = array(
+  'ssl'         => array(
+    'verify_peer'  => true,
+    'verify_depth' => 3,
+    'cafile'       => '/etc/ssl/certs/ca-certificates.crt',
+  ),
+);
+~~~
+
+Debian < 12 :
+
+~~~
+## SSL
+$config['smtp_server'] = 'localhost';
+## ou TLS
+$config['smtp_server'] = 'tls://localhost';
+
+$config['smtp_port'] = '587';
+
+$config['smtp_conn_options'] = array(
+  'ssl'         => array(
+    'verify_peer'  => true,
+    'verify_depth' => 3,
+    'cafile'       => '/etc/ssl/certs/ca-certificates.crt',
+  ),
+);
+~~~
+
+Si le certificat n'est pas valide ou auto-signé, on peut désactiver la vérification :
+
+~~~
+$config['smtp_conn_options'] = array(
+  'ssl' => array(
+    'verify_peer'      => false,
+    'verify_peer_name' => false,
+  ),
+);
+~~~
+