completando README ...
This commit is contained in:
Mauro Torrez
parent
4f8870cedc
commit
617ecb4d97
180
README.md
180
README.md
@ -1,3 +1,181 @@
|
|||||||
# ansible-role-dovecot
|
# ansible-role-dovecot
|
||||||
|
|
||||||
Rol para instalación y configuración de Dovecot.
|
Este rol instala y configura el servidor IMAP Dovecot.
|
||||||
|
|
||||||
|
## Configuración
|
||||||
|
|
||||||
|
### 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.
|
||||||
|
|
||||||
|
### Generales
|
||||||
|
|
||||||
|
* `dovecot_mailbox_junk` (`Junk`): Nombre de la carpeta de spam.
|
||||||
|
* `dovecot_mailbox_format` (`dbox`): formato del mailbox. Valores
|
||||||
|
posibles: `dbox`, `mdbox`, `sdbox`, `maildir`.
|
||||||
|
* `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_user_home: "{{ vmail_home }}/mail/%d/%n" carpeta "home" de los usuarios de dovecot
|
||||||
|
|
||||||
|
dovecot_auth_username_format: "%Lu" como transformar el nombre de usuario antes de autenticar
|
||||||
|
|
||||||
|
|
||||||
|
dovecot_auth_mechanisms: "plain" mecanismos de autenticacion: agregar login para compat. outlook
|
||||||
|
|
||||||
|
|
||||||
|
dovecot_auth_system_enable: no habilitar userdb/passdb de usuarios del sistema?
|
||||||
|
|
||||||
|
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_auth_master_enable: no habilitar usuarios master?
|
||||||
|
|
||||||
|
|
||||||
|
### 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"
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user