udelarinterior.sympa

Descripción general Versiones Perspectivas

sympa

Este es un rol de Ansible que configura un administrador de listas de correo Sympa.

Requisitos

Servidor Debian stretch o Ubuntu. Opciones de base de datos MySQL/MariaDB o PostgreSQL. El administrador de la base de datos puede estar previamente instalado en el host (predeterminado) u opcionalmente instalado por el propio rol. El servidor web para Sympa debe configurarse en otro lugar.

Variables del rol

Para la documentación completa, véase https://sympa-community.github.io/. Este rol se probó con la versión de Sympa 6.2.16 (paquete sympa de Debian stretch).

Plantillas de listas

sympa_template_lists es una lista de plantillas a definir. Para su contenido, consulte la documentación de plantillas de lista de sympa. Cada entrada consta de lo siguiente y dará lugar a que se cree una carpeta que contenga comment.tt2 y config.tt2, que se creará en /etc/sympa/create_list_templates/ con el atributo name como nombre de carpeta:

Nombre	Requerido/Por defecto	Descripción
`name`	:heavy_check_mark:	Nombre de la carpeta para la plantilla
`config`	:heavy_check_mark:	Contenido que se escribirá en el archivo `config.tt2`
`comment`	:heavy_check_mark:	Contenido que se escribirá en el archivo `comment.tt2`

Fuentes de datos

sympa_data_sources es una lista de fuentes de datos a definir. Para su contenido, consulte la documentación de fuentes de datos de sympa. Cada entrada consta de lo siguiente y dará lugar a que se cree un archivo con la extensión incl en /etc/sympa/data_sources/:

Nombre	Requerido/Por defecto	Descripción
`name`	:heavy_check_mark:	Nombre del archivo para la fuente de datos
`content`	:heavy_check_mark:	Contenido que se escribirá en el archivo de la fuente de datos

Administrador de alias

sympa_alias_manager es la ruta al ejecutable del administrador de alias. Si se define la variable sympa_ldap_alias_entry, se escribirá en /etc/sympa/ldap_alias_entry.tt2. Si se define la variable sympa_ldap_alias_manager_conf, se escribirá en /etc/sympa/ldap_alias_manager.conf y puede contener los siguientes valores:

Nombre	Requerido/Por defecto	Descripción
`host`	:heavy_check_mark:	URL del host del servidor LDAP.
`bind_dn`	:heavy_check_mark:	DN de enlace del usuario a utilizar.
`bind_pwd`	:heavy_check_mark:	Contraseña del usuario.
`base_dn`	:heavy_check_mark:	DN base del árbol LDAP.
`mail_attribute`	`mailRoutingAddress`	Atributo utilizado para escribir.
`ssl`	`false`	Habilitar o deshabilitar SSL
`queue_transport`	`sympa`	Nombre del transporte normal.
`bouncequeue_transport`	`sympabounce`	Nombre del transporte cuando un correo rebota.

Variables de autenticación

sympa_auth es una lista de métodos de autenticación utilizados en orden. Cada entrada consta de lo siguiente:

Nombre	Requerido/Por defecto	Descripción
`name`	:heavy_check_mark:	Nombre de la opción de autenticación como ldap, user_table
`options`	:heavy_check_mark:	Diccionario de opciones para el método de autenticación

Ejemplo

sympa_auth:
- name: ldap
  options:
    host: ldap.example.com:636
    timeout: 20
    suffix: yoursuffix
    bind_dn: yourbinddn
    bind_password: yourpw
    use_tls: ldaps
    ca_verify: none
    get_dn_by_uid_filter: "(uid=[sender])"
    email_attribute: mail
    scope: sub
    authentication_info_url: https://example.com
- name: user_table
  options:
    regexp: ".*"

Variables de temas

Lista de temas bajo la clave sympa_topics. Cada entrada de lista contiene lo siguiente:

Nombre	Requerido/Por defecto	Descripción
`path`	:heavy_check_mark:	Ruta de la categoría
`title`	:heavy_check_mark:	Título de la categoría

Ejemplo

sympa_topics:
- path: art
  title: Art
- path: art/expressionism
  title: Expressionism

Administrador de base de datos

Nombre	Requerido/Por defecto	Descripción
`sympa_db_type`	`mysql`	Elección del administrador de base de datos. `MySQL` o `Pg`. Se aceptan valores `mysql` y `PostgreSQL`. Otras opciones de base de datos no están gestionadas.
`sympa_install_db_package`	`False`	Si el administrador de base de datos está instalado previamente (`False`) o el rol lo instala (`True`)

Variables de Sympa

Nombre	Requerido/Por defecto	Descripción
`sympa_domain`	`"{{ ansible_fqdn }}"`	Nombre de host principal del robot
`sympa_listmaster`	`listmaster@{{ sympa_domain }}`	Lista de direcciones de correo electrónico para promover a listmaster
`sympa_wwsympa_url`	:heavy_check_mark:	URL de la página web principal
`sympa_email`	:heavy_multiplication_x:	Parte local de la dirección de correo de sympa
`sympa_db_password`	:heavy_check_mark:	Contraseña para la conexión a la base de datos
`sympa_db_name`	`sympa`	Nombre de la base de datos
`sympa_db_host`	`localhost`	Nombre del servidor de la base de datos
`sympa_db_port`	`3306`	Puerto del servidor de la base de datos
`sympa_db_user`	`sympa`	Usuario para la conexión a la base de datos
`sympa_lang`	`en`	Idioma predeterminado (uno de los idiomas admitidos) #supported_lang ca,cs,de,el,es,et,en-US,fr,fi,hu,it,ja,ko,nl,nb,oc,pl,pt-BR,ru,sv,tr,vi,zh-CN,zh-TW
`sympa_logo_html_definition`	:heavy_multiplication_x:	Fragmento HTML para colocar el logo en la esquina superior izquierda
`sympa_gecos`	`SYMPA`	Gecos para el correo de servicio enviado por Sympa.
`sympa_process_archive`	`False`	Almacenar mensajes distribuidos en el archivo
`sympa_voot_feature`	`False`	Funcionalidad Voot
`sympa_max_wrong_password`	`19`	Cantidad de intentos fallidos de contraseña
`sympa_static_content_path`	`/var/lib/sympa/static_content`	Directorio para almacenar contenidos estáticos
`sympa_static_content_url`	`/static-sympa`	URL mapeada con el directorio `sympa_static_content_path`
`sympa_syslog`	`LOCAL1`	Instalación de syslog para sympa
`sympa_log_level`	`0`	Verbosidad de registro 0: normal, 2,3,4: para depuraciones
`sympa_log_socket_type`	`unix`	Modo de comunicación con syslogd (unix,inet)
`sympa_sendmail`	`/usr/bin/sendmail`	Ruta al MTA (sendmail, postfix, exim o qmail) debe apuntar a un binario compatible con sendmail (por ejemplo: un binario llamado "sendmail" se distribuye con Postfix)
`sympa_maxsmtp`	`40`	Máx. número de procesos de Sendmail (lanzados por Sympa) corriendo
`sympa_log_smtp`	`False`
`sympa_use_blacklist`	`[ send, create_list ]`	Lista de operaciones para las que se aplica el filtro de lista negra. Una lista vacía desactivará la función.
`sympa_max_size`	`5242880`	Tamaño máximo predeterminado (en bytes) para mensajes (se puede redefinir para cada lista)
`sympa_sendmail_nrcpt`	`25`	Número máximo de destinatarios por llamada a Sendmail. El archivo nrcpt_by_domain.conf permite un ajuste diferente por dominio de destino.
`sympa_sendmail_avg`	`10`	Max. número de dominios diferentes por llamada a Sendmail
`sympa_rfc2369_header_fields`	`[help, subscribe, unsubscribe, post, owner, archive ]`	Especificar qué encabezados de lista de correo rfc2369 agregar
`sympa_remove_headers`	[ `X-Sympa-To, X-Family-To, Return-Receipt-To, Precedence, X-Sequence, Disposition, Notification-To, Sender ]`	Especificar campos de encabezado a eliminar antes de la distribución del mensaje
`sympa_reject_mail_from_automates_feature`	`True`	¿Rechazar correos de automatizaciones (crontab, etc.) enviados a una lista?
`sympa_packet_priority`	`5`	Prioridad predeterminada para un paquete enviado en masa.
`sympa_bulk_fork_threshold`	`1`	Número mínimo de paquetes en la base de datos antes de que el bulk se divida para aumentar la tasa de envío
`sympa_bulk_max_count`	`3`	Número máximo de envío en masa que se ejecutarán en el mismo servidor
`sympa_bulk_lazytime`	`600`	El número de segundos que un bulk esclavo permanecerá ejecutándose sin procesar un mensaje antes de morir espontáneamente.
`sympa_bulk_sleep`	`1`	El número de segundos que un bulk duerme entre el inicio de un nuevo ciclo si no encontró un mensaje para enviar.
`sympa_bulk_wait_to_fork`	`10`	Número de segundos que un bulk maestro espera entre dos chequeos de número de paquetes.
`sympa_default_max_list_members`	`0`	Límite predeterminado para el número de suscriptores por lista (0 significa sin límite)
`sympa_spool`	`/var/spool/sympa`	Directorio que contiene varios spools especializados
`sympa_queue`	`/var/spool/sympa/msg`	Directorio para el spool de mensajes entrantes
`sympa_queuemod`	`/var/spool/sympa/moderation`	Directorio para el spool de moderación
`sympa_queuedigest`	`/var/spool/sympa/digest`	Directorio para el spool de digest
`sympa_queueauth`	`/var/spool/sympa/auth`	Directorio para el spool de autenticación
`sympa_queueoutgoing`	`/var/spool/sympa/outgoing`	Directorio para el spool de archivo
`sympa_queuesubscribe`	`/var/spool/sympa/subscribe`	Directorio para el spool de suscripciones
`sympa_queuetopic`	`/var/spool/sympa/topic`	Directorio para el spool de temas
`sympa_queuebounce`	`/var/spool/sympa/bounce`	Directorio para el spool de rebotes entrantes
`sympa_queuetask`	`/var/spool/sympa/task`	Directorio para el spool de tareas
`sympa_queueautomatic`	`/var/spool/sympa/automatic`	Directorio para el spool de creación de listas automáticas
`sympa_queuebulk`	`/var/spool/sympa/bulk`	Directorio para el spool de mensajes salientes
`sympa_viewmail_dir`	`/var/spool/sympa/viewmail`	Directorio que contiene archivos HTML generados por MHonArc mientras se muestran mensajes que no son archivos
`sympa_welcome_return_path`	`owner`	Ruta de retorno del mensaje de bienvenida ( único, owner ) Si se establece en único, el nuevo suscriptor se elimina si el mensaje de bienvenida rebota
`sympa_remind_return_path`	`owner`	Ruta de retorno del mensaje de recordatorio ( único, owner ) Si se establece en único, el suscriptor se elimina si el mensaje de recordatorio rebota, usar con cuidado
`sympa_bounce_path`	`/var/lib/sympa/bounce`	Directorio para almacenar rebotes. Mejor si no está en una partición crítica
`sympa_expire_bounce`	`daily`	Nombre de la tarea para la expiración de rebotes antiguos
`sympa_bounce_warn_rate`	`30`	Tasa de correos rebote para advertir al propietario de la lista
`sympa_bounce_halt_rate`	`50`	Tasa de correos rebote para detener la lista (no implementado)
`sympa_cache_list_config`	`none`	Uso de la versión binaria de la estructura de configuración de la lista en disco (none, binary_file)
`sympa_sympa_priority`	`1`	Prioridad de comandos de Sympa
`sympa_request_priority`	`0`
`sympa_owner_priority`	`9`
`sympa_default_list_priority`	`5`	Prioridad predeterminada para mensajes de lista
`sympa_parsed_family_files`	`[message.footer, message.header, message.footer.mome, message.header.mime, info ]`	Lista de archivos que serán analizados por Sympa al instanciar una familia (no se permiten espacios en los nombres de archivo)
`sympa_dkim_feature`	`False`
`sympa_dkim_add_signature_to`	`[ robot, list ]`	Insertar una firma DKIM en mensajes del robot, de la lista o de ambos
`sympa_dkim_signature_apply_on`	`[md5_authenticated_messages, smime_authenticated_messages, dkim_authenticated_messages, editor_validated_messages ]`	Tipo de mensaje al que se le añade una firma DKIM antes de la distribución a los suscriptores. Es una lista de las siguientes palabras clave: "md5_authenticated_messages", "smime_authenticated_messages", "dkim_authenticated_messages", "editor_validated_messages".
`sympa_dkim_private_key_path`	`/etc/ssl/dkim_private.key`	Ubicación del archivo donde se almacena la clave privada DKIM
`sympa_dkim_signer_domain`	:heavy_multiplication_x:	La etiqueta "d=" según se define en rfc 4871, por defecto es el nombre de dominio del host virtual
`sympa_dkim_selector`	:heavy_multiplication_x:	El selector
`sympa_dkim_signer_identity`	:heavy_multiplication_x:	La etiqueta "i=" según se define en rfc 4871, por defecto es nulo
`sympa_antivirus_path`	:heavy_multiplication_x:	Ruta al motor del escáner antivirus soportado: Clam AntiVirus/clamscan & clamdscan, McAfee/uvscan, Fsecure/fsav, Sophos, AVP y Trend Micro/VirusWall
`sympa_antivirus_args`	:heavy_multiplication_x:	Argumento de comando del plugin antivirus
`sympa_antispam_tag_header_name`	`X-Spam-Status`	Si un filtro de spam (como spamassassin o j-chkmail) agrega encabezados smtp para etiquetar correos no deseados, nombre de este encabezado (ejemplo X-Spam-Status)
`sympa_antispam_tag_header_spam_regexp`	:heavy_multiplication_x:	Expresión regular aplicada a este encabezado para verificar que el mensaje es spam (ejemplo Sí)
`sympa_antispam_tag_header_ham_regexp`	:heavy_multiplication_x:	Expresión regular aplicada a este encabezado para verificar que el mensaje NO es spam (ejemplo No)
`sympa_spam_status`	:heavy_multiplication_x:	Los mensajes se suponen filtrados por un antispam que agrega un encabezado adicional a los mensajes. Este parámetro se utiliza para seleccionar un escenario especial para decidir el estado de spam del mensaje: ham, spam o inseguro. Este parámetro reemplaza antispam_tag_header_name, antispam_tag_header_spam_regexp y antispam_tag_header_ham_regexp.
`sympa_arc_path`	`/var/lib/sympa/arc`	Directorio para almacenar archivos HTML de archivo
`sympa_default_index`	`thrd`	Organización de índice predeterminada al entrar en el archivo web: ya sea en hilo o en orden cronológico
`sympa_cookie_expire`	`0`	Tiempo de vida de las cookies HTTP
`sympa_cookie_domain`	`localhost`	Dominio de validez de las cookies HTTP
`sympa_cookie_refresh`	`60`	Intervalo promedio para refrescar el ID de sesión HTTP.
`sympa_custom_archiver`	:heavy_multiplication_x:	Activa un archivador personalizado para usar en lugar de MHonArc. El valor de este parámetro es la ruta absoluta en el sistema de archivos al script del archivador personalizado.
`sympa_default_home`	`home`	Tipo de página web principal (listas, inicio)
`sympa_edit_list`	`owner`
`sympa_ldap_force_canonical_email`	`1`	Cuando se utiliza la autenticación LDAP, si el identificador proporcionado por el usuario era un correo electrónico válido, si este parámetro se establece en falso, se utilizará el correo electrónico proporcionado para autenticar al usuario. De lo contrario, se usará la primera dirección de correo electrónico devuelta por el servidor LDAP.
`sympa_review_page_size`	`25`	Número predeterminado de líneas del array que se muestra a los usuarios en la página de revisión
`sympa_web_page_title`	`Servicio de listas de correo`	Título de la página web principal
`sympa_show_default_templates`	`false`	Mostrar u ocultar las plantillas de lista predeterminadas
`sympa_template_lists`	`[]`	Lista de plantillas a definir.
`sympa_data_sources`	`false`	Lista de fuentes de datos a definir.
`sympa_alias_manager`	``	Ruta al ejecutable del administrador de alias.
`sympa_ldap_alias_entry`	``	Cadena de múltiples líneas, escrita en `/etc/sympa/ldap_alias_entry.tt2`.
`sympa_ldap_alias_manager_conf`	``	Diccionario que contiene atributos de configuración del administrador de alias
`sympa_auth`	`[{ name: "user:table", options: {regexp: ".*"}}]`	Lista de métodos de autenticación utilizados en orden.

Variables de robots de Sympa

sympa_robots es una lista de definiciones de robots de Sympa, vacía por defecto. Cada entrada contiene

Nombre	Requerido/Por defecto	Descripción
`domain`	:heavy_check_mark:	Dominio del correo y web del robot
`server_admin`	:heavy_check_mark:	Administrador de VHost del servidor web
`listmaster`	:heavy_check_mark:	Lista de entradas de correo de listmasters
`create_list`