Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_core_module.xml @ 3043:9eadb98ec770
Free nginx: removed commercial version documentation.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Wed, 14 Feb 2024 20:05:49 +0300 |
parents | cbd963190c15 |
children | 3b5594157fab |
comparison
equal
deleted
inserted
replaced
3042:19e4897acb84 | 3043:9eadb98ec770 |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Module ngx_http_core_module" | 10 <module name="Module ngx_http_core_module" |
11 link="/en/docs/http/ngx_http_core_module.html" | 11 link="/en/docs/http/ngx_http_core_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="106"> | 13 rev="107"> |
14 | 14 |
15 <section id="directives" name="Directives"> | 15 <section id="directives" name="Directives"> |
16 | 16 |
17 <directive name="absolute_redirect"> | 17 <directive name="absolute_redirect"> |
18 <syntax><literal>on</literal> | <literal>off</literal></syntax> | 18 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
258 <appeared-in>1.17.10</appeared-in> | 258 <appeared-in>1.17.10</appeared-in> |
259 | 259 |
260 <para> | 260 <para> |
261 Delays processing of unauthorized requests with 401 response code | 261 Delays processing of unauthorized requests with 401 response code |
262 to prevent timing attacks when access is limited by | 262 to prevent timing attacks when access is limited by |
263 <link doc="ngx_http_auth_basic_module.xml">password</link>, by the | 263 <link doc="ngx_http_auth_basic_module.xml">password</link> or by the |
264 <link doc="ngx_http_auth_request_module.xml">result of subrequest</link>, | 264 <link doc="ngx_http_auth_request_module.xml">result of subrequest</link>. |
265 or by <link doc="ngx_http_auth_jwt_module.xml">JWT</link>. | |
266 </para> | 265 </para> |
267 | 266 |
268 </directive> | 267 </directive> |
269 | 268 |
270 | 269 |
853 | 852 |
854 <listitem> | 853 <listitem> |
855 requests redirected by the | 854 requests redirected by the |
856 <link id="error_page"/>, | 855 <link id="error_page"/>, |
857 <link doc="ngx_http_index_module.xml" id="index"/>, | 856 <link doc="ngx_http_index_module.xml" id="index"/>, |
858 <link doc="ngx_http_internal_redirect_module.xml" id="internal_redirect"/>, | |
859 <link doc="ngx_http_random_index_module.xml" id="random_index"/>, and | 857 <link doc="ngx_http_random_index_module.xml" id="random_index"/>, and |
860 <link id="try_files"/> directives; | 858 <link id="try_files"/> directives; |
861 </listitem> | 859 </listitem> |
862 | 860 |
863 <listitem> | 861 <listitem> |
1068 or | 1066 or |
1069 <literal>PATCH</literal>. | 1067 <literal>PATCH</literal>. |
1070 Allowing the <literal>GET</literal> method makes the | 1068 Allowing the <literal>GET</literal> method makes the |
1071 <literal>HEAD</literal> method also allowed. | 1069 <literal>HEAD</literal> method also allowed. |
1072 Access to other methods can be limited using the | 1070 Access to other methods can be limited using the |
1073 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, | 1071 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> and |
1074 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, | 1072 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> |
1075 and | |
1076 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link> | |
1077 (1.13.10) | |
1078 modules directives: | 1073 modules directives: |
1079 <example> | 1074 <example> |
1080 limit_except GET { | 1075 limit_except GET { |
1081 allow 192.168.1.0/32; | 1076 allow 192.168.1.0/32; |
1082 deny all; | 1077 deny all; |
2184 <directive name="resolver"> | 2179 <directive name="resolver"> |
2185 <syntax> | 2180 <syntax> |
2186 <value>address</value> ... | 2181 <value>address</value> ... |
2187 [<literal>valid</literal>=<value>time</value>] | 2182 [<literal>valid</literal>=<value>time</value>] |
2188 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>] | 2183 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>] |
2189 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>] | 2184 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax> |
2190 [<literal>status_zone</literal>=<value>zone</value>]</syntax> | |
2191 <default/> | 2185 <default/> |
2192 <context>http</context> | 2186 <context>http</context> |
2193 <context>server</context> | 2187 <context>server</context> |
2194 <context>location</context> | 2188 <context>location</context> |
2195 | 2189 |
2235 To prevent DNS spoofing, it is recommended | 2229 To prevent DNS spoofing, it is recommended |
2236 configuring DNS servers in a properly secured trusted local network. | 2230 configuring DNS servers in a properly secured trusted local network. |
2237 </note> | 2231 </note> |
2238 </para> | 2232 </para> |
2239 | 2233 |
2240 <para id="resolver_status_zone"> | |
2241 The optional <literal>status_zone</literal> parameter (1.17.1) | |
2242 enables | |
2243 <link doc="ngx_http_api_module.xml" id="resolvers_">collection</link> | |
2244 of DNS server statistics of requests and responses | |
2245 in the specified <value>zone</value>. | |
2246 The parameter is available as part of our | |
2247 <commercial_version>commercial subscription</commercial_version>. | |
2248 </para> | |
2249 | |
2250 </directive> | 2234 </directive> |
2251 | 2235 |
2252 | 2236 |
2253 <directive name="resolver_timeout"> | 2237 <directive name="resolver_timeout"> |
2254 <syntax><value>time</value></syntax> | 2238 <syntax><value>time</value></syntax> |
2312 <para> | 2296 <para> |
2313 Allows access if all (<literal>all</literal>) or at least one | 2297 Allows access if all (<literal>all</literal>) or at least one |
2314 (<literal>any</literal>) of the | 2298 (<literal>any</literal>) of the |
2315 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, | 2299 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, |
2316 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, | 2300 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, |
2317 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>, | |
2318 or | 2301 or |
2319 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link> | 2302 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link> |
2320 modules allow access. | 2303 modules allow access. |
2321 </para> | 2304 </para> |
2322 | 2305 |
2323 <para> | 2306 <para> |
2324 Example: | 2307 Example: |
2665 | 2648 |
2666 <directive name="server_tokens"> | 2649 <directive name="server_tokens"> |
2667 <syntax> | 2650 <syntax> |
2668 <literal>on</literal> | | 2651 <literal>on</literal> | |
2669 <literal>off</literal> | | 2652 <literal>off</literal> | |
2670 <literal>build</literal> | | 2653 <literal>build</literal></syntax> |
2671 <value>string</value></syntax> | |
2672 <default>on</default> | 2654 <default>on</default> |
2673 <context>http</context> | 2655 <context>http</context> |
2674 <context>server</context> | 2656 <context>server</context> |
2675 <context>location</context> | 2657 <context>location</context> |
2676 | 2658 |
2681 | 2663 |
2682 <para id="server_tokens_build"> | 2664 <para id="server_tokens_build"> |
2683 The <literal>build</literal> parameter (1.11.10) enables emitting | 2665 The <literal>build</literal> parameter (1.11.10) enables emitting |
2684 a <link doc="../configure.xml" id="build">build name</link> | 2666 a <link doc="../configure.xml" id="build">build name</link> |
2685 along with nginx version. | 2667 along with nginx version. |
2686 </para> | |
2687 | |
2688 <para> | |
2689 Additionally, as part of our | |
2690 <commercial_version>commercial subscription</commercial_version>, | |
2691 starting from version 1.9.13 | |
2692 the signature on error pages and | |
2693 the <header>Server</header> response header field value | |
2694 can be set explicitly using the <value>string</value> with variables. | |
2695 An empty string disables the emission of the <header>Server</header> field. | |
2696 </para> | 2668 </para> |
2697 | 2669 |
2698 </directive> | 2670 </directive> |
2699 | 2671 |
2700 | 2672 |