auth_http_timeout

Устанавливает таймаут для HTTP-запросов авторизации в почтовом модуле NGINX. — NGINX Mail Core

auth_http_timeout
mailmail server
Синтаксисauth_http_timeout time;
По умолчаниюnone
Контекстmail, mail server
МодульNGINX Mail Core
Аргументы1

Описание

Директива `auth_http_timeout` задаёт таймаут для обмена с HTTP‑сервером, используемым для аутентификации в почтовом модуле NGINX. Это особенно важно при интеграции со внешними системами аутентификации, когда получение ответа может занимать больше времени, чем хочется или ожидается. Параметр для `auth_http_timeout` задаётся в формате времени и может включать единицы измерения, такие как секунды (s), минуты (m), часы (h) и т.д. Если указанный таймаут превышается, почтовый сервер вернёт клиентам ответ с ошибкой. Это помогает предотвратить бесконечную блокировку почтовых транзакций из‑за медленных ответов на аутентификацию. Администраторам важно выбрать значение, которое балансирует между предоставлением достаточного времени для законных процессов аутентификации и ограничением времени ожидания, чтобы обеспечить отзывчивость для пользователей. Во многих случаях достаточно таймаута в несколько секунд. Эту директиву можно помещать в контекст `mail` или `mail server`, то есть она должна быть определена внутри соответствующего блока в конфигурационном файле NGINX, относящегося к почтовым службам. В рамках настройки конфигурации крайне важно правильно настроить эту директиву, чтобы обеспечить оптимальную работу почтового сервера, особенно в средах, где аутентификация пользователей происходит через внешний сервис.

Пример конфига

mail {
    auth_http_timeout 5s;
    server {
        listen 110;
        protocol pop3;
    }
}

Убедитесь, что значение таймаута разумно, чтобы не отклонять легитимные попытки аутентификации.

Проверьте, что внешний HTTP-сервер аутентификации отвечает в течение заданного времени ожидания.

Проверьте валидацию формата времени; использование недопустимых форматов может привести к ошибкам конфигурации.