# Proxy El módulo habilita soporte para protocolos de correo (POP3, IMAP, SMTP), permitiendo que el servidor actúe como proxy entre clientes y servidores de correo. Establece conexiones con servidores, realiza autenticación segura utilizando texto plano, SSL/TLS o STARTTLS, enruta correctamente el tráfico del cliente y admite métodos de autenticación flexibles y selección de servidores. ## Directivas ### proxy_buffer | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_buffer` size; | |--------------------------------------------------------------------------------------------|------------------------| | Predeterminado | `proxy_buffer 4k|8k;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Establece el tamaño del búfer utilizado para el proxy. Por defecto, el tamaño del búfer es igual a una página de memoria. Dependiendo de la plataforma, es de 4K u 8K. ### proxy_pass_error_message | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_error_message` `on` | `off`; | |--------------------------------------------------------------------------------------------|--------------------------------------------| | Predeterminado | `proxy_pass_error_message off;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Determina si se debe pasar al cliente el mensaje de error obtenido durante la autenticación en el backend. Normalmente, si la autenticación en Angie es exitosa, el backend no puede devolver un error. Si aun así devuelve un error, significa que ha ocurrido algún error interno. En tales casos, el mensaje del backend puede contener información que no debería mostrarse al cliente. Sin embargo, responder con un error para una contraseña correcta es un comportamiento normal para algunos servidores POP3. La directiva debe habilitarse en este caso. ### proxy_protocol | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_protocol` `on` | `off`; | |--------------------------------------------------------------------------------------------|----------------------------------| | Predeterminado | `proxy_protocol off;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita el [PROXY protocol](http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) para conexiones al backend. ### proxy_smtp_auth | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_smtp_auth` `on` | `off`; | |--------------------------------------------------------------------------------------------|-----------------------------------| | Predeterminado | `proxy_smtp_auth off;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita o deshabilita la autenticación de usuario en el backend SMTP utilizando el comando AUTH. Si [XCLIENT](#m-xclient) también está habilitado, entonces el comando XCLIENT no enviará el parámetro LOGIN. ### proxy_timeout | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_timeout` time; | |--------------------------------------------------------------------------------------------|-------------------------| | Predeterminado | `proxy_timeout 24h;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Establece el tiempo de espera entre dos operaciones sucesivas de lectura o escritura en conexiones de cliente o servidor proxy. Si no se transmiten datos dentro de este tiempo, la conexión se cierra. ### xclient | [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | `xclient` `on` | `off`; | |--------------------------------------------------------------------------------------------|---------------------------| | Predeterminado | `xclient on;` | | [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita o deshabilita el paso del comando [XCLIENT](http://www.postfix.org/XCLIENT_README.html) con parámetros del cliente al conectarse al backend SMTP. Con `XCLIENT`, el MTA puede escribir la información del cliente en el registro y aplicar varias limitaciones basadas en estos datos. Si `XCLIENT` está habilitado, Angie pasa los siguientes comandos al conectarse al backend: * `EHLO` con el [nombre del servidor](https://es.angie.software//angie/docs/configuration/modules/mail/index.md#m-server-name) * `XCLIENT` * `EHLO` o `HELO`, según lo pasado por el cliente Si el nombre [encontrado](https://es.angie.software//angie/docs/configuration/modules/mail/index.md#m-resolver) por la dirección IP del cliente apunta a la misma dirección, se pasa en el parámetro `NAME` del comando `XCLIENT`. Si el nombre no se pudo encontrar, apunta a una dirección diferente, o no se especifica [resolver](https://es.angie.software//angie/docs/configuration/modules/mail/index.md#m-resolver), entonces se pasa `[UNAVAILABLE]` en el parámetro `NAME`. Si ha ocurrido un error en el proceso de resolución, se utiliza el valor `[TEMPUNAVAIL]`. Si `XCLIENT` está deshabilitado, Angie pasa el comando `EHLO` con el [nombre del servidor](https://es.angie.software//angie/docs/configuration/modules/mail/index.md#m-server-name) al conectarse al backend si el cliente ha pasado `EHLO`, o `HELO` con el nombre del servidor, en caso contrario.