Login Logout

HowtoDovecot

Howto Dovecot

Installation

Dovecot est un puissant serveur POP et IMAP. Pour l’installer sous Debian :

# aptitude install dovecot-pop3d dovecot-imapd

Configuration

La configuration de Dovecot se trouve dans le répertoire /etc/dovecot et notamment le fichier dovecot.conf.

Pour activer les protocoles POP(S) et IMAP(S) :

protocols = imap imaps pop3 pop3s

Pour autoriser l’authentification en clair même sans SSL/TLS (attention, les identifiants circuleront donc en clair !!) :

disable_plaintext_auth = no

Support du + dans les adresses

Il faut patcher le master.cf de postfix ainsi :

-  flags=DRhu user=vmail:vmail argv=/usr/lib/dovecot/deliver -f ${sender} -d ${recipient}                      
+  flags=DRhu user=vmail:vmail argv=/usr/lib/dovecot/deliver -f ${sender} -a ${recipient} -d ${user}@${nexthop}

Crée des boîtes IMAP automatiquement

Voir http://wiki2.dovecot.org/MailboxSettings

namespace inbox {
  location =
  mailbox Drafts {
    auto = no
    special_use = \\Drafts
  }
  mailbox Sent {
    auto = subscribe
    special_use = \\Sent
  }
  mailbox Spam {
    auto = subscribe
    special_use = \\Junk
  }
  mailbox Trash {
    auto = no
    special_use = \\Trash
  }
  prefix =
}

SSL/TLS

ssl_cert = </etc/ssl/certs/mail.example.com.cert
ssl_key = </etc/ssl/private/mail.example.com.key
ssl_ca = </etc/ssl/certs/sub.class1.server.ca.pem

Utiliser Dovecot/LDA pour utiliser le langage Sieve

Dovecot/LDA (ou deliver) est un agent de livraison fourni avec Dovecot, que Postfix peut utiliser pour délivrer les mails dans les maildir des utilisateurs d’un serveur mail. Celui-ci prend notamment en charge le langage “sieve”, qui offre des fonctionnalités du même type que le programme “procmail”.

# aptitude install dovecot-common

/etc/postfix/master.cf :

dovecot  unix  -  n  n  -  -  pipe flags=DORqhu user=dovelda
    argv=sudo /usr/lib/dovecot/deliver -n -f ${sender} -d ${recipient}

/etc/postfix/main.cf :

virtual_transport dovecot
dovecot_destination_recipient_limit = 1

Dans la configuration de sudo :

Defaults:dovelda !syslog
dovelda ALL=NOPASSWD:/usr/lib/dovecot/deliver

/etc/dovecot/dovecot.conf :

protocols = none
log_timestamp = "%Y-%m-%d %H:%M:%S "
mail_privileged_group = mail
mail_location = maildir:~
protocol imap {
}
protocol pop3 {
  pop3_uidl_format = %08Xu%08Xv
}
protocol sieve {
}
protocol lda {
  auth_socket_path = /var/run/dovecot/auth-master
  mail_plugins = sieve
  postmaster_address = postmaster@example.com
}
auth default {
  mechanisms = plain
  userdb ldap {
    args = /etc/dovecot/dovecot-ldap.conf
  }
  passdb ldap {
    args = /etc/dovecot/dovecot-ldap.conf
  }
  user = root
  socket listen {
    # for LDA
    master {
      path = /var/run/dovecot/auth-master
      mode = 666
      user = dovecot
    }
  }
}
dict {
}
plugin {
}

/etc/dovecot/dovecot-ldap.conf :

hosts = 127.0.0.1
base = dc=example,dc=com
ldap_version = 3
user_filter = (&(objectClass=mailAccount)(isActive=TRUE)(courierActive=TRUE)(uid=%u))
pass_attrs = uid=user,userPassword=password,homeDirectory=userdb_home,uidNumber=userdb_uid,gidNumber=userdb_gid
#dn = cn=courier,ou=ldapuser,dc=example,dc=com
#dnpass = xxx
#user_attrs = homeDirectory=home,uidNumber=uid,gidNumber=gid

On peut alors créer des fichiers .dovecot.sieve de ce type dans le $HOME d’un utilisateur, qui seront traités par dovecot/LDA :

Simple :

require ["vacation"];

if anyof (true)
{
	vacation
		:days 1
		:subject "Message d'absence"
		text:
Bonjour,

Veuillez utiliser email@example.net à présent pour me contacter.

Cordialement,
.
;
}
require ["fileinto", "copy", "vacation", "variables"];

# Exemple d'une règle de filtrage
if header :contains ["Subject"] ["testsieve"] {
  fileinto "Test";
}

# Exemple de message "vacation"
if header :matches "subject" "*" {
  vacation :days 3 :subject "Re: ${1}" "Bonjour,

Je suis indispo jusqu'au DD/MM/YYYY.

";
}

Langage Sieve

On peut donc écrire des règles Sieve dans le fichier .dovecot.sieve

Voici quelques liens pour écrire les règles : http://support.tigertech.net/sieve http://sieve.info/tutorials

On peut aussi utiliser des outils pour générer les règles comme Roundcube, Horde/Ingo, etc. voir http://sieve.info/clients

Debug

Regarder dans le fichier .dovecot.sieve.log

Déduplication des mails entrants

Pour réaliser un équivalent de la règle procmail suivante :

:0 Wh: msgid.lock
| formail -D 8192 $HOME/.msgid.lock

Testé avec Dovecot 2.2.13 en Jessie.

Ajouter le plugin sieve duplicate dans /etc/dovecot/conf.d/90-sieve.conf :

  sieve_extensions = +vnd.dovecot.duplicate

Puis dans les règles sieve :

require ["fileinto","vnd.dovecot.duplicate"];
if duplicate {
    fileinto "Trash";
}
# Si on est sûr de vouloir les supprimer
#if duplicate {
#     discard;
#}

Note : la ligne require doit être unique et en début de fichier, si des modules sont déjà chargés il suffit d’ajouter “vnd.dovecot.duplicate”.

En Jessie-backports, version 2.2.27, « duplicate » est intégré. Et il faut mettre dans une règle sieve :

require ["duplicate", "variables"];
if header :matches "message-id" "*" {
  if duplicate :uniqueid "${0}" {
  discard;
  }
}

Mode debug

Activer le raw logging

http://wiki.dovecot.org/Debugging/Rawlog

Par exemple en IMAP, il faut activer cela dans le dovecot.conf :

protocol imap {
  mail_executable = /usr/lib/dovecot/rawlog /usr/lib/dovecot/imap
}

Ensuite, il suffit de créer un répertoire dovecot.rawlog dans le $HOME de l’utilisateur (accessible en écriture évidemment), et toutes les commandes IMAP passées seront stockées dans des fichiers : <annee><mois><jour>-.*.{in,out}

Debug pour l’authentification

Activer :

# queries.
auth_debug = yes
#auth_debug_passwords = yes

Nombre max de processus de login

À chaque login, dovecot fork un processus. Afin d’éviter les fork-bomb s’il y a trop de connexions il y a une limite par défaut à 128. L’augmenter peut résoudre des problèmes si le serveur reçoit de nombreuses connexions.

login_max_processes_count = 256

Il faut en parallèle augmenter la limite sur le nombre de fichiers ouverts, dans /etc/default/dovecot :

ulimit -n 5696

Nombre max de connexion par IP+Login

Dovecot limite également le nombre de connexion IMAP d’une même IP avec un même compte. Cette limite est de 10 par défaut, il est possible de l’augmenter en ajoutant dans la section IMAP :

mail_max_userip_connections = 42

Si la limite n’est pas assez haute, on aura cette erreur :

dovecot: imap-login: Maximum number of connections from user+IP exceeded (mail_max_userip_connections)

Mountpoints

http://wiki2.dovecot.org/Mountpoints

Erreurs de LOCK

Si vous avez des chargements très longs à l’authentification ou des erreurs de type :

-ERR [IN-USE] Couldn't open INBOX: Timeout while waiting for lock

c’est peut-être que les locks sont activés pour le protocole POP3. Ainsi, dès qu’une connexion POP3 est en cours, elle bloques les autres connexions POP3… et même IMAP. Pour résoudre cela, s’assurer d’avoir activé :

pop3_lock_session=no

Munin

Plusieurs plugins Munin sont disponibles sur https://github.com/munin-monitoring/contrib/search?q=dovecot

Nous utilisons principalement https://raw.githubusercontent.com/munin-monitoring/contrib/master/plugins/mail/dovecot à télécharger dans /etc/munin/plugins/ avec les droits 755 que l’on fait tourner avec le groupe adm via /etc/munin/plugin-conf.d/munin-node :

[dovecot]
group adm

doveadm

La commande doveadm permet d’avoir différentes interactions avec le serveur Dovecot. Par exemple :

# doveadm who
username                           # proto (pids)                                                  (ips)
jdoe@example.com                   1 imap  (4242)                                                  ()

# doveadm kick foo 192.0.2.0/24
kicked connections from the following users:
foo

FAQ

Erreur “Out of memory”

Si vous avez des erreurs du type :

dovecot: imap(foo): Fatal: block_alloc(16777216): Out of memory
dovecot: imap(foo): Fatal: master: service(imap): child 666 returned error 83 (Out of memory (service imap { vsz_limit=256 MB }, you may need to increase it))

Vous pouvez augmenter la mémoire vsz_limit = 512M dans le service imap.

Vérifier la conf

Pour vérifier qu’il n’y a pas d’erreur dans la conf

# doveconf -n

Il se peut que la configuration soit bonne mais qu’il y ait tout de même une erreur (un certificat ssl qui n’existe pas, par exemple), on peut alors lancer dovecot en mode debug

# dovecot -F