Servicios de correo (Manual de referencia de GNU Guix)

11.10.13 Servicios de correo

El módulo (gnu services mail) proporciona definiciones de servicios Guix para servicios de correo electrónico: servidores IMAP, POP3 y LMTP, así como agentes de transporte de correo (MTA). ¡Muchos acrónimos! Estos servicios se detallan en las subsecciones a continuación.

Servicio Dovecot

Variable: dovecot-service-type: Type for the service that runs the Dovecot IMAP/POP3/LMTP mail server, whose value is a <dovecot-configuration> object.

Habitualmente Dovecot no necesita mucha configuración; el objeto de configuración predeterminado creado por (dovecot-configuration) es suficiente si su correo se entrega en ~/Maildir. Un certificado auto-firmado se generará para las conexiones protegidas por TLS, aunque Dovecot también escuchará en puertos sin cifrar de manera predeterminada. Existe un amplio número de opciones no obstante, las cuales las administradoras del correo puede que deban cambiar, y como en el caso de otros servicios, Guix permite a la administradora del sistema la especificación de dichos parámetros a través de una interfaz Scheme uniforme.

Por ejemplo, para especificar que el correo se encuentra en maildir:~/.correo, se debe instanciar el servicio de Dovecot de esta manera:

(service dovecot-service-type
         (dovecot-configuration
           (mail-location "maildir:~/.mail")))

A continuación se encuentran los parámetros de configuración disponibles. El tipo de cada parámetro antecede la definición del mismo; por ejemplo, ‘string-list foo’ indica que el parámetro foo debe especificarse como una lista de cadenas. También existe la posibilidad de especificar la configuración como una cadena, si tiene un archivo dovecot.conf antiguo que quiere trasladar a otro sistema; véase el final para más detalles.

Los campos disponibles de dovecot-configuration son:

parámetro de dovecot-configuration: package dovecot ¶: El paquete dovecot.

parámetro de dovecot-configuration: lista-cadenas-separada-comas listen ¶: Una lista de direcciones IP o nombres de máquina donde se escucharán conexiones. ‘*’ escucha en todas las interfaces IPv4, ‘::’ escucha en todas las interfaces IPv6. Si desea especificar puertos distintos a los predefinidos o algo más complejo, personalice los campos de dirección y puerto del ‘inet-listener’ de los servicios específicos en los que tenga interés.

parámetro de dovecot-configuration: lista-protocol-configuration protocols ¶

Lista de protocolos que se desea ofrecer. Los protocolos disponibles incluyen ‘imap’, ‘pop3’ y ‘lmtp’.

Los campos disponibles de protocol-configuration son:

parámetro de protocol-configuration: string name ¶: El nombre del protocolo.

parámetro de protocol-configuration: string auth-socket-path ¶: Ruta del socket de UNIX del servidor de identificación maestro para la búsqueda de usuarias. Se usa por parte de imap (para usuarias compartidas) y lda. Su valor predeterminado es ‘"/var/run/dovecot/auth-userdb"’.

protocol-configuration parameter: boolean imap-metadata? ¶

Whether to enable the IMAP METADATA extension as defined in RFC 5464, which provides a means for clients to set and retrieve per-mailbox, per-user metadata and annotations over IMAP.

If this is ‘#t’, you must also specify a dictionary via the mail-attribute-dict setting.

El valor predeterminado es ‘#f’

protocol-configuration parameter: space-separated-string-list managesieve-notify-capabilities ¶

Which NOTIFY capabilities to report to clients that first connect to the ManageSieve service, before authentication. These may differ from the capabilities offered to authenticated users. If this field is left empty, report what the Sieve interpreter supports by default.

El valor predeterminado es ‘'()’.

protocol-configuration parameter: space-separated-string-list managesieve-sieve-capability ¶

Which SIEVE capabilities to report to clients that first connect to the ManageSieve service, before authentication. These may differ from the capabilities offered to authenticated users. If this field is left empty, report what the Sieve interpreter supports by default.

El valor predeterminado es ‘'()’.

parámetro de protocol-configuration: list-cadenas-separada-espacios mail-plugins ¶: Lista separada por espacios de módulos a cargar.

parámetro de protocol-configuration: entero-no-negativo mail-max-userip-connections ¶: Número máximo de conexiones IMAP permitido para una usuaria desde cada dirección IP. ATENCIÓN: El nombre de usuaria es sensible a las mayúsculas. Su valor predeterminado es ‘10’.

parámetro de dovecot-configuration: lista-service-configuration services ¶

Lista de servicios activados. Los servicios disponibles incluyen ‘imap’, ‘imap-login’, ‘pop3’, ‘pop3-login’, ‘auth’ y ‘lmtp’.

Los campos disponibles de service-configuration son:

parámetro de service-configuration: string kind ¶: El tipo del servicio. Entre los valores aceptados se incluye director, imap-login, pop3-login, lmtp, imap, pop3, auth, auth-worker, dict, tcpwrap, quota-warning o cualquier otro.

parámetro de service-configuration: lista-listener-configuration listeners ¶

Procesos de escucha para el servicio. Un proceso de escucha es un objeto unix-listener-configuration, un objeto fifo-listener-configuration o un objeto inet-listener-configuration. Su valor predeterminado es ‘'()’.

Los campos disponibles de unix-listener-configuration son:

parámetro de unix-listener-configuration: string path ¶: Ruta al archivo, relativa al campo base-dir. También se usa como nombre de la sección.

parámetro de unix-listener-configuration: string mode ¶: Modo de acceso del socket. Su valor predeterminado es ‘"0600"’.

parámetro de unix-listener-configuration: string user ¶: Usuaria que posee el socket. Su valor predeterminado es ‘""’.

parámetro de unix-listener-configuration: string group ¶: Grupo que posee el socket. Su valor predeterminado es ‘""’.

Los campos disponibles de fifo-listener-configuration son:

parámetro de fifo-listener-configuration: string path ¶: Ruta al archivo, relativa al campo base-dir. También se usa como nombre de la sección.

parámetro de fifo-listener-configuration: string mode ¶: Modo de acceso del socket. Su valor predeterminado es ‘"0600"’.

parámetro de fifo-listener-configuration: string user ¶: Usuaria que posee el socket. Su valor predeterminado es ‘""’.

parámetro de fifo-listener-configuration: string group ¶: Grupo que posee el socket. Su valor predeterminado es ‘""’.

Los campos disponibles de inet-listener-configuration son:

parámetro de inet-listener-configuration: string protocol ¶: El protocolo con el que se esperan las conexiones.

parámetro de inet-listener-configuration: string address ¶: La dirección en la que se escuchará, o vacío para escuchar en todas las direcciones. Su valor predeterminado es ‘""’.

parámetro de inet-listener-configuration: entero-no-negativo port ¶: El puerto en el que esperarán conexiones.

parámetro de inet-listener-configuration: boolean ssl? ¶: Si se usará SSL para este servicio; ‘yes’ (sí), ‘no’ o ‘required’ (necesario). Su valor predeterminado es ‘#t’.

parámetro de service-configuration: entero-no-negativo client-limit ¶

Número máximo de conexiones simultáneas por cliente por proceso. Una vez se reciba este número de conexiones, la siguiente conexión entrante solicitará a Dovecot el inicio de un nuevo proceso. Si se proporciona el valor 0, se usa default-client-limit.

El valor predeterminado es ‘0’.

parámetro de service-configuration: entero-no-negativo service-count ¶: Número de conexiones a manejar antes de iniciar un nuevo proceso. Habitualmente los únicos valores útiles son 0 (ilimitadas) o 1. 1 es más seguro, pero 0 es más rápido. <doc/wiki/LoginProcess.txt>. Su valor predeterminado es ‘1’.

parámetro de service-configuration: entero-no-negativo process-limit ¶

Número máximo de procesos que pueden existir para este servicio. Si se proporciona el valor 0, se usa default-process-limit.

El valor predeterminado es ‘0’.

parámetro de service-configuration: entero-no-negativo process-min-avail ¶: Número de procesos que siempre permanecerán a la espera de más conexiones. Su valor predeterminado es ‘0’.

parámetro de service-configuration: entero-no-negativo vsz-limit ¶: Si proporciona ‘service-count 0’, probablemente necesitará incrementar este valor. Su valor predeterminado es ‘256000000’.

parámetro de dovecot-configuration: dict-configuration dict ¶

Configuración de Dict, como la creada por el constructor dict-configuration.

Los campos disponibles de dict-configuration son:

parámetro de dict-configuration: campos-libres entries ¶: Una lista de pares clave-valor que este diccionario debe incorporar. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: lista-passdb-configuration passdbs ¶

Una lista de configuraciones de passdb, cada una creada por el constructor passdb-configuration.

Los campos disponibles de passdb-configuration son:

parámetro de passdb-configuration: string driver ¶: El controlador que passdb debe usar. Entre los valores aceptados se incluye ‘pam’, ‘passwd’, ‘shadow’, ‘bsdauth’ y ‘static’. Su valor predeterminado es ‘"pam"’.

parámetro de passdb-configuration: lista-cadenas-separada-espacios args ¶: Lista de parámetros separados por espacios para proporcionar al controlador passdb. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: lista-userdb-configuration userdbs ¶

Lista de configuraciones userdb, cada una creada por el constructor userdb-configuration.

Los campos disponibles de userdb-configuration son:

parámetro de userdb-configuration: string driver ¶: El controlador que userdb debe usar. Entre los valores aceptados se incluye ‘passwd’ y ‘static’. Su valor predeterminado es ‘"passwd"’.

parámetro de userdb-configuration: lista-cadenas-separada-espacios args ¶: Lista separada por espacios de parámetros usados para el controlador userdb. Su valor predeterminado es ‘""’.

parámetro de userdb-configuration: parámetros-libres override-fields ¶: Sustituye los valores de campos de passwd. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: plugin-configuration plugin-configuration ¶: Configuración del módulo, creada por el constructor plugin-configuration.

parámetro de dovecot-configuration: lista-namespace-configuration namespaces ¶

Lista de espacios de nombres. Cada elemento de la lista debe crearse con el constructor namespace-configuration.

Los campos disponibles de namespace-configuration son:

parámetro de namespace-configuration: string name ¶: Nombre para este espacio de nombres.

parámetro de namespace-configuration: string type ¶: Tipo del espacio de nombres: ‘private’, ‘shared’ o ‘public’. Su valor predeterminado es ‘"private"’.

parámetro de namespace-configuration: string separator ¶: Hierarchy separator to use. You should use the same separator for all namespaces or some clients get confused. ‘/’ is usually a good one. The default however depends on the underlying mail storage format. Defaults to ‘""’.

parámetro de namespace-configuration: string prefix ¶: Prefix required to access this namespace. This needs to be different for all namespaces. For example ‘Public/’. Defaults to ‘""’.

parámetro de namespace-configuration: string location ¶: Localización física de la bandeja de correo. En el mismo formato que la localización del correo, que también es su valor predeterminado. Su valor predeterminado es ‘""’.

parámetro de namespace-configuration: boolean inbox? ¶: Únicamente puede existir una bandeja de entrada (INBOX), y esta configuración define qué espacio de nombres la posee. Su valor predeterminado es ‘#f’.

parámetro de namespace-configuration: boolean hidden? ¶: If namespace is hidden, it’s not advertised to clients via NAMESPACE extension. You’ll most likely also want to set ‘list? #f’. This is mostly useful when converting from another server with different namespaces which you want to deprecate but still keep working. For example you can create hidden namespaces with prefixes ‘~/mail/’, ‘~%u/mail/’ and ‘mail/’. Defaults to ‘#f’.

parámetro de namespace-configuration: boolean list? ¶: Show the mailboxes under this namespace with the LIST command. This makes the namespace visible for clients that do not support the NAMESPACE extension. The special children value lists child mailboxes, but hides the namespace prefix. Defaults to ‘#t’.

parámetro de namespace-configuration: boolean subscriptions? ¶: El espacio de nombres maneja sus propias subscripciones. Si es #f, el espacio de nombres superior las maneja. El prefijo vacío siempre debe tener este valor como #t. Su valor predeterminado es ‘#t’.

parámetro de namespace-configuration: lista-mailbox-configuration mailboxes ¶

Lista de bandejas de correo predefinidas en este espacio de nombres. Su valor predeterminado es ‘'()’.

Los campos disponibles de mailbox-configuration son:

parámetro de mailbox-configuration: string name ¶: Nombre de esta bandeja de correo.

parámetro de mailbox-configuration: string auto ¶: Con ‘create’ se crea de forma automática esta bandeja de correo. Con ‘subscribe’ se crea y se suscribe a la bandeja de correo. Su valor predeterminado es ‘"no"’.

parámetro de mailbox-configuration: lista-cadenas-separada-espacios special-use ¶: Lista de atributos SPECIAL-USE de IMAP como se especifican en el RFC 6154. Entre los valores aceptados se incluye \All, \Archive, \Drafts, \Flagged, \Junk, \Sent y \Trash. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: nombre-archivo base-dir ¶: Directorio base donde se almacenan los datos de tiempo de ejecución. Su valor predeterminado es ‘"/var/run/dovecot/"’.

parámetro de dovecot-configuration: string login-greeting ¶: Mensaje de saludo para clientes. Su valor predeterminado es ‘"Dovecot ready."’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios login-trusted-networks ¶: Lista de rangos de red en los que se confía. Las conexiones desde estas IP tienen permitido forzar sus direcciones IP y puertos (para el registro y las comprobaciones de identidad). ‘disable-plaintext-auth’ también se ignora en estas redes. Habitualmente aquí se especificarían los servidores proxy IMAP. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios login-access-sockets ¶: Lista de sockets para la comprobación de acceso al sistema (por ejemplo tcpwrap). Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: boolean verbose-proctitle? ¶: Muestra títulos de procesamiento más detallados (en la postdata). Actualmente muestra el nombre de la usuaria y su dirección IP. Es útil para ver quién está usando procesos IMAP realmente (por ejemplo bandejas de correo compartidas o si el mismo identificador numérico de usuaria se usa para varias cuentas). Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean shutdown-clients? ¶: Determina si se deben finalizar todos los procesos cuando el proceso maestro de Dovecot termine su ejecución. El valor #f significa que Dovecot puede actualizarse sin forzar el cierre de las conexiones existentes (aunque esto puede ser un problema si la actualización se debe, por ejemplo, a la corrección de una vulnerabilidad). Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: entero-no-negativo doveadm-worker-count ¶: Si no es cero, ejecuta las ordenes del correo a través de este número de conexiones al servidor doveadm, en vez de ejecutarlas directamente en el mismo proceso. Su valor predeterminado es ‘0’.

parámetro de dovecot-configuration: string doveadm-socket-path ¶: Socket UNIX o máquina:puerto usados para la conexión al servidor doveadm. Su valor predeterminado es ‘"doveadm-server"’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios import-environment ¶: Lista de variables de entorno que se preservan al inicio de Dovecot y se proporcionan a los procesos iniciados. También puede proporcionar pares clave=valor para proporcionar siempre dicha configuración específica.

parámetro de dovecot-configuration: boolean disable-plaintext-auth? ¶: Desactiva la orden LOGIN y todas las otras identificaciones en texto plano a menos que se use SSL/TLS (capacidad LOGINDISABLED). Tenga en cuenta que si la IP remota coincide con la IP local (es decir, se ha conectado desde la misma máquina), la conexión se considera segura y se permite la identificación en texto plano. Véase también la configuración ‘ssl=required’. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: entero-no-negativo auth-cache-size ¶: Tamaño de la caché de identificaciones (por ejemplo, ‘#e10e6’. 0 significa que está desactivada. Tenga en cuenta que bsdauth, PAM y vpopmail necesitan un valor en ‘cache-key’ para que se use la caché. Su valor predeterminado es ‘0’.

parámetro de dovecot-configuration: string auth-cache-ttl ¶: Tiempo de vida de los datos almacenados en caché. Los registros de caché no se usan tras su expiración, *excepto* si la base de datos principal devuelve un fallo interno. También se intentan manejar los cambios de contraseña de manera automática: si la identificación previa de la usuaria fue satisfactoria, pero no esta última, la caché no se usa. En estos momentos únicamente funciona con identificación en texto plano. Su valor predeterminado es ‘"1 hour"’.

parámetro de dovecot-configuration: string auth-cache-negative-ttl ¶: Tiempo de vida para fallos de búsqueda en la caché (usuaria no encontrada, la contraseña no coincide). 0 desactiva completamente su almacenamiento en caché. Su valor predeterminado es ‘"1 hour"’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios auth-realms ¶: Lista de dominios para los mecanismos de identificación de SASL que necesite. Puede dejarla vacía si no desea permitir múltiples dominios. Muchos clientes simplemente usarán el primero de la lista, por lo que debe mantener el dominio predeterminado en primera posición. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: string auth-default-realm ¶: Dominio predeterminado usado en caso de no especificar ninguno. Esto se usa tanto en dominios SASL y como al añadir @dominio al nombre de usuaria en los ingresos al sistema a través de texto en claro. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string auth-username-chars ¶: Lista de caracteres permitidos en los nombres de usuaria. Si el nombre de usuaria proporcionado contiene un carácter no enumerado aquí, el login falla automáticamente. Es únicamente una comprobación adicional para asegurarse de que las usuarias no pueden explotar ninguna potencial vulnerabilidad con el escape de comillas en bases de datos SQL/LDAP. Si desea permitir todos los caracteres, establezca este valor a la cadena vacía. Su valor predeterminado es ‘"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890.-_@"’.

parámetro de dovecot-configuration: string auth-username-translation ¶: Traducciones de caracteres de nombres de usuaria antes de que se busque en las bases de datos. El valor contiene series de caracteres "original -> transformado". Por ejemplo ‘#@/@’ significa que ‘#’ y ‘/’ se traducen en ‘@’. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string auth-username-format ¶: Formato proporcionado al nombre de usuaria antes de buscarlo en las bases de datos. Puede usar variables estándar aquí, por ejemplo %Lu transformará el nombre a minúsculas, %n eliminará el fragmento del dominio si se proporcionó, o ‘%n-AT-%d’ cambiaría ‘@’ en ‘-AT-’. Esta traducción se realiza tras los cambios de ‘auth-username-translation’. Su valor predeterminado es ‘"%Lu"’.

parámetro de dovecot-configuration: string auth-master-user-separator ¶: Si desea permitir que usuarias maestras ingresen mediante la especificación del nombre de usuaria maestra dentro de la cadena de nombre de usuaria normal (es decir, sin usar el mecanismo para ello implementado por SASL), puede especificar aquí el carácter separador. El formato es entonces <usuaria><separador><usuaria maestra>. UW-IMAP usa ‘*’ como separador, por lo que esa puede ser una buena elección. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string auth-anonymous-username ¶: Usuaria usada para las usuarias que ingresen al sistema con el mecanismo de SASL ANONYMOUS. Su valor predeterminado es ‘"anonymous"’.

parámetro de dovecot-configuration: entero-no-negativo auth-worker-max-count ¶: Número máximo de procesos de trabajo dovecot-auth. Se usan para la ejecución de consultas bloqueantes a passdb y userdb (por ejemplo MySQL y PAM). Se crean y destruyen bajo demanda de manera automática. Su valor predeterminado es ‘30’.

parámetro de dovecot-configuration: string auth-gssapi-hostname ¶: Nombre de máquina usado en los nombres de GSSAPI principales. Por omisión se usa el nombre devuelto por gethostname(). Use ‘$ALL’ (con comillas) para permitir todas las entradas keytab. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string auth-krb5-keytab ¶: Keytab de Kerberos usado para el mecanismo GSSAPI. Si no se especifica ninguno, se usa el predeterminado del sistema (habitualmente /etc/krb5.keytab). Puede ser necesario cambiar el servicio auth para que se ejecute como root y tenga permisos de lectura sobre este archivo. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: boolean auth-use-winbind? ¶: Se identifica con NTLM y GSS-SPNEGO mediante el uso del daemon winbind de Samba y la herramienta auxiliar ‘ntlm-auth’. <doc/wiki/Authentication/Mechanisms/Winbind.txt>. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: nombre-archivo auth-winbind-helper-path ¶: Ruta al binario de la herramienta auxiliar ‘ntlm-auth’ de Samba. Su valor predeterminado es ‘"/usr/bin/ntlm_auth"’.

parámetro de dovecot-configuration: string auth-failure-delay ¶: Tiempo de espera antes de responder a identificaciones fallidas. Su valor predeterminado es ‘"2 secs"’.

parámetro de dovecot-configuration: boolean auth-ssl-require-client-cert? ¶: Es necesario un certificado de cliente SSL válido o falla la identificación. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean auth-ssl-username-from-cert? ¶: Toma el nombre de usuaria del certificado de cliente SSL, mediante el uso de X509_NAME_get_text_by_NID(), que devuelve el nombre común (CommonName) del nombre de dominio (DN) del sujeto del certificado. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios auth-mechanisms ¶: Lista de mecanismos de identificación deseados. Los mecanismos permitidos son: ‘plain’, ‘login’, ‘digest-md5’, ‘cram-md5’, ‘ntlm’, ‘rpa’, ‘apop’, ‘anonymous’, ‘gssapi’, ‘otp’, ‘key’, and ‘gss-spnego’. Véase también la opción de configuración ‘disable-plaintext-auth’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios director-servers ¶: Lista de IP o nombres de máquina de los servidores directores, incluyendo este mismo. Los puertos se pueden especificar como ip:puerto. El puerto predeterminado es el mismo que el usado por el servicio director ‘inet-listener’. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios director-mail-servers ¶: Lista de IP o nombres de máquina de los servidores motores de correo. Se permiten también rangos, como 10.0.0.10-10.0.0.30. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: string director-user-expire ¶: Por cuanto tiempo se redirige a las usuarias a un servidor específico tras pasar ese tiempo sin conexiones. Su valor predeterminado es ‘"15 min"’.

parámetro de dovecot-configuration: string director-username-hash ¶: Cómo se traduce el nombre de usuaria antes de aplicar el hash. Entre los valores útiles se incluye %Ln si la usuaria puede ingresar en el sistema con o sin @dominio, %Ld si las bandejas de correo se comparten dentro del dominio. Su valor predeterminado es ‘"%Lu"’.

parámetro de dovecot-configuration: string log-path ¶: Archivo de registro usado para los mensajes de error. ‘syslog’ los envía a syslog, ‘"/dev/stderr"’ a la salida de error estándar. Su valor predeterminado es ‘"syslog"’.

parámetro de dovecot-configuration: string info-log-path ¶: Archivo de registro usado para los mensajes informativos. Por omisión se usa ‘log-path’. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string debug-log-path ¶: Archivo de registro usado para los mensajes de depuración. Por omisión se usa ‘info-log-path’. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string syslog-facility ¶: Subsistema de syslog (facility) usado si se envía el registro a syslog. De manera habitual, si desea que no se use ‘mail’, se usará local0..local7. Otros subsistemas estándar también están implementados. Su valor predeterminado es ‘"mail"’.

parámetro de dovecot-configuration: boolean auth-verbose? ¶: Registra los intentos de identificación infructuosos y las razones por los que fallaron. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: string auth-verbose-passwords ¶: En caso de no coincidir la contraseña, registra la contraseña que se intentó. Los valores aceptados son “no”, “plain” y “sha1”. “sha1” puede ser útil para diferenciar intentos de descubrir la contraseña por fuerza bruta frente a una usuaria simplemente intentando la misma contraseña una y otra vez. También puede recortar el valor a n caracteres mediante la adición de ":n" (por ejemplo “sha1:6”). Su valor predeterminado es ‘"no"’.

parámetro de dovecot-configuration: boolean auth-debug? ¶: Registros aún más detallados para facilitar la depuración. Muestra, por ejemplo, las consultas SQL. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean auth-debug-passwords? ¶: En caso de no coincidir la contraseña, registra las contraseñas y esquema usadas de manera que el problema se pueda depurar. La activación de este valor también provoca la activación de ‘auth-debug’. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean mail-debug? ¶: Permite la depuración de los procesos de correo. Puede ayudarle a comprender los motivos en caso de que Dovecot no encuentre sus correos. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean verbose-ssl? ¶: Muestra los errores a nivel de protocolo SSL. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: string log-timestamp ¶: Prefijo de cada línea registrada en el archivo. Los códigos % tienen el formato de strftime(3). Su valor predeterminado es ‘"\"%b %d %H:%M:%S \""’.

parámetro de dovecot-configuration: lista-cadenas-separada-espacios login-log-format-elements ¶: Lista de elementos que se desea registrar. Los elementos que tengan valor de variable no-vacía se unen para la formación de una cadena separada por comas.

parámetro de dovecot-configuration: string login-log-format ¶: Formato del registro de ingresos al sistema. %s contiene la cadena ‘login-log-format-elements’, %$ contiene los datos que se desean registrar. Su valor predeterminado es ‘"%$: %s"’.

parámetro de dovecot-configuration: string mail-log-prefix ¶: Prefijo de los registros de procesos de correo. Véase doc/wiki/Variables.txt para obtener una lista de variables que puede usar. Su valor predeterminado es ‘"\"%s(%u)<%{pid}><%{session}>: \""’.

parámetro de dovecot-configuration: string deliver-log-format ¶

Formato usado para el registro de las entregas de correo. Puede usar las variables:

%$: Mensaje de estado de entrega (por ejemplo: ‘saved to INBOX’)
%m: Message-ID
%s: Asunto
%f: De (dirección)
%p: Tamaño físico
%w: Tamaño virtual.

El valor predeterminado es ‘"msgid=%m: %$"’.

parámetro de dovecot-configuration: string mail-location ¶

Localización de las bandejas de correo de las usuarias. El valor predeterminado está vacío, lo que significa que Dovecot intenta encontrar las bandejas de correo de manera automática. Esto no funciona si la usuaria no tiene todavía ningún correo, por lo que debe proporcionarle a Dovecot la ruta completa.

Si usa mbox, proporcionar una ruta al archivo de la bandeja entrada “INBOX” (por ejemplo /var/mail/%u) no es suficiente. También debe proporcionarle a Dovecot la ruta de otras bandejas de correo. Este es el llamado directorio de correo raíz, y debe ser la primera ruta proporcionada en la opción ‘mail-location’.

Existen algunas variables especiales que puede usar, por ejemplo:

‘%u’: nombre de usuaria
‘%n’: parte de la usuaria en usuaria@dominio, idéntica a %u si no existe dominio
‘%d’: parte del dominio en usuaria@dominio, vacía si no existe dominio
‘%h’: directorio de la usuaria

Véase doc/wiki/Variables.txt para obtener una lista completa. Algunos ejemplos:

‘maildir:~/Correo’
‘mbox:~/correo:INBOX=/var/mail/%u’
‘mbox:/var/mail/%d/%1n/%n:INDEX=/var/indexes/%d/%1n/%’

El valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string mail-uid ¶: Usuaria del sistema y grupo que realizan el acceso al correo. Si se usan varias, userdb puede forzar su valor al devolver campos uid o gid. Se pueden usar tanto identificadores numéricos como nominales. <doc/wiki/UserIds.txt>. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string mail-gid ¶: El valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string mail-privileged-group ¶: Grupo para permitir de forma temporal operaciones privilegiadas. Actualmente esto se usa únicamente con la bandeja de entrada (INBOX), cuando su creación inicial o el bloqueo con archivo .lock falle. Habitualmente se le proporciona el valor ‘"mail"’ para tener acceso a /var/mail. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string mail-access-groups ¶: Proporciona acceso a estos grupos suplementarios a los procesos de correo. Habitualmente se usan para configurar el acceso a bandejas de correo compartidas. Tenga en cuenta que puede ser peligroso establecerlos si las usuarias pueden crear enlaces simbólicos (por ejemplo si se configura el grupo ‘mail’ aquí, ln -s /var/mail ~/mail/var puede permitir a una usuaria borrar las bandejas de correo de otras usuarias, o ln -s /bandeja/compartida/secreta ~/mail/mibandeja permitiría su lectura). Su valor predeterminado es ‘""’.

dovecot-configuration parameter: string mail-attribute-dict ¶

The location of a dictionary used to store IMAP METADATA as defined by RFC 5464.

The IMAP METADATA commands are available only if the “imap” protocol configuration’s imap-metadata? field is ‘#t’.

El valor predeterminado es ‘""’.

parámetro de dovecot-configuration: boolean mail-full-filesystem-access? ¶: Allow full file system access to clients. There’s no access checks other than what the operating system does for the active UID/GID. It works with both maildir and mboxes, allowing you to prefix mailboxes names with e.g. /path/ or ~user/. Defaults to ‘#f’.

parámetro de dovecot-configuration: boolean mmap-disable? ¶: No usa mmap() en absoluto. Es necesario si almacena índices en sistemas de archivos compartidos (NFS o sistemas de archivos en cluster). Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean dotlock-use-excl? ¶: Confía en el correcto funcionamiento de ‘O_EXCL’ para la creación de archivos de bloqueo dotlock. NFS implementa ‘O_EXCL’ desde la versión 3, por lo que debería ser seguro usarlo hoy en día de manera predeterminada. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: string mail-fsync ¶

Cuando se usarán las llamadas fsync() o fdatasync():

optimized: Cuando sea necesario para evitar la perdida de datos importantes
always: Útil con, por ejemplo, NFS, donde las escrituras con write() se aplazan
never: Nunca se usa (mejor rendimiento, pero los fallos pueden producir pérdida de datos)

Su valor predeterminado es ‘"optimized"’.

parámetro de dovecot-configuration: boolean mail-nfs-storage? ¶: Mail storage exists in NFS. Set this to yes to make Dovecot flush NFS caches whenever needed. If you’re using only a single mail server this isn’t needed. Defaults to ‘#f’.

parámetro de dovecot-configuration: boolean mail-nfs-index? ¶: Mail index files also exist in NFS. Setting this to yes requires ‘mmap-disable? #t’ and ‘fsync-disable? #f’. Defaults to ‘#f’.

parámetro de dovecot-configuration: string lock-method ¶: Método de bloqueo para los archivos de índice. Las alternativas son fcntl, flock y dotlock. Dotlock utiliza técnicas que pueden provocar un consumo de E/S mayor que otros métodos de bloqueo. Usuarias de NFS: flock no funciona, recuerde que se debe cambiar ‘mmap-disable’. Su valor predeterminado es ‘"fcntl"’.

parámetro de dovecot-configuration: nombre-archivo mail-temp-dir ¶: Directorio en el que LDA/LMTP almacena de manera temporal correos entrantes de de más de 128 kB. Su valor predeterminado es ‘"/tmp"’.

parámetro de dovecot-configuration: entero-no-negativo first-valid-uid ¶: Rango de UID aceptado para las usuarias. Principalmente es para asegurarse de que las usuarias no pueden ingresar en el sistema como un daemon u otras usuarias del sistema. Tenga en cuenta que el binario de dovecot tiene código que impide el ingreso al sistema como root y no puede llevarse a cabo incluso aunque ‘first-valid-uid’ tenga el valor 0. Su valor predeterminado es ‘500’.

parámetro de dovecot-configuration: entero-no-negativo last-valid-uid ¶: El valor predeterminado es ‘0’.

parámetro de dovecot-configuration: entero-no-negativo first-valid-gid ¶: Rango de GID aceptado para las usuarias. Las usuarias que no posean GID válido como ID primario de grupo no tienen permitido el ingreso al sistema. Si la usuaria es miembro de grupos suplementarios con GID no válido, no se activan dichos grupos. Su valor predeterminado es ‘1’.

parámetro de dovecot-configuration: entero-no-negativo last-valid-gid ¶: El valor predeterminado es ‘0’.

parámetro de dovecot-configuration: entero-no-negativo mail-max-keyword-length ¶: Longitud máxima permitida para nombres de palabras clave del correo. El límite actúa únicamente en la creación de nuevas palabras clave. Su valor predeterminado es ‘50’.

parámetro de dovecot-configuration: lista-archivos-sep-dos-puntos valid-chroot-dirs ¶: Lista de directorios bajo los que se permite realizar la llamada al sistema chroot a procesos de correo (es decir, /var/mail permitiría realizar la llamada también en /var/mail/sub/directorio). Esta configuración no afecta a la configuración de ‘login-chroot’, ‘mail-chroot’ o la de chroot para identificación. En caso de estar vacía, se ignora ‘"/./"’ en los directorios de usuarias. AVISO: Nunca añada directorios que las usuarias locales puedan modificar, puesto que podría permitir vulnerar el control de acceso como “root”. Habitualmente esta opción se activa únicamente si no permite a las usuarias acceder a un intérprete de órdenes. <doc/wiki/Chrooting.txt>. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: string mail-chroot ¶: Directorio predeterminado de la llamada al sistema chroot para los procesos de correo. El valor puede forzarse para usuarias específicas en la base de datos proporcionando ‘/./’ en el directorio de la usuaria (por ejemplo, ‘/home/./usuaria’ llama a chroot con /home). Tenga en cuenta que habitualmente no es necesario llamar a chroot, Dovecot no permite a las usuarias el acceso a archivos más allá de su directorio de correo en cualquier caso. Si sus directorios de usuaria contienen el directorio de chroot como prefijo, agregue ‘/.’ al final de ‘mail-chroot’. <doc/wiki/Chrooting.txt>. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: nombre-archivo auth-socket-path ¶: Ruta al socket de UNIX al servidor maestro de identificación para la búsqueda de usuarias. Se usa por parte de imap (para usuarias compartidas) y lda. Su valor predeterminado es ‘"/var/run/dovecot/auth-userdb"’.

parámetro de dovecot-configuration: nombre-archivo mail-plugin-dir ¶: Directorio en el que se buscarán módulos de correo. Su valor predeterminado es ‘"/usr/lib/dovecot"’.

parámetro de dovecot-configuration: lista-cadena-separada-espacios mail-plugins ¶: Lista de módulos cargados en todos los servicios. Los módulos específicos para IMAP, LDA, etc. se añaden en esta lista en sus propios archivos .conf. Su valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: entero-no-negativo mail-cache-min-mail-count ¶: El número mínimo de correos en una bandeja antes de que las actualizaciones se realicen en un archivo de caché. Permite optimizar el comportamiento de Dovecot para reducir la tasa de escritura en el disco, lo que produce un aumento de la tasa de lectura. Su valor predeterminado es ‘0’.

parámetro de dovecot-configuration: string mailbox-idle-check-interval ¶: Cuando se ejecute la orden IDLE, la bandeja de correo se comprueba de vez en cuando para comprobar si existen nuevos correos o se han producido otros cambios. Esta configuración define el tiempo mínimo entre dichas comprobaciones. Dovecot también puede usar dnotify, inotify y kqueue para recibir información inmediata sobre los cambios que ocurran. Su valor predeterminado es ‘"30 secs"’.

parámetro de dovecot-configuration: boolean mail-save-crlf? ¶: Save mails with CR+LF instead of plain LF. This makes sending those mails take less CPU, especially with sendfile() syscall with Linux and FreeBSD. But it also creates a bit more disk I/O which may just make it slower. Also note that if other software reads the mboxes/maildirs, they may handle the extra CRs wrong and cause problems. Defaults to ‘#f’.

parámetro de dovecot-configuration: boolean maildir-stat-dirs? ¶: De manera predeterminada la orden LIST devuelve todas las entradas en maildir cuyo nombre empiece en punto. La activación de esta opción hace que Dovecot únicamente devuelva las entradas que sean directorios. Esto se lleva a cabo llamando a stat() con cada entrada, lo que causa mayor E/S del disco. (En sistemas que proporcionen valor a ‘dirent->d_type’ esta comprobación no tiene coste alguno y se realiza siempre independientemente del valor configurado aquí). Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean maildir-copy-with-hardlinks? ¶: Cuando se copia un mensaje, se usan enlaces duros cuando sea posible. Esto mejora mucho el rendimiento, y es difícil que produzca algún efecto secundario. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: boolean maildir-very-dirty-syncs? ¶: Asume que Dovecot es el único MUA que accede a maildir: Recorre el directorio cur/ únicamente cuando cambie su mtime de manera inesperada o cuando no se pueda encontrar el correo de otra manera. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: lista-cadena-separada-espacios mbox-read-locks ¶

Qué métodos de bloqueo deben usarse para el bloque de mbox. Hay cuatro disponibles:

dotlock: Crea un archivo <bandeja>.lock. Esta es la solución más antigua y más segura con NFS. Si desea usar un directorio como /var/mail/, las usuarias necesitarán acceso de escritura a dicho directorio.
dotlock-try: Lo mismo que dotlock, pero si se produce un fallo debido a los permisos o a que no existe suficiente espacio en disco, simplemente se omite el bloqueo.
fcntl: Use este a ser posible. Funciona también con NFS si se usa lockd.
flock: Puede no existir en todos los sistemas. No funciona con NFS.
lockf: Puede no existir en todos los sistemas. No funciona con NFS.

Puede usar múltiples métodos de bloqueo; en ese caso el orden en el que se declaran es importante para evitar situaciones de bloqueo mutuo en caso de que otros MTA/MUA usen también múltiples métodos de bloqueo. Algunos sistemas operativos no permiten el uso de varios de ellos de manera simultánea.

parámetro de dovecot-configuration: lista-cadena-separada-espacios mbox-write-locks ¶

parámetro de dovecot-configuration: string mbox-lock-timeout ¶: Tiempo máximo esperado hasta el bloqueo (de todos los archivos) antes de interrumpir la operación. Su valor predeterminado es ‘"5 mins"’.

parámetro de dovecot-configuration: string mbox-dotlock-change-timeout ¶: Si existe el archivo dotlock pero la bandeja no se ha modificado de ninguna manera, ignora el archivo de bloqueo tras este tiempo. Su valor predeterminado es ‘"2 mins"’.

parámetro de dovecot-configuration: boolean mbox-dirty-syncs? ¶: Cuando el archivo mbox cambie de manera inesperada, se tiene que leer completamente para encontrar los cambios. Si es grande puede tardar bastante tiempo. Deido a que el cambio habitualmente es un nuevo correo añadido al final, sería más rápido únicamente leer los correos nuevos. Si se activa esta opción, Dovecot hace esto pero de todos modos vuelve a leer el archivo mbox al completo cuando algo en la bandeja no se encuentra como se esperaba. La única desventaja real de esta configuración es que si otro MUA cambia las opciones de los mensajes, Dovecot no tiene constancia de ello de manera inmediata. Tenga en cuenta que una sincronización completa se lleva a cabo con las órdenes SELECT, EXAMINE, EXPUNGE y CHECK. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: boolean mbox-very-dirty-syncs? ¶: Como ‘mbox-dirty-syncs’, pero no realiza sincronizaciones completas tampoco con las órdenes SELECT, EXAMINE, EXPUNGE o CHECK. Si se configura este valor, ‘mbox-dirty-syncs’ se ignora. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean mbox-lazy-writes? ¶: Retrasa la escritura de las cabeceras de mbox hasta que se realice una escritura completa sincronizada (con las órdenes EXPUNGE y CHECK, y al cerrar la bandeja de correo). Es útil especialmente con POP3, donde el cliente habitualmente borra todos los correos. La desventaja es que nuestros cambios no son visibles para otros MUA de manera inmediata. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: entero-no-negativo mbox-min-index-size ¶: Si el tamaño del archivo mbox es menor que este valor (por ejemplo, 100k), no escribe archivos de índice. Si el archivo de índice ya existe, todavía se usa para la lectura, pero no se actualiza. Su valor predeterminado es ‘0’.

parámetro de dovecot-configuration: entero-no-negativo mdbox-rotate-size ¶: Tamaño máximo del archivo dbox hasta su rotación. Su valor predeterminado es ‘10000000’.

parámetro de dovecot-configuration: string mdbox-rotate-interval ¶: Antigüedad máxima del archivo dbox hasta que se produce su rotación. Habitualmente en días. El día comienza a medianoche, por lo que 1d = hoy, 2d = ayer, etcétera. 0 = comprobación desactivada. Su valor predeterminado es ‘"1d"’.

parámetro de dovecot-configuration: boolean mdbox-preallocate-space? ¶: Cuando se crean nuevos archivos mdbox, reserva inmediatamente un tamaño de ‘mbox-rotate-size’. Actualmente esta configuración funciona únicamente en Linux con determinados sistemas de archivos (ext4, xfs). Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: string mail-attachment-dir ¶

sdbox y mdbox permiten el almacenamiento de adjuntos en archivos externos, lo que permite también su almacenamiento único. Otros motores no lo permiten por el momento.

AVISO: Esta característica todavía no se ha probado mucho. Su uso queda bajo su propia responsabilidad.

Directorio raíz donde almacenar los adjuntos de los correos. Se desactiva en caso de estar vacío. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: entero-no-negativo mail-attachment-min-size ¶: Los adjuntos de menor tamaño que este valor no se almacenan externamente. También es posible la escritura de un módulo que deshabilite el almacenamiento externo de adjuntos específicos. Su valor predeterminado es ‘128000’.

parámetro de dovecot-configuration: string mail-attachment-fs ¶

Motor del sistema de archivos usado para el almacenamiento de adjuntos:

posix: Dovecot no lleva a cabo el SiS (aunque esto puede ayudar a la deduplicación del propio sistema de archivos)
sis posix: SiS con comparación inmediata byte-por-byte durante el almacenamiento.
sis-queue posix: SiS mediante comparación retrasada y deduplicación.

El valor predeterminado es ‘"sis posix"’.

parámetro de dovecot-configuration: string mail-attachment-hash ¶: Formato del hash usado en los archivos adjuntos. Puede añadir cualquier texto y variables: %{md4}, %{md5}, %{sha1}, %{sha256}, %{sha512}, %{size}. Las variables pueden reducirse, por ejemplo %{sha256:80} devuelve únicamente los primeros 80 bits. Su valor predeterminado es ‘"%{sha1}"’.

parámetro de dovecot-configuration: entero-no-negativo default-process-limit ¶: El valor predeterminado es ‘100’.

parámetro de dovecot-configuration: entero-no-negativo default-client-limit ¶: El valor predeterminado es ‘1000’.

parámetro de dovecot-configuration: entero-no-negativo default-vsz-limit ¶: Límite predeterminado del tamaño de memoria virtual (VSZ) para procesos del servicio. Esta principalmente orientado a la captura y parada de procesos que pierden memoria antes de que utilicen toda la disponible. Su valor predeterminado es ‘256000000’.

parámetro de dovecot-configuration: string default-login-user ¶: Usuaria de ingreso al sistema para los procesos de ingreso al sistema. Es la usuaria en la que menos se confía en el sistema Dovecot. No debería tener acceso a nada en absoluto. Su valor predeterminado es ‘"dovenull"’.

parámetro de dovecot-configuration: string default-internal-user ¶: Usuaria interna usada por procesos sin privilegios. Debería ser distinta a la usuaria de ingreso, de modo que los procesos de ingreso al sistema no interfieran con otros procesos. Su valor predeterminado es ‘"dovecot"’.

parámetro de dovecot-configuration: string ssl? ¶: Si se permite SSL/TLS: ‘yes’ (sí), ‘no’, ‘required’ (necesario). <doc/wiki/SSL.txt>. Su valor predeterminado es ‘"required"’.

parámetro de dovecot-configuration: string ssl-cert ¶: Certificado X.509 de SSL/TLS codificado con PEM (clave pública). Su valor predeterminado es ‘"</etc/dovecot/default.pem"’.

parámetro de dovecot-configuration: string ssl-key ¶: Clave privada de SSL/TLS codificada con PEM. La clave se abre antes de renunciar a los privilegios de root, por lo que debe mantenerse legible únicamente para root. Su valor predeterminado es ‘"</etc/dovecot/private/default.pem"’.

parámetro de dovecot-configuration: string ssl-key-password ¶: Si el archivo de la clave está protegido por contraseña, introduzca dicha contraseña aquí. De manera alternativa, puede proporcionarla al iniciar dovecot con el parámetro -p. Como este archivo es habitualmente legible por todo el mundo, puede que desee desplazar esta opción a un archivo diferente. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string ssl-ca ¶: Certificado usado como autoridad de certificación de confianza codificado en PEM. Configure este valor únicamente si tiene intención de usar ‘ssl-verify-client-cert? #t’. El archivo debe contener el archivo de la o las AC seguido de las CRL correspondientes (por ejemplo, ‘ssl-ca </etc/ssl/certs/ca.pem’). Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: boolean ssl-require-crl? ¶: Es necesario que la comprobación de CRL sea satisfactoria para certificados de clientes.. Su valor predeterminado es ‘#t’.

parámetro de dovecot-configuration: boolean ssl-verify-client-cert? ¶: Solicita al cliente el envío de un certificado. Si también desea que sea un requisito, proporcione ‘auth-ssl-require-client-cert? #t’ en la sección de identificación. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: string ssl-cert-username-field ¶: Cual es el campo del certificado que determina el nombre de usuaria. “commonName” y “x500UniqueIdentifier” son las opciones habituales. También tendrá proporcionar ‘auth-ssl-username-from-cert? #t’. Su valor predeterminado es ‘"commonName"’.

parámetro de dovecot-configuration: string ssl-min-protocol ¶: Versión mínima aceptada del protocolo SSL. Su valor predeterminado es ‘"TLSv1"’.

parámetro de dovecot-configuration: string ssl-cipher-list ¶: Protocolos de cifrado de SSL usados. Su valor predeterminado es ‘"ALL:!kRSA:!SRP:!kDHd:!DSS:!aNULL:!eNULL:!EXPORT:!DES:!3DES:!MD5:!PSK:!RC4:!ADH:!LOW@STRENGTH"’.

parámetro de dovecot-configuration: string ssl-crypto-device ¶: Dispositivo de cifrado de SSL usado, ejecute "openssl engine" para obtener los valores aceptados. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string postmaster-address ¶: Dirección usada cuando se notifiquen correos rechazados. %d expande al dominio receptor. Su valor predeterminado es ‘"postmaster@%d"’.

parámetro de dovecot-configuration: string hostname ¶: Nombre de máquina usado en diversas partes de los correos enviados (por ejemplo, en Message-Id) y en las respuestas LMTP. Su valor predeterminado es <el nombre real de la máquina>@dominio. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: boolean quota-full-tempfail? ¶: Si la usuaria supera la cuota, devuelve un fallo temporal en vez de rechazar el correo. Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: nombre-archivo sendmail-path ¶: Binario usado para el envío de correos. Su valor predeterminado es ‘"/usr/sbin/sendmail"’.

parámetro de dovecot-configuration: string submission-host ¶: Si no está vacío, envía el correo a través de esta máquina[:puerto] SMTP en vez de usar sendmail Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string rejection-subject ¶: Asunto: cabecera usada en el rechazo de correos. Puede usar las mismas variables que las indicadas en ‘rejection-reason’ a continuación. Su valor predeterminado es ‘"Rejected: %s"’.

parámetro de dovecot-configuration: string rejection-reason ¶

Mensaje de error legible por personas para el rechazo de correos. Puede usar variables:

%n: CRLF
%r: razón
%s: asunto original
%t: receptora

El valor predeterminado es ‘"Your message to <%t> was automatically rejected:%n%r"’.

parámetro de dovecot-configuration: string recipient-delimiter ¶: Carácter delimitador entre la parte local y el detalle en las direcciones de correo. Su valor predeterminado es ‘"+"’.

parámetro de dovecot-configuration: string lda-original-recipient-header ¶: Cabecera de donde se obtiene la dirección receptora original (la dirección de SMTP RCPT TO:) en caso de no estar disponible en otro lugar. El parámetro -a de dovecot-lda reemplaza este valor. Una cabecera usada para esto de manera común es X-Original-To. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: boolean lda-mailbox-autocreate? ¶: ¿Se debe crear una bandeja de correo no existente de manera automática al almacenar un correo? Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: boolean lda-mailbox-autosubscribe? ¶: ¿También Se deben crear suscripciones de manera automática a las bandejas de correo creadas? Su valor predeterminado es ‘#f’.

parámetro de dovecot-configuration: entero-no-negativo imap-max-line-length ¶: Longitud máxima de la línea de órdenes de IMAP. Algunos clientes generan líneas de órdenes muy largas con bandejas de correo enormes, por lo que debe incrementarlo si recibe los errores “Too long argument” (parámetro demasiado largo) o "IMAP command line too large" (línea de órdenes de IMAP demasiado grande). Su valor predeterminado es ‘64000’.

parámetro de dovecot-configuration: string imap-logout-format ¶

Formato de la cadena de IMAP de salida del sistema:

%i: número total de bytes leídos del cliente
%o: número total de bytes enviados al cliente.

Véase doc/wiki/Variables.txt para obtener una lista completa de todas las variables que puede usar. Su valor predeterminado es ‘"in=%i out=%o deleted=%{deleted} expunged=%{expunged} trashed=%{trashed} hdr_count=%{fetch_hdr_count} hdr_bytes=%{fetch_hdr_bytes} body_count=%{fetch_body_count} body_bytes=%{fetch_body_bytes}"’.

parámetro de dovecot-configuration: string imap-capability ¶: Fuerza el valor de la respuesta de IMAP CAPABILITY. Si el valor comienza con ’+’, añade las capacidades especificadas sobre las predeterminadas (por ejemplo, +XFOO XBAR). Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string imap-idle-notify-interval ¶: Durante cuanto tiempo se espera entre notificaciones "OK Still here" cuando el cliente se encuentre en estado IDLE. Su valor predeterminado es ‘"2 mins"’.

parámetro de dovecot-configuration: string imap-id-send ¶: Nombres y valores de campos de identificación (ID) que se enviarán a los clientes. El uso de * como un valor hace que Dovecot utilice el valor predeterminado. Los siguientes campos tienen actualmente valores predeterminados: name, version, os, os-version, support-url, support-email. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: string imap-id-log ¶: Campos de identificación (ID) enviados para su registro por cliente. * significa todos. Su valor predeterminado es ‘""’.

parámetro de dovecot-configuration: lista-cadena-separada-espacios imap-client-workarounds ¶

Soluciones temporales para varios errores de clientes:

delay-newmail: Envía notificaciones de nuevo correo EXISTS/RECENT únicamente en respuesta a ordenes NOOP o CHECK. Algunos clientes las ignoran en otro caso, por ejemplo OSX Mail (<v2.1). Outlook Express tiene problemas mayores no obstante, sin esto puede mostrar a la usuaria errores "Message no longer in server". Tenga en cuenta que OE6 también falla con esta solución temporal si la sincronización se establece como "Headers Only".
tb-extra-mailbox-sep: Thunderbird se confunde de algún modo con LAYOUT=fs (mbox y dbox) y añade sufijos ‘/’ adicionales a los nombres de las bandejas de correo. Esta opción hace que Dovecot ignore el carácter ‘/’ adicional en vez de tratarlo como un nombre de bandeja de correo no válido.
tb-lsub-flags: Muestra las opciones \Noselect para respuestas LSUB con LAYOUT=fs (por ejemplo mbox). Esto permite a Thunderbird ser consciente de que no se pueden seleccionar y mostrarlas en gris, en vez de únicamente mostrar después el mensaje de error "no seleccionable".

El valor predeterminado es ‘'()’.

parámetro de dovecot-configuration: string imap-urlauth-host ¶: Máquina permitida en las URL URLAUTH enviadas por el cliente. "*" permite todas. Su valor predeterminado es ‘""’.

¡Miau! Muchas opciones de configuración. Lo bueno es que Guix tiene una interfaz completa al lenguage de configuración de Dovecot. Esto no permite únicamente declarar configuraciones de forma bonita, sino que también ofrece capacidades reflexivas: las usuarias pueden escribir código en Scheme para inspeccionar y transformar configuraciones.

No obstante, puede ser que únicamente desee usar un archivo dovecot.conf existente. En ese caso, puede proporcionar un objeto opaque-dovecot-configuration como parámetro #:config a dovecot-service. Como su nombre en inglés indica, una configuración opaca no tiene gran capacidad reflexiva.

Los campos disponibles de opaque-dovecot-configuration son:

parámetro de opaque-dovecot-configuration: package dovecot ¶: El paquete dovecot.

parámetro de opaque-dovecot-configuration: string string ¶: El contenido de dovecot.conf, como una cadena.

Por ejemplo, si su dovecot.conf fuese simplemente la cadena vacía, podría instanciar un servicio dovecot de esta manera:

(dovecot-service #:config
                 (opaque-dovecot-configuration
                  (string "")))

Servicio OpenSMTPD

Variable: opensmtpd-service-type

Es el tipo del servicio OpenSMTPD, cuyo valor debe ser un objeto opensmtpd-configuration como en este ejemplo:

(service opensmtpd-service-type
         (opensmtpd-configuration
           (config-file (local-file "./mi-smtpd.conf"))))

Tipo de datos: opensmtpd-configuration

Tipo de datos que representa la configuración de opensmtpd.

package (predeterminado: opensmtpd): El objeto paquete del servidor SMTP OpenSMTPD.
shepherd-requirement (default: '()): This option can be used to provide a list of symbols naming Shepherd services that this service will depend on, such as 'networking if you want to configure OpenSMTPD to listen on non-loopback interfaces.
config-file (default: %default-opensmtpd-config-file): Objeto “tipo-archivo” del archivo de configuración de OpenSMTPD usado. De manera predeterminada escucha en la interfaz de red local, y pone a disposición de usuarias y daemon de la máquina local el servicio de correo, así como el envío de correo a servidores remotos. Ejecute man smtpd.conf para obtener más información.
setgid-commands? (default: #t): Make the following commands setgid to smtpq so they can be executed: smtpctl, sendmail, send-mail, makemap, mailq, and newaliases. See Privileged Programs, for more information on setgid programs.

Servicio Exim

Variable: exim-service-type

Este es el tipo del agente de transferencia de correo (MTA) Exim, cuyo valor debe ser un objeto exim-configuration como en este ejemplo:

(service exim-service-type
         (exim-configuration
           (config-file (local-file "./mi-exim.conf"))))

Para usar un servicio exim-service-type debe tener también un servicio mail-aliases-service-type presente en su declaración operating-system (incluso aunque no exista ningún alias).

Tipo de datos: exim-configuration

Tipo de datos que representa la configuración de exim.

package (predeterminado: exim): El objeto paquete del servidor Exim.
config-file (predeterminado: #f): File-like object of the Exim configuration file to use. If its value is #f then use the default configuration file from the package provided in package. The resulting configuration file is loaded after setting the exim_user and exim_group configuration variables.

Servicio Getmail

Variable: getmail-service-type: This is the type of the Getmail mail retriever, whose value should be a getmail-configuration.

Los campos disponibles de getmail-configuration son:

parámetro de getmail-configuration: símbolo name ¶

Un símbolo que identifique el servicio getmail.

El valor predeterminado es ‘"unset"’.

parámetro de getmail-configuration: package package ¶: El paquete getmail usado.

parámetro de getmail-configuration: string user ¶

Usuaria que ejecuta getmail.

El valor predeterminado es ‘"getmail"’.

parámetro de getmail-configuration: string group ¶

Grupo que ejecuta getmail.

El valor predeterminado es ‘"getmail"’.

parámetro de getmail-configuration: string directory ¶

El directorio usado para getmail.

El valor predeterminado es ‘"/var/lib/getmail/default"’.

parámetro de getmail-configuration: getmail-configuration-file rcfile ¶

El archivo de configuración de getmail usado.

Los campos disponibles de getmail-configuration-file son:

parámetro de getmail-configuration-file: getmail-retriever-configuration retriever ¶

De qué cuenta de correo obtener el correo, y cómo acceder a dicha cuenta.

Los campos disponibles de getmail-retriever-configuration son:

parámetro de getmail-retriever-configuration: string type ¶

El controlador que userdb debe usar. Entre los valores aceptados se incluye ‘passwd’ y ‘static’.

El valor predeterminado es ‘"SimpleIMAPSSLRetriever"’.

parámetro de getmail-retriever-configuration: string server ¶

Usuaria que ejecutará el servidor de correo.

El valor predeterminado es ‘unset’.

parámetro de getmail-retriever-configuration: string username ¶

Usuaria que ejecutará el servidor de correo.

El valor predeterminado es ‘unset’.

parámetro de getmail-retriever-configuration: entero-no-negativo port ¶

Número de puerto al que conectarse.

El valor predeterminado es ‘#f’

parámetro de getmail-retriever-configuration: string password ¶

Sustituye los valores de campos de passwd.

El valor predeterminado es ‘""’.

parámetro de getmail-retriever-configuration: list password-command ¶

Sustituye los valores de campos de passwd.

El valor predeterminado es ‘'()’.

parámetro de getmail-retriever-configuration: string keyfile ¶

Archivo de claves con formato PEM usado para la negociación TLS.

El valor predeterminado es ‘""’.

parámetro de getmail-retriever-configuration: string certfile ¶

Archivo de certificado con formato PEM usado para la negociación TLS.

El valor predeterminado es ‘""’.

parámetro de getmail-retriever-configuration: string ca-certs ¶

Certificados de autoridad de certificación (CA) usados.

El valor predeterminado es ‘""’.

parámetro de getmail-retriever-configuration: parameter-alist extra-parameters ¶

Parámetros adicionales del receptor de correo.

El valor predeterminado es ‘'()’.

parámetro de getmail-configuration-file: getmail-destination-configuration destination ¶

Qué hacer con los mensajes obtenidos.

Los campos disponibles de getmail-destination-configuration son:

parámetro de getmail-destination-configuration: string type ¶

Tipo de destino del correo. Entre los valores válidos se incluye ‘Maildir’, ‘Mboxrd’ y ‘MDA_external’.

El valor predeterminado es ‘unset’.

parámetro de getmail-destination-configuration: string-or-filelike path ¶

Opción de ruta para el destino del correo. El comportamiento depende del tipo seleccionado.

El valor predeterminado es ‘""’.

parámetro de getmail-destination-configuration: parameter-alist extra-parameters ¶

Parámetros adicionales del destino.

El valor predeterminado es ‘'()’.

parámetro de getmail-configuration-file: getmail-options-configuration options ¶

Configuración de getmail.

Los campos disponibles de getmail-options-configuration son:

parámetro de getmail-options-configuration: entero-no-negativo verbose ¶

If set to ‘0’, getmail will only print warnings and errors. A value of ‘1’ means that messages will be printed about retrieving and deleting messages. If set to ‘2’, getmail will print messages about each of its actions.

El valor predeterminado es ‘1’.

parámetro de getmail-options-configuration: boolean read-all ¶

Si es verdadero, getmail obtendrá todos los mensajes disponibles. En otro caso, únicamente recupera mensajes que no se hayan visto previamente.

El valor predeterminado es ‘#t’

parámetro de getmail-options-configuration: boolean delete ¶

Si se proporciona un valor verdadero, los mensajes se borrarán del servidor tras su recuperación y entrega posterior satisfactoria. En otro caso, los mensajes permanecerán en el servidor.

El valor predeterminado es ‘#f’

parámetro de getmail-options-configuration: entero-no-negativo delete-after ¶

Getmail borrará los mensajes tras este número de días después de haberlos visto, si han sido entregados. Esto significa que los mensajes se mantendrán en el servidor este número de días tras entregarlos. El valor ‘0’ desactiva esta característica.

El valor predeterminado es ‘0’.

parámetro de getmail-options-configuration: entero-no-negativo delete-bigger-than ¶

Borra los mensajes de tamaño mayor que estos bytes tras recibirlos, incluso si las opciones “delete” y “delete-after” están desactivadas. El valor ‘0’ desactiva esta característica.

El valor predeterminado es ‘0’.

parámetro de getmail-options-configuration: entero-no-negativo max-bytes-per-session ¶

Obtiene mensajes hasta este número de bytes en total antes de cerrar la sesión con el servidor. El valor ‘0’ desactiva esta característica.

El valor predeterminado es ‘0’.

parámetro de getmail-options-configuration: entero-no-negativo max-message-size ¶

No obtiene mensajes con mayor tamaño que este número de bytes. El valor ‘0’ desactiva esta característica.

El valor predeterminado es ‘0’.

parámetro de getmail-options-configuration: boolean delivered-to ¶

Si es verdadero, getmail añadirá una cabecera “Delivered-To” a los mensajes.

El valor predeterminado es ‘#t’

parámetro de getmail-options-configuration: boolean received ¶

Si es verdadero, getmail añadirá una cabecera “Received” a los mensajes.

El valor predeterminado es ‘#t’

parámetro de getmail-options-configuration: string message-log ¶

Getmail generará un registro de sus acciones en el archivo nombrado. El valor ‘""’ desactiva esta característica.

El valor predeterminado es ‘""’.

parámetro de getmail-options-configuration: boolean message-log-syslog ¶

Si es verdadero, getmail registrará sus acciones a través del registro del sistema.

El valor predeterminado es ‘#f’

parámetro de getmail-options-configuration: boolean message-log-verbose ¶

Si es verdadero, getmail registrará información sobre los mensajes que no se hayan podido recuperar y la razón para no hacerlo, así como líneas de inicio y fin informativas.

El valor predeterminado es ‘#f’

parámetro de getmail-options-configuration: parameter-alist extra-parameters ¶

Opciones adicionales a incluir.

El valor predeterminado es ‘'()’.

parámetro de getmail-configuration: lista idle ¶

Una lista de bandejas de correo en las que getmail debe esperar en el servidor nuevas notificaciones de correo. Esto depende de que el servidor implemente la extensión IDLE.

El valor predeterminado es ‘'()’.

parámetro de getmail-configuration: lista environment-variables ¶

Variables de entorno proporcionadas a getmail.

El valor predeterminado es ‘'()’.

Servicios de alias de correo

Variable: mail-aliases-service-type

Este es el tipo del servicio que proporciona /etc/aliases, donde se especifica cómo entregar el correo a las usuarias de este sistema.

(service mail-aliases-service-type
         '(("postmaster" "rober")
           ("rober" "rober@example.com" "rober@example2.com")))

The configuration for a mail-aliases-service-type service is an association list denoting how to deliver mail that comes to this system. Each entry is of the form (alias addresses ...), with alias specifying the local alias and addresses specifying where to deliver this user’s mail.

The aliases aren’t required to exist as users on the local system. In the above example, there doesn’t need to be a postmaster entry in the operating-system’s user-accounts in order to deliver the postmaster mail to bob (which subsequently would deliver mail to bob@example.com and bob@example2.com).

daemon de IMAP3 de GNU Mailutils

Variable: imap4d-service-type

Es el tipo del daemon IMAP4 de GNU Mailutils (see imap4d in GNU Mailutils Manual), cuyo valor debe ser un objeto imap4d-configuration como en este ejemplo:

(service imap4d-service-type
         (imap4d-configuration
           (config-file (local-file "imap4d.conf"))))

Tipo de datos: imap4d-configuration

Tipo de datos que representa la configuración de imap4d.

package (predeterminado: mailutils): El paquete que proporciona imap4d.
config-file (predeterminado: %default-imap4d-config-file): Objeto “tipo-archivo” con el archivo de configuración usado, de manera predeterminada escucha en el puerto TCP 143 de localhost. See Conf-imap4d in GNU Mailutils Manual, para más detalles.

Radicale Service

Variable: radicale-service-type: This is the type of the Radicale CalDAV/CardDAV server whose value should be a radicale-configuration. The default configuration matches the upstream documentation.

Data Type: radicale-configuration

Data type representing the configuration of radicale. Available radicale-configuration fields are:

package (default: radicale) (type: package)

Package that provides radicale.

auth (default: '()) (type: radicale-auth-configuration)

Configuration for auth-related variables.

Data Type: radicale-auth-configuration

Data type representing the auth section of a radicale configuration file. Available radicale-auth-configuration fields are:

type (default: 'none) (type: symbol): The method to verify usernames and passwords. Options are none, htpasswd, remote-user, and http-x-remote-user. This value is tied to htpasswd-filename and htpasswd-encryption.
htpasswd-filename (default: "/etc/radicale/users") (type: file-name): Path to the htpasswd file. Use htpasswd or similar to generate this file.
htpasswd-encryption (default: 'md5) (type: symbol): Encryption method used in the htpasswd file. Options are plain, bcrypt, and md5.
delay (default: 1) (type: non-negative-integer): Average delay after failed login attempts in seconds.
realm (default: "Radicale - Password Required") (type: string): Message displayed in the client when a password is needed.

encoding (default: '()) (type: radicale-encoding-configuration)

Configuration for encoding-related variables.

Data Type: radicale-encoding-configuration

Data type representing the encoding section of a radicale configuration file. Available radicale-encoding-configuration fields are:

request (default: 'utf-8) (type: symbol): Encoding for responding requests.
stock (default: 'utf-8) (type: symbol): Encoding for storing local collections.

headers-file (default: none) (type: file-like)

Custom HTTP headers.

logging (default: '()) (type: radicale-logging-configuration)

Configuration for logging-related variables.

Data Type: radicale-logging-configuration

Data type representing the logging section of a radicale configuration file. Available radicale-logging-configuration fields are:

level (default: 'warning) (type: symbol): Set the logging level. One of debug, info, warning, error, or critical.
mask-passwords? (default: #t) (type: boolean): Whether to include passwords in logs.

rights (default: '()) (type: radicale-rights-configuration)

Configuration for rights-related variables. This should be a radicale-rights-configuration.

Data Type: radicale-rights-configuration

Data type representing the rights section of a radicale configuration file. Available radicale-rights-configuration fields are:

type (default: 'owner-only) (type: symbol): Backend used to check collection access rights. The recommended backend is owner-only. If access to calendars and address books outside the home directory of users is granted, clients won’t detect these collections and will not show them to the user. Choosing any other method is only useful if you access calendars and address books directly via URL. Options are authenticate, owner-only, owner-write, and from-file.
file (default: "") (type: file-name): File for the rights backend from-file.

server (default: '()) (type: radicale-server-configuration)

Configuration for server-related variables. Ignored if WSGI is used.

Data Type: radicale-server-configuration

Data type representing the server section of a radicale configuration file. Available radicale-server-configuration fields are:

hosts (default: (list "localhost:5232")) (type: list-of-ip-addresses): List of IP addresses that the server will bind to.
max-connections (default: 8) (type: non-negative-integer): Maximum number of parallel connections. Set to 0 to disable the limit.
max-content-length (default: 100000000) (type: non-negative-integer): Maximum size of the request body in bytes.
timeout (default: 30) (type: non-negative-integer): Socket timeout in seconds.
ssl? (default: #f) (type: boolean): Whether to enable transport layer encryption.
certificate (default: "/etc/ssl/radicale.cert.pem") (type: file-name): Path of the SSL certificate.
key (default: "/etc/ssl/radicale.key.pem") (type: file-name): Path to the private key for SSL. Only effective if ssl? is #t.
certificate-authority (default: "") (type: file-name): Path to CA certificate for validating client certificates. This can be used to secure TCP traffic between Radicale and a reverse proxy. If you want to authenticate users with client-side certificates, you also have to write an authentication plugin that extracts the username from the certificate.

storage (default: '()) (type: radicale-storage-configuration)

Configuration for storage-related variables.

Data Type: radicale-storage-configuration

Data type representing the storage section of a radicale configuration file. Available radicale-storage-configuration fields are:

type (default: 'multifilesystem) (type: symbol): Backend used to store data. Options are multifilesystem and multifilesystem-nolock.
filesystem-folder (default: "/var/lib/radicale/collections") (type: file-name): Folder for storing local collections. Created if not present.
max-sync-token-age (default: 2592000) (type: non-negative-integer): Delete sync-tokens that are older than the specified time in seconds.
hook (default: "") (type: string): Command run after changes to storage.

web-interface? (default: #t) (type: boolean)

Whether to use Radicale’s built-in web interface.

Rspamd Service

Variable: rspamd-service-type: This is the type of the Rspamd filtering system whose value should be a rspamd-configuration.

Data Type: rspamd-configuration

Available rspamd-configuration fields are:

package (default: rspamd) (type: file-like): The package that provides rspamd.
config-file (default: %default-rspamd-config-file) (type: file-like): File-like object of the configuration file to use. By default all workers are enabled except fuzzy and they are binded to their usual ports, e.g localhost:11334, localhost:11333 and so on
local.d-files (default: ()) (type: directory-tree): Configuration files in local.d, provided as a list of two element lists where the first element is the filename and the second one is a file-like object. Settings in these files will be merged with the defaults.
override.d-files (default: ()) (type: directory-tree): Configuration files in override.d, provided as a list of two element lists where the first element is the filename and the second one is a file-like object. Settings in these files will override the defaults.
user (default: %default-rspamd-account) (type: user-account): The user to run rspamd as.
group (default: %default-rspamd-group) (type: user-group): The group to run rspamd as.
debug? (default: #f) (type: boolean): Force debug output.
insecure? (default: #f) (type: boolean): Ignore running workers as privileged users.
skip-template? (default: #f) (type: boolean): Do not apply Jinja templates.
shepherd-requirements (default: (loopback)) (type: list-of-symbols): This is a list of symbols naming Shepherd services that this service will depend on.