164 lines
6.0 KiB
Markdown
164 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.
|
|
* `dovecot_proto_managesieve_enable` (`yes`): activar
|
|
managesieve. Debe estar habilitado Sieve.
|
|
|
|
### 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_quota_enable` (`yes`): activar plugin quota.
|
|
* `dovecot_quota_driver` (`count`): driver de quota. Opciones
|
|
posibles: `count`, `maildir`.
|
|
* `dovecot_quota_limit` (`4096M`): límite global de la cuota de
|
|
usuario.
|
|
* `dovecot_quota_additional_limit`: (`{Trash: 100M }`): límites
|
|
adicionales para casillas específicas.
|
|
* `dovecot_quota_grace` (`10%`): gracia de la cuota (en % o M).
|
|
|
|
### Sieve
|
|
|
|
* `dovecot_sieve_enable` (`yes`): activar plugin sieve.
|
|
* `dovecot_sieve_before` (`/etc/dovecot/sieve/before`): directorio con
|
|
scripts ejecutados antes que los del usuario.
|
|
* `dovecot_sieve_after` (`/etc/dovecot/sieve/after`): directorio con
|
|
scripts ejecutados después que los del usuario.
|
|
|
|
### 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.
|