Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_auth_basic_module.xml @ 303:1c239146beb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revision.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 31 Dec 2011 14:49:04 +0000
parents 4c6d2c614d2c
children 16244471304a
comparison
equal deleted inserted replaced
302:df728215db07 303:1c239146beb4
1 <?xml version="1.0"?> 1 <?xml version="1.0"?>
2 2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4 4
5 <module name="Директивы модуля ngx_http_auth_basic_module" 5 <module name="Модуль ngx_http_auth_basic_module"
6 link="/ru/docs/http/ngx_http_auth_basic_module.html" 6 link="/ru/docs/http/ngx_http_auth_basic_module.html"
7 lang="ru"> 7 lang="ru">
8 8
9 <section id="summary"> 9 <section id="summary">
10 10
11 <para> 11 <para>
12 Модуль ngx_http_auth_basic_module позволяет закрыть доступ с проверкой 12 Модуль <literal>ngx_http_auth_basic_module</literal> позволяет
13 имени и пароля по протоколу HTTP Basic Authentication. 13 ограничить доступ к ресурсам с проверкой имени и пароля по протоколу
14 “HTTP Basic Authentication”.
14 </para> 15 </para>
15 16
16 </section> 17 </section>
17 18
18 19
19 <section name="Пример конфигурации" id="example"> 20 <section id="example" name="Пример конфигурации">
20 21
21 <para> 22 <para>
22 <example> 23 <example>
23 location / { 24 location / {
24 auth_basic "closed site"; 25 auth_basic "closed site";
25 auth_basic_user_file conf/htpasswd; 26 auth_basic_user_file conf/htpasswd;
26 } 27 }
27 </example> 28 </example>
28 </para> 29 </para>
29 30
30 </section> 31 </section>
31 32
32 33
33 <section name="Директивы" id="directives"> 34 <section id="directives" name="Директивы">
34 35
35 <directive name="auth_basic"> 36 <directive name="auth_basic">
36 <syntax><value>строка</value> | <literal>off</literal></syntax> 37 <syntax><value>строка</value> | <literal>off</literal></syntax>
37 <default>off</default> 38 <default>off</default>
38 <context>http, server, location, limit_except</context> 39 <context>http</context>
40 <context>server</context>
41 <context>location</context>
42 <context>limit_except</context>
39 43
40 <para> 44 <para>
41 Директива включает проверку имени и пароля по протоколу 45 Включает проверку имени и пароля по протоколу “HTTP Basic Authentication”.
42 HTTP Basic Authentication. 46 Заданный параметр используется в качестве <value>realm</value>.
43 Заданный параметр используется в качестве realm. 47 Параметр <literal>off</literal> позволяет отменить действие унаследованной
44 Параметр "off" позволяет отменить действие унаследованной с нижележащего 48 с предыдущего уровня конфигурации директивы <literal>auth_basic</literal>.
45 уровня директивы.
46 </para> 49 </para>
47 50
48 </directive> 51 </directive>
49 52
50 53
51 <directive name="auth_basic_user_file"> 54 <directive name="auth_basic_user_file">
52 <syntax><value>файл</value></syntax> 55 <syntax><value>файл</value></syntax>
53 <default/> 56 <default/>
54 <context>http, server, location, limit_except</context> 57 <context>http</context>
58 <context>server</context>
59 <context>location</context>
60 <context>limit_except</context>
55 61
56 <para> 62 <para>
57 Директива задаёт файл, в котором хранятся имена и пароли 63 Задаёт файл, в котором хранятся имена и пароли пользователей.
58 пользователей. Формат файла следующий: 64 Формат файла следующий:
59 <example> 65 <example>
60 # комментарий 66 # комментарий
61 имя1:пароль1 67 имя1:пароль1
62 имя2:пароль2:комментарий 68 имя2:пароль2:комментарий
63 имя3:пароль3 69 имя3:пароль3
64 </example> 70 </example>
65 </para> 71 </para>
66 72
67 <para> 73 <para>
68 Пароли должны быть зашифрованы функцией crypt(3). 74 Пароли должны быть зашифрованы функцией <c-func>crypt</c-func>.
69 Для создания файла с паролями можно воспользоваться программой 75 Для создания файла с паролями можно воспользоваться командой
70 <command>htpasswd</command> из дистрибутива Apache. 76 <command>htpasswd</command> из дистрибутива веб-сервера Apache.
71 </para> 77 </para>
72 78
73 </directive> 79 </directive>
74 80
75 </section> 81 </section>