auth_http_header

Директива auth_http_header задаёт HTTP-заголовки, используемые для аутентификации в модуле NGINX Mail. — NGINX Mail Core

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

Описание

Директива `auth_http_header` используется в NGINX Mail Core для определения конкретных HTTP-заголовков, которые будут отправляться для целей аутентификации при подключении клиентов. Эта директива особенно полезна в сценариях, когда механизмы аутентификации требуют специальных заголовков для корректной обработки вышестоящими серверами. Указывая соответствующие заголовки, директива обеспечивает беспрепятственное выполнение процессов аутентификации во время почтовых транзакций. Эта директива принимает два аргумента: первый аргумент задаёт имя заголовка, а второй — ожидаемое значение этого заголовка. Когда клиент пытается пройти аутентификацию, NGINX включит эти заголовки в коммуникацию для проверки пользователей с удалённым сервисом аутентификации. Это критично в средах, где интегрированные системы требуют специальных форматов входных данных для эффективного управления аутентификацией. В составе конфигурации почтового сервера эта директива должна использоваться в контексте блоков почтового сервера, чтобы гарантировать её корректное применение к целевым почтовым сервисам. Правильная настройка этой директивы необходима для того, чтобы внешние сервисы аутентификации могли корректно распознавать и обрабатывать указанные заголовки, обеспечивая тем самым успешный поток аутентификации.

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

mail {
    auth_http_header "X-Auth-User" "$remote_user";
}

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

Убедитесь, что задаваемые заголовки не конфликтуют с уже существующими заголовками, используемыми сервером NGINX или почтовым клиентом.