<!-- review: finished -->

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

# IMAP

El módulo habilita el soporte del protocolo de correo IMAP, permitiendo al servidor interactuar
con sistemas de almacenamiento de correo. Establece conexiones a servidores IMAP, procesa
comandos comunes como listar buzones y recuperar mensajes, y proporciona
autenticación segura y gestión del estado de los mensajes.

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

## Directivas

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

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

### imap_auth

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `imap_auth` method ...;   |
|--------------------------------------------------------------------------------------------|---------------------------|
| Predeterminado                                                                             | `imap_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 IMAP. Los métodos soportados son:

| `plain`       | [LOGIN](https://datatracker.ietf.org/doc/html/rfc3501), [AUTH=PLAIN](https://datatracker.ietf.org/doc/html/rfc4616)                       |
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `login`       | [AUTH=LOGIN](https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00)                                                         |
| `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 (el comando `LOGIN`,
`AUTH=PLAIN`, y `AUTH=LOGIN`) están siempre habilitados, aunque si los
métodos `plain` y `login` no se especifican, `AUTH=PLAIN` y
`AUTH=LOGIN` no se incluirán automáticamente en
[imap_capabilities](#m-imap-capabilities).

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

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

### imap_capabilities

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `imap_capabilities` extension ...;           |
|--------------------------------------------------------------------------------------------|----------------------------------------------|
| Predeterminado                                                                             | `imap_capabilities IMAP4 IMAP4rev1 UIDPLUS;` |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | mail, server                                 |

Establece la lista de extensiones del [protocolo IMAP](https://datatracker.ietf.org/doc/html/rfc3501) que se pasa al cliente en respuesta al comando CAPABILITY. Los métodos de autenticación especificados en la directiva [imap_auth](#m-imap-auth) y [STARTTLS](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 IMAP a los que se redirigen los clientes (si estas extensiones están relacionadas con comandos utilizados después de la autenticación, cuando Angie redirige de forma transparente una conexión de cliente al backend).

<!-- La lista actual de extensiones estandarizadas se publica en `www.iana.org <http://www.iana.org/assignments/imap4-capabilities>`_. -->

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

<a id="m-imap-client-buffer"></a>

### imap_client_buffer

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `imap_client_buffer` size;   |
|--------------------------------------------------------------------------------------------|------------------------------|
| Predeterminado                                                                             | `imap_client_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 leer comandos IMAP. Por defecto, el tamaño del búfer es igual a una página de memoria. Esto es 4K u 8K, dependiendo de la plataforma.