nginx

Модуль 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-адрес сервера.