userid_domain

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

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

Описание

Директива userid_domain используется в HTTP‑ядре модуля NGINX для определения конкретного домена, который должен быть ассоциирован с идентификаторами сессий, создаваемыми функцией userid. Эта директива применима в контекстах http, server и location, позволяя веб‑администраторам указать домен для привязки cookie, что обеспечивает корректную обработку управления сессиями между различными поддоменами или внутри одного домена.

При установке userid_domain NGINX будет добавлять указанный домен в cookie сессии, что важно для приложений, зависящих от согласованности сессий и аутентификации пользователей. Гарантируя, что cookie ограничены целевым доменом, директива помогает эффективно управлять пользовательскими сессиями, повышая безопасность и качество пользовательского опыта. Домен должен быть действительным и может включать поддомены, что делает директиву гибкой для различных архитектур развёртывания.

Директива принимает один аргумент — имя домена (например, "example.com"). Крайне важно, чтобы указанный домен соответствовал реальному сценарию использования, чтобы избежать проблем с управлением сессиями, особенно при переходах пользователей между поддоменами. Эта директива также напрямую влияет на поддержание сессий пользователей и является неотъемлемой частью модели безопасности приложений, работающих на NGINX.

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

http {
    userid_domain example.com;
}

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

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

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

← Ко всем директивам