Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_userid_module.xml @ 2846:fdf1464e1977

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moved banner to the external file to make partial rollout possible. An idea is to have several banners and show them with different probability specified by split directive in the nginx.conf
author Sergey Budnevitch <sb@waeme.net>
date Tue, 10 May 2022 18:07:27 +0400
parents c9545c331582
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 412
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 412
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 412
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 412
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 412
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
10 <module name="Модуль ngx_http_userid_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_userid_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
2597
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
13 rev="5">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
359
f9f8b6e98ada Translated "cookie" and clarified what the $uid_got and $uid_set are.
Ruslan Ermilov <ru@nginx.com>
parents: 358
diff changeset
18 Модуль <literal>ngx_http_userid_module</literal> выдаёт куки
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
19 для идентификации клиентов.
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
20 Для записи в лог полученных и выданных кук можно использовать встроенные
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
21 переменные <link id="var_uid_got">$uid_got</link> и
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
22 <link id="var_uid_set">$uid_set</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23 Модуль совместим с модулем
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24 <link url="http://www.lexa.ru/programs/mod-uid.html">mod_uid</link>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25 для Apache.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
31 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 <example>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
35 userid on;
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
36 userid_name uid;
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
37 userid_domain example.com;
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
38 userid_path /;
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
39 userid_expires 365d;
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
40 userid_p3p 'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
47 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49 <directive name="userid">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
50 <syntax>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
51 <literal>on</literal> |
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
52 <literal>v1</literal> |
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
53 <literal>log</literal> |
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
54 <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
55 <default>off</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
56 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
57 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
58 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
59
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60 <para>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
61 Разрешает или запрещает выдачу кук и запись приходящих кук в лог:
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
62 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
64 <tag-name><literal>on</literal></tag-name>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
65 <tag-desc>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
66 разрешает выдачу кук версии 2
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
67 и запись приходящих кук в лог;
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
68 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
70 <tag-name><literal>v1</literal></tag-name>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
71 <tag-desc>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
72 разрешает выдачу кук версии 1
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
73 и запись приходящих кук в лог;
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
74 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
76 <tag-name><literal>log</literal></tag-name>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
77 <tag-desc>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
78 запрещает выдачу кук,
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
79 но разрешает запись приходящих кук в лог;
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
80 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
82 <tag-name><literal>off</literal></tag-name>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
83 <tag-desc>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
84 запрещает выдачу кук и запись приходящих кук в лог.
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
85 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
87 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 <directive name="userid_domain">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
94 <syntax><value>имя</value> | <literal>none</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
95 <default>none</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
96 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
97 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
98 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
100 <para>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
101 Задаёт домен, для которого устанавливается кука.
359
f9f8b6e98ada Translated "cookie" and clarified what the $uid_got and $uid_set are.
Ruslan Ermilov <ru@nginx.com>
parents: 358
diff changeset
102 Параметр <literal>none</literal> запрещает выдавать домен для куки.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
107
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108 <directive name="userid_expires">
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
109 <syntax><value>время</value> | <literal>max</literal> |
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
110 <literal>off</literal></syntax>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
111 <default>off</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
112 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
113 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
114 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
115
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
116 <para>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
117 Задаёт время, в течение которого браузер должен хранить куку.
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
118 Параметр <literal>max</literal> устанавливает срок хранения куки до
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
119 31 декабря 2037 года 23:55:55 GMT.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
120 Указание параметра <literal>off</literal> позволяет ограничить время
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
121 действия куки сессией браузера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
123
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
124 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
125
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
126
2597
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
127 <directive name="userid_flags">
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
128 <syntax>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
129 <literal>off</literal> |
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
130 <value>флаг</value> ...</syntax>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
131 <default>off</default>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
132 <context>http</context>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
133 <context>server</context>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
134 <context>location</context>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
135 <appeared-in>1.19.3</appeared-in>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
136
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
137 <para>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
138 Если параметр не <literal>off</literal>,
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
139 задаёт один или несколько дополнительных флагов для куки:
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
140 <literal>secure</literal>,
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
141 <literal>httponly</literal>,
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
142 <literal>samesite=strict</literal>,
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
143 <literal>samesite=lax</literal>,
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
144 <literal>samesite=none</literal>.
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
145 </para>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
146
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
147 </directive>
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
148
c9545c331582 Added the userid_flags directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1233
diff changeset
149
684
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
150 <directive name="userid_mark">
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
151 <syntax>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
152 <value>буква</value> | <value>цифра</value> |
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
153 <literal>=</literal> |
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
154 <literal>off</literal></syntax>
684
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
155 <default>off</default>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
156 <context>http</context>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
157 <context>server</context>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
158 <context>location</context>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
159
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
160 <para>
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
161 Если параметр не <literal>off</literal>, включает механизм маркировки кук
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
162 и задаёт символ, используемый в качестве метки.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
163 Этот механизм позволяет добавить или изменить
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
164 <link id="userid_p3p"/> и/или время хранения куки, но при этом оставить
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
165 неизменным идентификатор клиента.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
166 Меткой может быть любая буква английского алфавита (с учётом регистра),
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
167 цифра или знак “<literal>=</literal>”.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
168 </para>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
169
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
170 <para>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
171 Если метка задана, то она сравнивается с первым дополняющим символом
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
172 в base64 представлении идентификатора клиента, передаваемом в куке.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
173 Если они не совпадают, то кука перепосылается с заданной меткой,
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
174 временем хранения и заголовком <header>P3P</header>.
684
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
175 </para>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
176
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
177 </directive>
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
178
2ff9c3ea8c98 Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
179
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180 <directive name="userid_name">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
181 <syntax><value>имя</value></syntax>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
182 <default>uid</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
183 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
184 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
185 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
186
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
187 <para>
359
f9f8b6e98ada Translated "cookie" and clarified what the $uid_got and $uid_set are.
Ruslan Ermilov <ru@nginx.com>
parents: 358
diff changeset
188 Задаёт имя куки.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
189 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
190
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
191 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
193
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 <directive name="userid_p3p">
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
195 <syntax><value>строка</value> | <literal>none</literal></syntax>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
196 <default>none</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
197 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
198 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
199 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
201 <para>
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
202 Задаёт значение для поля заголовка <header>P3P</header>, которое будет
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
203 выдаваться вместе с кукой.
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
204 Если задано специальное значение <literal>none</literal>,
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
205 то в ответе не будет заголовка <header>P3P</header>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
207
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
208 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
209
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211 <directive name="userid_path">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
212 <syntax><value>путь</value></syntax>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
213 <default>/</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
214 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
215 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
216 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218 <para>
412
d85b74249e04 Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents: 359
diff changeset
219 Задаёт путь, для которого устанавливается кука.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
220 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
221
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
222 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
225 <directive name="userid_service">
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
226 <syntax><value>номер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
227 <default>IP-адрес сервера</default>
358
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
228 <context>http</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
229 <context>server</context>
b8eb62f8c9ba Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 285
diff changeset
230 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
231
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
232 <para>
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
233 Если идентификаторы выдаются несколькими серверами (сервисами),
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
234 то каждому сервису следует назначить свой собственный <value>номер</value>,
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
235 для обеспечения уникальности выдаваемых идентификаторов клиентов.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
236 По умолчанию для кук первой версии используется ноль.
1075
6c021feec587 Removed unjustified non-breakable spaces.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
237 Для кук второй версии по умолчанию используется число, составленное из
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 868
diff changeset
238 последних четырёх октетов IP-адреса сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
239 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
240
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
241 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244
868
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
245
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
246 <section id="variables" name="Встроенные переменные">
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
247
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
248 <para>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
249 Модуль <literal>ngx_http_userid_module</literal>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
250 поддерживает следующие встроенные переменные:
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
251 <list type="tag">
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
252
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
253 <tag-name id="var_uid_got"><var>$uid_got</var></tag-name>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
254 <tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
255 Имя куки и полученный идентификатор клиента.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
256 </tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
257
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
258 <tag-name id="var_uid_reset"><var>$uid_reset</var></tag-name>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
259 <tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
260 Если значением является непустая строка не равная “<literal>0</literal>”,
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
261 то клиентские идентификаторы перевыдаются.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
262 Специальное значение “<literal>log</literal>” дополнительно приводит к выдаче
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
263 сообщений о перевыданных идентификаторах в
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
264 <link doc="../ngx_core_module.xml" id="error_log"/>.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
265 </tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
266
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
267 <tag-name id="var_uid_set"><var>$uid_set</var></tag-name>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
268 <tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
269 Имя куки и выданный идентификатор клиента.
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
270 </tag-desc>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
271
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
272 </list>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
273 </para>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
274
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
275 </section>
17d0c825f098 Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents: 684
diff changeset
276
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
277 </module>