userid_name

Директива `userid_name` задаёт имя пользователя, которое будет возвращено в заголовке HTTP-ответа. — NGINX HTTP Core

userid_name
httpserverlocation
Синтаксисuserid_name name;
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

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

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

http {
    userid_name "example_user";

    server {
        location / {
            proxy_pass http://backend;
        }
    }
}

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

Учтите последствия раскрытия имён пользователей в HTTP-заголовках для клиента.

Неправильное размещение директивы в неподходящем контексте (http, server или location) может привести к ошибкам.