ansible-role-dovecot-docker/README.md

ansible-role-dovecot

Este rol instala y configura el servidor IMAP Dovecot.

Configuración

• vmail_home (/srv/vmail): home del usuario vmail.

Generales

• dovecot_user_home ({{ vmail_home }}/mail/%d/%n): carpeta home de cada usuario.
• dovecot_mail_location ({{dovecot_mailbox_format}}:~/dbox o maildir:~/Maildir según el valor de dovecot_mailbox_format): ubicación de los mails de cada usuario.
• dovecot_mailbox_junk (Junk): Nombre de la carpeta de spam.
• dovecot_mailbox_format (dbox): formato del mailbox. Valores posibles: dbox, mdbox, sdbox, maildir.
• dovecot_auth_username_format (%Lu): formato del nombre de usuario utilizado para autenticar.
• dovecot_auth_mechanisms (plain): mecanismos de autenticación, agregar login para compatibilidad con MS Outlook.
• dovecot_auth_system_enable (no): habilitar login para usuarios del sistema.
• dovecot_auth_master_enable (no): habilitar usuarios master.

Protocolos

• dovecot_proto_imap_enable (yes): activar IMAP.
• dovecot_proto_imaps_enable (no) activar IMAPS.
• dovecot_proto_pop3_enable (no) activar POP3.
• dovecot_proto_pop3s_enable (no) activar POP3S.

SSL

• dovecot_ssl_enable (yes): habilitar ssl.
• dovecot_ssl_require (no): requerir ssl.
• dovecot_ssl_cert ({{ tls_certificate }}): path absoluto al certificado SSL.
• dovecot_ssl_key ({{ tls_certificate_key }}): path absoluto a la clave privada SSL.

LDAP

dovecot_auth_ldap_enable: yes habilitar userdb/passdb ldap?

dovecot_auth_ldap_servers: [ "localhost" ] servidores ldap

dovecot_auth_ldap_version: 3 version del protocolo LDAP

dovecot_auth_ldap_base: ou=People,dc=%Dd base para la busqueda en LDAP

dovecot_auth_ldap_scope: subtree scope para la busqueda en ldap: base, onelevel, subtree

dovecot_auth_ldap_user_filter: (&(objectClass=inetOrgPerson)(uid=%n)) filtro para obtener la entrada del usuario LDAP

dovecot_auth_ldap_pass_filter: (&(objectClass=inetOrgPerson)(uid=%n)) filtro para obtener la clave del usuario LDAP

dovecot_auth_ldap_user_attrs: > =home={{ dovecot_user_home }}, =uid={{ vmail_user }}, =gid={{ vmail_group }} atributos del usuario leidos de LDAP por defecto, usar valores pre-calculados

dovecot_auth_ldap_pass_attrs: > userPassword=password, =userdb_home={{ dovecot_user_home }}, =userdb_uid={{ vmail_user }}, =userdb_gid={{ vmail_group }} clave + atributos del usuario leidos de LDAP por defecto, usar valores pre-calculados

dovecot_auth_ldap_iterate_attrs: =user=%{ldap:uid}@%d iteracion con doveadm CAVEAT: al usar %Dd en ldap_base, no se puede utilizar doveadm -A, sino que siempre se debe especificar un dominio usando -u *@dominio

dovecot_auth_ldap_iterate_attrs: uid=user cuando ldap_base es fija (sin %Dd):

dovecot_auth_ldap_iterate_filter: (objectClass=inetOrgPerson) filtro para iteracion: este filtro debe devolver todas las personas de tipo usuario

dovecot_auth_ldap_default_pass_scheme: CRYPT esquema de clave en ldap -- no se para que se utilizaría

Antispam

dovecot_plugin_antispam_enable: yes Activar el plugin antispam?

dovecot_plugin_antispam: opciones del plugin antispam

backend: pipe crm114, dspam, pipe, spool2dir

signature: X-Bogosity Header que indica que el mail ha sido escaneado para spam

pipe_program: /usr/bin/bogofilter Pipe: programa que entrena leyendo el mail en STDIN

pipe_program_args: -l antispam_pipe_program_args = --for;%u

pipe_program_notspam_arg: -n Pipe: argumento que indica que el mail NO ES spam

pipe_program_spam_arg: -s Pipe: argumento que indica que el mail ES spam

pipe_tmpdir: /tmp Pipe: directorio temporal (creo que el mail se copia ahi primero)

signature_missing: error accion cuando se mueve un mail que no tiene signature de/hacia spam valores posibles: error: fallar en la operacion move: mover el mensaje de todos modos

spam: Junk;junk;Junk Mail;Spam;spam;SPAM nombres de las carpetas de spam

trash: Trash;trash;mail/trash;Deleted Messages nombres de las carpetas de papelera

debug del plugin antispam debug_enable: no debug_target: syslog debug_verbosity: 0

Quota

dovecot_plugin_quota_enable: yes activar plugin quota?

dovecot_plugin_quota: opciones de quota

driver: count, maildir driver: count

limit: 4096M limite global de la cuota de usuario (en M)

mailbox_additional_limit: limites adicionales para casillas especificas Trash: 100M

grace: 10% gracia (en porcentaje o M)

Sieve/Managesieve

dovecot_proto_managesieve_enable: yes activar managesieve?

dovecot_plugin_sieve_enable: yes activar plugin sieve?

dovecot_plugin_sieve: opciones de sieve

dir con scripts ejecutados antes que los del usuario before: /etc/dovecot/sieve/before

dir con scripts ejecutados luego de los del usuario after: /etc/dovecot/sieve/after

Single-instance storage para adjuntos

• dovecot_sis_enable (yes): Indica si activar single-instance storage para los adjuntos.
• dovecot_sis_directory: ({{ vmail_home }}/attachments): lugar donde se guardan los adjuntos desduplicados.
• dovecot_sis_min_size (128k): tamaño minimo de adjuntos a guardar en SIS.
• dovecot_sis_hash (%{sha1}): hash a usar para desduplicar.
• dovecot_sis_queue_enable (no): habilitar desduplicacion postergada,
• dovecot_sis_queue_directory ({{vmail_home}}/attachments-queue): carpeta donde se guardan los pendientes para desduplicar.

Carpeta alternativa para correo

• dovecot_altstorage_enable (no): habilitar uso de carpeta alternativa de correo.
• dovecot_altstorage_directory ({{ vmail_home }}/alt-storage): carpeta alternativa de correo.