Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_access_module.xml @ 315:e00f8f8c0486

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Translated ngx_http_access_module, ngx_http_addition_module, ngx_http_auth_basic_module, ngx_http_autoindex_module, and ngx_http_browser_module into English.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 13 Jan 2012 18:05:01 +0000
parents
children a4fa80755eab
comparison
equal deleted inserted replaced
314:95d5dc7c9884 315:e00f8f8c0486
1 <?xml version="1.0"?>
2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4
5 <module name="Module ngx_http_access_module"
6 link="/en/docs/http/ngx_http_access_module.html"
7 lang="en">
8
9 <section id="summary">
10
11 <para>
12 The <literal>ngx_http_access_module</literal> module allows
13 to limit access based on client IP addresses.
14 </para>
15
16 </section>
17
18
19 <section id="example" name="Example Configuration">
20
21 <para>
22 <example>
23 location / {
24 deny 192.168.1.1;
25 allow 192.168.1.0/24;
26 allow 10.1.1.0/16;
27 deny all;
28 }
29 </example>
30 </para>
31
32 <para>
33 The rules are checked in sequence until the first match is found.
34 In this example, an access is allowed only for networks
35 <literal>10.1.1.0/16</literal> and <literal>192.168.1.0/24</literal>
36 excluding the address <literal>192.168.1.1</literal>.
37 In case of a lot of rules, the use of the
38 <link doc="ngx_http_geo_module.xml">ngx_http_geo_module</link>
39 module variables is preferable.
40 </para>
41
42 </section>
43
44
45 <section id="directives" name="Directives">
46
47 <directive name="allow">
48 <syntax>
49 <value>address</value> |
50 <value>CIDR</value> |
51 <literal>all</literal></syntax>
52 <default/>
53 <context>http</context>
54 <context>server</context>
55 <context>location</context>
56 <context>limit_except</context>
57
58 <para>
59 Allows access for the specified network or address.
60 </para>
61
62 </directive>
63
64
65 <directive name="deny">
66 <syntax>
67 <value>address</value> |
68 <value>CIDR</value> |
69 <literal>all</literal></syntax>
70 <default/>
71 <context>http</context>
72 <context>server</context>
73 <context>location</context>
74 <context>limit_except</context>
75
76 <para>
77 Denies access for the specified network or address.
78 </para>
79
80 </directive>
81
82 </section>
83
84 </module>