Mercurial > hg > nginx-site
annotate xml/en/docs/http/ngx_http_userid_module.xml @ 921:d7991f499d9f
Access: support for UNIX-domain client addresses (ticket #359).
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 24 May 2013 11:40:12 +0400 |
parents | 17d0c825f098 |
children | 95c3c3bbf1ce |
rev | line source |
---|---|
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
360
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
360
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
360
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
360
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
360
diff
changeset
|
7 |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 <module name="Module ngx_http_userid_module" |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 link="/en/docs/http/ngx_http_userid_module.html" |
589 | 12 lang="en" |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
13 rev="3"> |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 <section id="summary"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 The <literal>ngx_http_userid_module</literal> module sets cookies |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 suitable for client identification. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 Received and set cookies can be logged using the embedded variables |
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> and |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
22 <link id="var_uid_set">$uid_set</link>. |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 This module is compatible with the |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 <link url="http://www.lexa.ru/programs/mod-uid-eng.html">mod_uid</link> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 module for Apache. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 </section> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 <section id="example" name="Example Configuration"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 <example> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 userid on; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 userid_name uid; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 userid_domain example.com; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 userid_path /; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 userid_expires 365d; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 userid_p3p 'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"'; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 </example> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 </section> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 <section id="directives" name="Directives"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 <directive name="userid"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
50 <syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 <literal>on</literal> | |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
52 <literal>v1</literal> | |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 <literal>log</literal> | |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 <literal>off</literal></syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 <default>off</default> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 Allows or prohibits to set cookies and log the received cookies: |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
62 <list type="tag"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
63 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 <tag-name><literal>on</literal></tag-name> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 <tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 allows to set version 2 cookies |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 and log the received cookies; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 </tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 <tag-name><literal>v1</literal></tag-name> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
71 <tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 allows to set version 1 cookies |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
73 and log the received cookies; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
74 </tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 <tag-name><literal>log</literal></tag-name> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 <tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 prohibits to set cookies |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 but allows to log the received cookies; |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 </tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 <tag-name><literal>off</literal></tag-name> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 <tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 prohibits to set cookies and log the received cookies. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 </tag-desc> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 </list> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 <directive name="userid_domain"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 <syntax><value>name</value> | <literal>none</literal></syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
95 <default>none</default> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
99 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 Defines a domain for which the cookie is set. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 The parameter <literal>none</literal> disables setting a domain for a cookie. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
107 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
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>time</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> |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
117 Sets a time during which a browser should keep the cookie. |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
118 The parameter <literal>max</literal> will cause the cookie to expire on |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
119 “<literal>31 Dec 2037 23:55:55 GMT</literal>”. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
120 This is the maximum time understood by old browsers. |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
121 The parameter <literal>off</literal> will cause the cookie to expire at |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
122 the end of a browser session. |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
123 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
124 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
125 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 |
684
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
128 <directive name="userid_mark"> |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
129 <syntax> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
130 <value>letter</value> | <value>digit</value> | |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
131 <literal>=</literal> | |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
132 <literal>off</literal></syntax> |
684
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
133 <default>off</default> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
134 <context>http</context> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
135 <context>server</context> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
136 <context>location</context> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
137 |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
138 <para> |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
139 If parameter is not <literal>off</literal>, enables the cookie marking |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
140 mechanism and sets a character used as a mark. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
141 This mechanism allows to add or change |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
142 <link id="userid_p3p"/> and/or cookie expiration time while |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
143 preserving the client identifier. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
144 The mark can be any letter of the English alphabet (case-sensitive), |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
145 digit, or the “<literal>=</literal>” character. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
146 </para> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
147 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
148 <para> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
149 If a mark is set, it is compared with the first padding symbol |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
150 in the base64 representation of client identifier passed in a cookie. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
151 If they do not match, a cookie is resent with the specified mark, |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
152 expiration time and a <header>P3P</header> header. |
684
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
153 </para> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
154 |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
155 </directive> |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
156 |
2ff9c3ea8c98
Documented the userid_mark directive in the userid module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
157 |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
158 <directive name="userid_name"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
159 <syntax><value>name</value></syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
160 <default>uid</default> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
161 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
162 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
163 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
164 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
165 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
166 Sets a cookie name. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
167 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
168 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
169 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
170 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
171 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
172 <directive name="userid_p3p"> |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
173 <syntax><value>string</value> | <literal>none</literal></syntax> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
174 <default>none</default> |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
175 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
176 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
177 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
179 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
180 Sets a value for the <header>P3P</header> header field that will be |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
181 sent along with a cookie. |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
182 If set to the special value <literal>none</literal>, |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
183 the <header>P3P</header> header will not be sent in a response. |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
184 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
185 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
186 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
187 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
188 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
189 <directive name="userid_path"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
190 <syntax><value>path</value></syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
191 <default>/</default> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
192 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
193 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
194 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
195 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
196 <para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
197 Defines a path for which the cookie is set. |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
198 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
199 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
200 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
201 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
202 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
203 <directive name="userid_service"> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
204 <syntax><value>number</value></syntax> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
205 <default>IP address of the server</default> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
206 <context>http</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
207 <context>server</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
208 <context>location</context> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
209 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
210 <para> |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
211 If identifiers are issued by multiple servers (services), |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
212 each service should be assigned its own <value>number</value> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
213 in order to ensure that client identifiers are unique. |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
214 For version 1 cookies the default value is zero. |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
215 For version 2 cookies this is the number composed from the last four |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
216 octets of the server’s IP address. |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
217 </para> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
218 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
219 </directive> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
220 |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
221 </section> |
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
222 |
868
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
223 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
224 <section id="variables" name="Embedded variables"> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
225 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
226 <para> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
227 The <literal>ngx_http_userid_module</literal> module |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
228 supports the following embedded variables: |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
229 <list type="tag"> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
230 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
231 <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
|
232 <tag-desc> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
233 The cookie name and received client identifier. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
234 </tag-desc> |
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 <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
|
237 <tag-desc> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
238 If set to a non-empty string, and it is not “<literal>0</literal>”, |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
239 client identifiers are reset. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
240 The special value “<literal>log</literal>” additionally leads to the output of |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
241 messages about reset identifiers to the |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
242 <link doc="../ngx_core_module.xml" id="error_log"/>. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
243 </tag-desc> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
244 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
245 <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
|
246 <tag-desc> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
247 The cookie name and sent client identifier. |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
248 </tag-desc> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
249 |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
250 </list> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
251 </para> |
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 </section> |
17d0c825f098
Revised the userid module documentation.
Homutov Vladimir <vl@nginx.com>
parents:
684
diff
changeset
|
254 |
360
43f379b12b76
English translation of ngx_http_userid_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 </module> |