<!-- review: finished -->

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

# POP3

Модуль обеспечивает поддержку почтового протокола POP3, позволяя серверу
загружать сообщения с почтовых серверов. Он подключается к серверам POP3,
получает заголовки и содержимое сообщений, обеспечивает безопасную
аутентификацию и управляет статусами сообщений, такими как загружено или
удалено.

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

## Директивы

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

### pop3_auth

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_auth` метод ...;   |
|------------------------------------------------------------------------------------------|--------------------------|
| По умолчанию                                                                             | `pop3_auth plain;`       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | mail, server             |

Задает разрешенные методы аутентификации POP3-клиентов. Поддерживаемые методы:

| `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). Для работы этого метода пароль должен храниться в незашифрованном виде.                                                                               |
| `cram-md5`    | [AUTH=CRAM-MD5](https://datatracker.ietf.org/doc/html/rfc2195). Для работы этого метода пароль должен храниться в незашифрованном виде.                                                                      |
| `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)                                                                                                                                            |

Методы аутентификации с передачей пароля открытым текстом (`USER/PASS`, `AUTH PLAIN` и `AUTH LOGIN`) включены всегда, однако если метод `plain` не указан, то AUTH PLAIN и AUTH LOGIN не будут автоматически добавляться в [pop3_capabilities](https://angie.software//angie/docs/configuration/modules/mail/mail_pop3.md#m-pop3-capabilities).

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

### pop3_capabilities

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `pop3_capabilities` расширение ...;   |
|------------------------------------------------------------------------------------------|---------------------------------------|
| По умолчанию                                                                             | `pop3_capabilities TOP USER UIDL;`    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | mail, server                          |

Позволяет указать список расширений [протокола POP3](https://datatracker.ietf.org/doc/html/rfc2449), выдаваемый клиенту по команде CAPA. В зависимости от значения директивы [starttls](https://angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#m-starttls) к этому списку автоматически добавляются методы аутентификации, указанные в директиве [pop3_auth](https://angie.software//angie/docs/configuration/modules/mail/mail_pop3.md#m-pop3-auth) (расширение [SASL](https://datatracker.ietf.org/doc/html/rfc2449)), и [STLS](https://datatracker.ietf.org/doc/html/rfc2595).

В данной директиве имеет смысл указать расширения, поддерживаемые POP3-серверами, на которые проксируются клиенты (если эти расширения относятся к командам, используемым после аутентификации, когда Angie прозрачно проксирует подключение клиента на бэкенд).