173 lines
6.0 KiB
Markdown
173 lines
6.0 KiB
Markdown
# 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.
|