Модуль ngx_http_userid

Модуль ngx_http_userid_module

english
עברית
日本語
русский
türkçe

новости [en]

об nginx
скачать
безопасность [en]
pgp ключи [en]
документация
введение [en]
howto
faq
trac
wiki
ссылки [en]
книги [en]
поддержка
пожертвования [en]
nginx.com

Пример конфигурации
Директивы
     userid
     userid_domain
     userid_expires
     userid_name
     userid_p3p
     userid_path
     userid_service

Модуль ngx_http_userid_module выдаёт куки для идентификации клиентов. Для записи в лог полученных и выданных куки можно использовать встроенные переменные $uid_got и $uid_set. Модуль совместим с модулем mod_uid для Apache.

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

userid         on;
userid_name    uid;
userid_domain  example.com;
userid_path    /;
userid_expires 365d;
userid_p3p     'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';

Директивы

синтаксис:	`userid on \| v1 \| log \| off;`
умолчание:	userid off;
контекст:	`http`, `server`, `location`

Разрешает или запрещает выдавать куки и записывать приходящие куки в лог:

on: разрешает выдавать куки версии 2 и записывать приходящие куки в лог;
v1: разрешает выдавать куки версии 1 и записывать приходящие куки в лог;
log: запрещает выдавать куки, но разрешает записывать приходящие куки в лог;
off: запрещает выдавать куки и записывать приходящие куки в лог.

синтаксис:	`userid_domain имя \| none;`
умолчание:	userid_domain none;
контекст:	`http`, `server`, `location`

Задаёт домен, для которого устанавливается куки. Параметр none запрещает выдавать домен для куки.

синтаксис:	`userid_expires время \| max;`
умолчание:	—
контекст:	`http`, `server`, `location`

Задаёт время, в течение которого браузер должен хранить куки. Параметр max задаёт время 31 декабря 2037 года 23:55:55 GMT. Это максимальное время, которое понимают старые браузеры.

синтаксис:	`userid_name имя;`
умолчание:	userid_name uid;
контекст:	`http`, `server`, `location`

Задаёт имя куки.

синтаксис:	`userid_p3p строка;`
умолчание:	—
контекст:	`http`, `server`, `location`

Задаёт значение для поля заголовка “P3P”, который будет выдаваться вместе с куки.

синтаксис:	`userid_path путь;`
умолчание:	userid_path /;
контекст:	`http`, `server`, `location`

Задаёт путь, для которого устанавливается куки.

синтаксис:	`userid_service число;`
умолчание:	userid_service IP-адрес сервера;
контекст:	`http`, `server`, `location`

Задаёт номер сервиса, выдавшего куки. По умолчанию для куки первой версии используется ноль, а для второй — IP-адрес сервера.