# Proxy O módulo habilita suporte para protocolos de email (POP3, IMAP, SMTP), permitindo que o servidor atue como proxy entre clientes e servidores de email. Ele estabelece conexões com servidores, realiza autenticação segura usando texto simples, SSL/TLS, ou STARTTLS, roteia adequadamente o tráfego do cliente, e suporta método de autenticação flexível e seleção de servidor. ## Diretivas ### proxy_buffer | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_buffer` size; | |-------------------------------------------------------------------------------------------|------------------------| | Padrão | `proxy_buffer 4k|8k;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Define o tamanho do buffer usado para proxy. Por padrão, o tamanho do buffer é igual a uma página de memória. Dependendo da plataforma, é 4K ou 8K. ### proxy_pass_error_message | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_error_message` `on` | `off`; | |-------------------------------------------------------------------------------------------|--------------------------------------------| | Padrão | `proxy_pass_error_message off;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Determina se deve passar a mensagem de erro obtida durante a autenticação no backend para o cliente. Normalmente, se a autenticação no Angie for bem-sucedida, o backend não pode retornar um erro. Se mesmo assim retornar um erro, significa que ocorreu algum erro interno. Nesses casos, a mensagem do backend pode conter informações que não devem ser mostradas ao cliente. No entanto, responder com um erro para a senha correta é comportamento normal para alguns servidores POP3. A diretiva deve ser habilitada neste caso. ### proxy_protocol | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_protocol` `on` | `off`; | |-------------------------------------------------------------------------------------------|----------------------------------| | Padrão | `proxy_protocol off;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita o [protocolo PROXY](http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) para conexões com um backend. ### proxy_smtp_auth | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_smtp_auth` `on` | `off`; | |-------------------------------------------------------------------------------------------|-----------------------------------| | Padrão | `proxy_smtp_auth off;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita ou desabilita a autenticação do usuário no backend SMTP usando o comando AUTH. Se [XCLIENT](#m-xclient) também estiver habilitado, então o comando XCLIENT não enviará o parâmetro LOGIN. ### proxy_timeout | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_timeout` time; | |-------------------------------------------------------------------------------------------|-------------------------| | Padrão | `proxy_timeout 24h;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Define o timeout entre duas operações sucessivas de leitura ou escrita nas conexões do cliente ou servidor com proxy. Se nenhum dado for transmitido dentro deste tempo, a conexão é fechada. ### xclient | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `xclient` `on` | `off`; | |-------------------------------------------------------------------------------------------|---------------------------| | Padrão | `xclient on;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | mail, server | Habilita ou desabilita a passagem do comando [XCLIENT](http://www.postfix.org/XCLIENT_README.html) com parâmetros do cliente ao conectar com o backend SMTP. Com `XCLIENT`, o MTA é capaz de escrever informações do cliente no log e aplicar várias limitações baseadas nestes dados. Se `XCLIENT` estiver habilitado, então o Angie passa os seguintes comandos ao conectar com o backend: * `EHLO` com o [nome do servidor](https://pt.angie.software//angie/docs/configuration/modules/mail/index.md#m-server-name) * `XCLIENT` * `EHLO` ou `HELO`, conforme passado pelo cliente Se o nome [encontrado](https://pt.angie.software//angie/docs/configuration/modules/mail/index.md#m-resolver) pelo endereço IP do cliente aponta para o mesmo endereço, ele é passado no parâmetro `NAME` do comando `XCLIENT`. Se o nome não pôde ser encontrado, aponta para um endereço diferente, ou [resolver](https://pt.angie.software//angie/docs/configuration/modules/mail/index.md#m-resolver) não está especificado, então `[UNAVAILABLE]` é passado no parâmetro `NAME`. Se ocorreu um erro no processo de resolução, o valor `[TEMPUNAVAIL]` é usado. Se `XCLIENT` estiver desabilitado, o Angie passa o comando `EHLO` com o [nome do servidor](https://pt.angie.software//angie/docs/configuration/modules/mail/index.md#m-server-name) ao conectar com o backend se o cliente passou `EHLO`, ou `HELO` com o nome do servidor, caso contrário.