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