Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 3043:9eadb98ec770

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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