Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_userid_module.xml @ 3099:9cfda14d0109 default tip
freenginx-1.27.4
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Tue, 03 Sep 2024 13:15:18 +0300 |
parents | c9545c331582 |
children |
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 | 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 | 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 | 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 | 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 | 35 userid on; |
36 userid_name uid; | |
37 userid_domain example.com; | |
38 userid_path /; | |
39 userid_expires 365d; | |
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 | 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 | 50 <syntax> |
358 | 51 <literal>on</literal> | |
52 <literal>v1</literal> | | |
53 <literal>log</literal> | | |
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 | 56 <context>http</context> |
57 <context>server</context> | |
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 | 62 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
63 |
358 | 64 <tag-name><literal>on</literal></tag-name> |
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 | 68 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 |
358 | 70 <tag-name><literal>v1</literal></tag-name> |
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 | 74 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
75 |
358 | 76 <tag-name><literal>log</literal></tag-name> |
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 | 80 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
81 |
358 | 82 <tag-name><literal>off</literal></tag-name> |
83 <tag-desc> | |
412
d85b74249e04
Use a declinable variant for "cookie".
Ruslan Ermilov <ru@nginx.com>
parents:
359
diff
changeset
|
84 запрещает выдачу кук и запись приходящих кук в лог. |
358 | 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 | 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 | 96 <context>http</context> |
97 <context>server</context> | |
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 | 112 <context>http</context> |
113 <context>server</context> | |
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 | 183 <context>http</context> |
184 <context>server</context> | |
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 | 197 <context>http</context> |
198 <context>server</context> | |
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 | 214 <context>http</context> |
215 <context>server</context> | |
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 | 228 <context>http</context> |
229 <context>server</context> | |
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 | 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> |