<!-- review: finished -->

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

# POP3

El módulo habilita el soporte del protocolo de correo POP3, permitiendo al servidor descargar
mensajes desde servidores de correo. Se conecta a servidores POP3, recupera
encabezados y contenido de mensajes, proporciona autenticación segura y gestiona
estados de mensajes como descargados o eliminados.

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

## Directivas

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

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

### pop3_auth

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_auth` method ...;   |
|--------------------------------------------------------------------------------------------|---------------------------|
| Predeterminado                                                                             | `pop3_auth plain;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | mail, server              |

Establece los métodos permitidos de autenticación para clientes POP3. Los métodos soportados son:

| `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, la contraseña debe almacenarse sin cifrar.                                                                             |
| `cram-md5`    | [AUTH=CRAM-MD5](https://datatracker.ietf.org/doc/html/rfc2195). Para que este método funcione, la contraseña debe almacenarse sin cifrar.                                                                    |
| `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)                                                                                                                                            |

Los métodos de autenticación de texto plano (`USER/PASS`, `AUTH PLAIN` y
`AUTH LOGIN`) están siempre habilitados, aunque si el método `plain` no
está especificado, `AUTH PLAIN` y `AUTH LOGIN` no se
incluirán automáticamente en [pop3_capabilities](#m-pop3-capabilities).

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

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

### pop3_capabilities

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_capabilities` extension ...;   |
|--------------------------------------------------------------------------------------------|--------------------------------------|
| Predeterminado                                                                             | `pop3_capabilities TOP USER UIDL;`   |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | mail, server                         |

Establece la lista de extensiones del [protocolo POP3](https://datatracker.ietf.org/doc/html/rfc2449) que se envía al cliente en respuesta al comando CAPA. Los métodos de autenticación especificados en la directiva [pop3_auth](#m-pop3-auth) (extensión [SASL](https://datatracker.ietf.org/doc/html/rfc2449)) y [STLS](https://datatracker.ietf.org/doc/html/rfc2595) se añaden automáticamente a esta lista dependiendo del valor de la directiva [starttls](https://es.angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#m-starttls).

Tiene sentido especificar las extensiones soportadas por los backends POP3 a los que se redirigen mediante proxy los clientes (si estas extensiones están relacionadas con comandos utilizados después de la autenticación, cuando Angie redirige mediante proxy de forma transparente la conexión del cliente al backend).