<!-- review: finished -->

<a id="mail-pop3"></a>

# POP3

O módulo habilita suporte ao protocolo de email POP3, permitindo que o servidor
baixe mensagens de servidores de email. Ele se conecta a servidores POP3,
recupera cabeçalhos e conteúdo de mensagens, fornece autenticação segura e
gerencia status de mensagens como baixadas ou excluídas.

<a id="directives-59"></a>

## Diretivas

<a id="index-0"></a>

<a id="m-pop3-auth"></a>

### pop3_auth

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_auth` method ...;   |
|-------------------------------------------------------------------------------------------|---------------------------|
| Padrão                                                                                    | `pop3_auth plain;`        |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | mail, server              |

Define métodos permitidos de autenticação para clientes POP3. Os métodos suportados são:

| `plain`       | [USER/PASS](https://datatracker.ietf.org/doc/html/rfc1939), [AUTH PLAIN](https://datatracker.ietf.org/doc/html/rfc4616), [AUTH LOGIN](https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00)   |
|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `apop`        | [APOP](https://datatracker.ietf.org/doc/html/rfc1939). Para que este método funcione, a senha deve ser armazenada sem criptografia.                                                                          |
| `cram-md5`    | [AUTH=CRAM-MD5](https://datatracker.ietf.org/doc/html/rfc2195). Para que este método funcione, a senha deve ser armazenada sem criptografia.                                                                 |
| `external`    | [AUTH=EXTERNAL](https://datatracker.ietf.org/doc/html/rfc4422)                                                                                                                                               |
| `xoauth2`     | [AUTH=XOAUTH2](https://developers.google.com/gmail/imap/xoauth2-protocol)                                                                                                                                    |
| `oauthbearer` | [AUTH=OAUTHBEARER](https://datatracker.ietf.org/doc/html/rfc7628)                                                                                                                                            |

Métodos de autenticação de texto simples (`USER/PASS`, `AUTH PLAIN` e
`AUTH LOGIN`) estão sempre habilitados, embora se o método `plain` não
for especificado, `AUTH PLAIN` e `AUTH LOGIN` não serão
automaticamente incluídos em [pop3_capabilities](#m-pop3-capabilities).

<a id="index-1"></a>

<a id="m-pop3-capabilities"></a>

### pop3_capabilities

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_capabilities` extension ...;   |
|-------------------------------------------------------------------------------------------|--------------------------------------|
| Padrão                                                                                    | `pop3_capabilities TOP USER UIDL;`   |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | mail, server                         |

Define a lista de extensões do [protocolo POP3](https://datatracker.ietf.org/doc/html/rfc2449) que é passada ao cliente em resposta ao comando CAPA. Os métodos de autenticação especificados na diretiva [pop3_auth](#m-pop3-auth) (extensão [SASL](https://datatracker.ietf.org/doc/html/rfc2449)) e [STLS](https://datatracker.ietf.org/doc/html/rfc2595) são automaticamente adicionados a esta lista dependendo do valor da diretiva [starttls](https://pt.angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#m-starttls).

Faz sentido especificar as extensões suportadas pelos backends POP3 para os quais os clientes são direcionados via proxy (se essas extensões estão relacionadas a comandos usados após a autenticação, quando o Angie faz proxy transparente da conexão do cliente para o backend).