userid_domain

Директива `userid_domain` задаёт домен для функции `userid` в NGINX, позволяя связывать идентификаторы сессий с определённым доменом. — NGINX HTTP Core

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

Описание

Директива `userid_domain` используется в HTTP‑ядре модуля NGINX для определения конкретного домена, который должен быть ассоциирован с идентификаторами сессий, создаваемыми функцией `userid`. Эта директива применима в контекстах `http`, `server` и `location`, позволяя веб‑администраторам указать домен для привязки cookie, что обеспечивает корректную обработку управления сессиями между различными поддоменами или внутри одного домена. При установке `userid_domain` NGINX будет добавлять указанный домен в cookie сессии, что важно для приложений, зависящих от согласованности сессий и аутентификации пользователей. Гарантируя, что cookie ограничены целевым доменом, директива помогает эффективно управлять пользовательскими сессиями, повышая безопасность и качество пользовательского опыта. Домен должен быть действительным и может включать поддомены, что делает директиву гибкой для различных архитектур развёртывания. Директива принимает один аргумент — имя домена (например, "example.com"). Крайне важно, чтобы указанный домен соответствовал реальному сценарию использования, чтобы избежать проблем с управлением сессиями, особенно при переходах пользователей между поддоменами. Эта директива также напрямую влияет на поддержание сессий пользователей и является неотъемлемой частью модели безопасности приложений, работающих на NGINX.

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

http {
    userid_domain example.com;
}

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

Если директива не задана, это может привести к проблемам с идентификаторами сессий или уязвимостям безопасности.

Смена домена может нарушить текущие пользовательские сессии. Обязательно уведомите пользователей, если сессии будут прерваны. Проведите достаточное тестирование перед развертыванием.