Модуль ngx_http_userid

Модуль ngx_http_userid_module

english
русский

简体中文
עברית
日本語
türkçe

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

trac
wiki
twitter
nginx.com

Пример конфигурации
Директивы
     userid
     userid_domain
     userid_expires
     userid_mark
     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_mark off \| буква \| цифра \| =;`
умолчание:	userid_mark off;
контекст:	`http`, `server`, `location`

Задаёт первый символ хвоста base64 (по умолчанию “==”) представления куки и перевыдаёт все принятые куки, у которых этот хвост другой. Это полезно, если необходимо добавить или поменять P3P или время хранения куки, но при этом оставить неизменным закодированное внутри число.

синтаксис:	`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-адрес сервера.