Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_ssl_module.xml @ 787:180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Fri, 21 Dec 2012 07:22:33 +0000 |
parents | cd581dbdaf76 |
children | b95a6d779c89 |
rev | line source |
---|---|
222
bfe3eff81d04
Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
1 <?xml version="1.0"?> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
538
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
538
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
538
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
538
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
538
diff
changeset
|
7 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
9 |
379 | 10 <module name="Модуль ngx_http_ssl_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 link="/ru/docs/http/ngx_http_ssl_module.html" |
589 | 12 lang="ru" |
763
cd581dbdaf76
The "optional_no_ca" parameter of the "ssl_verify_client" directive
Ruslan Ermilov <ru@nginx.com>
parents:
717
diff
changeset
|
13 rev="5"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
15 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 <para> |
379 | 18 Модуль <literal>ngx_http_ssl_module</literal> обеспечивает работу |
19 по протоколу HTTPS. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
20 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
21 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
22 <para> |
379 | 23 По умолчанию этот модуль не собирается, его сборку необходимо |
24 разрешить с помощью конфигурационного параметра | |
271 | 25 <literal>--with-http_ssl_module</literal>. |
379 | 26 <note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 Для сборки и работы этого модуля нужна библиотека |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
28 <link url="http://www.openssl.org">OpenSSL</link>. |
379 | 29 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
30 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
32 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 |
379 | 35 <section id="example" name="Пример конфигурации"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
36 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 Для уменьшения загрузки процессора рекомендуется |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
39 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
42 установить число рабочих процессов равным числу процессоров, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
43 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
44 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
45 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
46 разрешить keep-alive соединения, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
47 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
48 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
49 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
50 включить разделяемый кэш сессий, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
51 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
52 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
53 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
54 выключить встроенный кэш сессий |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
55 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
56 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
57 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
58 и, возможно, увеличить время жизни сессии (по умолчанию 5 минут): |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
59 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
60 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
61 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
62 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
63 <example> |
379 | 64 <emphasis>worker_processes 2;</emphasis> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
65 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
66 http { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
67 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
68 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 server { |
379 | 71 listen 443; |
72 <emphasis>keepalive_timeout 70;</emphasis> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
73 |
379 | 74 ssl on; |
75 ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2; | |
76 ssl_ciphers AES128-SHA:AES256-SHA:RC4-SHA:DES-CBC3-SHA:RC4-MD5; | |
77 ssl_certificate /usr/local/nginx/conf/cert.pem; | |
78 ssl_certificate_key /usr/local/nginx/conf/cert.key; | |
79 <emphasis>ssl_session_cache shared:SSL:10m;</emphasis> | |
80 <emphasis>ssl_session_timeout 10m;</emphasis> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
81 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
82 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
83 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
84 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
85 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
86 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
87 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
88 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
89 |
379 | 90 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
91 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
92 <directive name="ssl"> |
271 | 93 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
94 <default>off</default> |
379 | 95 <context>http</context> |
96 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
97 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 <para> |
379 | 99 Разрешает протокол HTTPS для данного виртуального сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
100 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
101 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
102 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
103 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
105 <directive name="ssl_certificate"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
106 <syntax><value>файл</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
107 <default/> |
379 | 108 <context>http</context> |
109 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 <para> |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
112 Указывает <value>файл</value> с сертификатом в формате PEM |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
113 для данного виртуального сервера. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
114 Если вместе с основным сертификатом нужно указать промежуточные, |
713
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
115 то они должны находиться в этом же файле в следующем порядке: сначала |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
116 основной сертификат, а затем промежуточные. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
117 В этом же файле может находиться секретный ключ в формате PEM. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
118 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
119 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
120 <para> |
280 | 121 Нужно иметь в виду, что из-за ограничения протокола HTTPS |
379 | 122 виртуальные серверы должны слушать на разных IP-адресах: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
123 <example> |
379 | 124 server { |
125 listen 192.168.1.1:443; | |
126 server_name one.example.com; | |
127 ssl_certificate /usr/local/nginx/conf/one.example.com.cert; | |
128 ... | |
129 } | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 |
379 | 131 server { |
132 listen 192.168.1.2:443; | |
133 server_name two.example.com; | |
134 ssl_certificate /usr/local/nginx/conf/two.example.com.cert; | |
135 ... | |
136 } | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
137 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
138 иначе для второго сайта будет выдаваться |
379 | 139 <link doc="configuring_https_servers.xml" |
140 id="name_based_https_servers">сертификат первого сервера</link>. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
142 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
143 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
144 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
145 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
146 <directive name="ssl_certificate_key"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
147 <syntax><value>файл</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
148 <default/> |
379 | 149 <context>http</context> |
150 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
151 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
152 <para> |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
153 Указывает <value>файл</value> с секретным ключом в формате PEM |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
154 для данного виртуального сервера. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
155 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
156 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
157 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
158 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
159 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
160 <directive name="ssl_ciphers"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
161 <syntax><value>шифры</value></syntax> |
538
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
162 <default>HIGH:!aNULL:!MD5</default> |
379 | 163 <context>http</context> |
164 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
165 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
166 <para> |
379 | 167 Описывает разрешённые шифры. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
168 Шифры задаются в формате, поддерживаемом библиотекой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
169 OpenSSL, например: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
170 <example> |
538
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
171 ssl_ciphers ALL:!aNULL:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
172 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
173 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
174 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
175 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
176 Полный список можно посмотреть с помощью команды |
271 | 177 “<command>openssl ciphers</command>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
178 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
179 |
538
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
180 <para> |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
181 <note> |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
182 В предыдущих версиях nginx по умолчанию использовались |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
183 <link doc="configuring_https_servers.xml" id="compatibility">другие</link> |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
184 шифры. |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
185 </note> |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
186 </para> |
58dd64aef626
Documented ciphers used by default in modern nginx versions (closes #177).
Ruslan Ermilov <ru@nginx.com>
parents:
393
diff
changeset
|
187 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
188 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
189 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
190 |
379 | 191 <directive name="ssl_client_certificate"> |
192 <syntax><value>файл</value></syntax> | |
193 <default/> | |
194 <context>http</context> | |
195 <context>server</context> | |
196 | |
197 <para> | |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
198 Указывает <value>файл</value> с доверенными сертификатами CA в формате |
713
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
199 PEM, которые используются для проверки клиентских сертификатов и |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
200 ответов OCSP, если включён <link id="ssl_stapling"/>. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
201 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
202 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
203 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
204 Список сертификатов будет отправляться клиентам. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
205 Если это нежелательно, можно воспользоваться директивой |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
206 <link id="ssl_trusted_certificate"/>. |
379 | 207 </para> |
208 | |
209 </directive> | |
210 | |
211 | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
212 <directive name="ssl_crl"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
213 <syntax><value>файл</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
214 <default/> |
379 | 215 <context>http</context> |
216 <context>server</context> | |
217 <appeared-in>0.8.7</appeared-in> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
218 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
219 <para> |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
220 Указывает <value>файл</value> с отозванными сертификатами (CRL) |
379 | 221 в формате PEM, используемыми для проверки клиентских сертификатов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
222 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
223 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
224 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
225 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
227 <directive name="ssl_dhparam"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
228 <syntax><value>файл</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
229 <default/> |
379 | 230 <context>http</context> |
231 <context>server</context> | |
232 <appeared-in>0.7.2</appeared-in> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
233 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
234 <para> |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
235 Указывает <value>файл</value> с параметрами для шифров с обменом EDH-ключами. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
236 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
237 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
238 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
239 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
240 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
241 <directive name="ssl_prefer_server_ciphers"> |
271 | 242 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
243 <default>off</default> |
379 | 244 <context>http</context> |
245 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
246 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
247 <para> |
379 | 248 Указывает, чтобы при использовании протоколов SSLv3 и TLS |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
249 серверные шифры были более приоритетны, чем клиентские. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
250 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
251 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
252 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
253 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
254 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
255 <directive name="ssl_protocols"> |
314
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
256 <syntax> |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
257 [<literal>SSLv2</literal>] |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
258 [<literal>SSLv3</literal>] |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
259 [<literal>TLSv1</literal>] |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
260 [<literal>TLSv1.1</literal>] |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
261 [<literal>TLSv1.2</literal>]</syntax> |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
262 <default>SSLv3 TLSv1 TLSv1.1 TLSv1.2</default> |
379 | 263 <context>http</context> |
264 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
265 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
266 <para> |
379 | 267 Разрешает указанные протоколы. |
314
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
268 Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal> работают |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
269 только при использовании библиотеки OpenSSL версии 1.0.1 и выше. |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
270 <note> |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
271 Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal> поддерживаются |
393
b83d332fbdaa
Documented SSL changes in the upcoming 1.0.12 release.
Ruslan Ermilov <ru@nginx.com>
parents:
383
diff
changeset
|
272 только начиная с версий 1.1.13 и 1.0.12, |
b83d332fbdaa
Documented SSL changes in the upcoming 1.0.12 release.
Ruslan Ermilov <ru@nginx.com>
parents:
383
diff
changeset
|
273 поэтому при использовании OpenSSL версии 1.0.1 |
314
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
274 и выше на старых версиях nginx эти протоколы работать будут, однако их нельзя |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
275 будет отключить. |
95d5dc7c9884
Documented the new "TLSv1.1" and "TLSv1.2" parameters of the
Ruslan Ermilov <ru@nginx.com>
parents:
285
diff
changeset
|
276 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
277 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
278 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
279 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
280 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
281 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
282 <directive name="ssl_session_cache"> |
271 | 283 <syntax> |
379 | 284 <literal>off</literal> | |
285 <literal>none</literal> | | |
286 [<literal>builtin</literal>[:<value>размер</value>]] | |
287 [<literal>shared</literal>:<value>название</value>:<value>размер</value>]</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
288 <default>none</default> |
379 | 289 <context>http</context> |
290 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
291 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
292 <para> |
379 | 293 Задаёт тип и размеры кэшей для хранения параметров сессий. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
294 Тип кэша может быть следующим: |
379 | 295 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
296 |
379 | 297 <tag-name><literal>off</literal></tag-name> |
298 <tag-desc> | |
299 жёсткое запрещение использования кэша сессий: | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
300 nginx явно говорит клиенту, что сессии не могут использоваться повторно. |
379 | 301 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
302 |
379 | 303 <tag-name><literal>none</literal></tag-name> |
304 <tag-desc> | |
305 мягкое запрещение использования кэша сессий: | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
306 nginx говорит клиенту, что сессии могут использоваться повторно, но |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
307 на самом деле не используются. |
379 | 308 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
309 |
379 | 310 <tag-name><literal>builtin</literal></tag-name> |
311 <tag-desc> | |
312 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса. | |
313 Размер кэша задаётся в сессиях. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
314 Если размер не задан, то он равен 20480 сессиям. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
315 Использование встроенного кэша может вести к фрагментации памяти. |
379 | 316 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
317 |
379 | 318 <tag-name><literal>shared</literal></tag-name> |
319 <tag-desc> | |
320 разделяемый между всеми рабочими процессами. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
321 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
322 около 4000 сессий. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
323 У каждого разделяемого кэша должно быть произвольное название. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
324 Кэш с одинаковым названием может использоваться в нескольких |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
325 виртуальных серверах. |
379 | 326 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
327 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
328 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
329 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
330 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
331 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
332 Можно использовать одновременно оба типа кэша, например: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
333 <example> |
379 | 334 ssl_session_cache builtin:1000 shared:SSL:10m; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
335 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
336 однако использование только разделяемого кэша без встроенного должно |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
337 быть более эффективным. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
339 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
340 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
341 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
342 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
343 <directive name="ssl_session_timeout"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
344 <syntax><value>время</value></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
345 <default>5m</default> |
379 | 346 <context>http</context> |
347 <context>server</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
348 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
349 <para> |
379 | 350 Задаёт время, в течение которого клиент может повторно |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
351 использовать параметры сессии, хранящейся в кэше. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
352 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
353 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
354 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
355 |
379 | 356 |
713
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
357 <directive name="ssl_stapling"> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
358 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
359 <default>off</default> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
360 <context>http</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
361 <context>server</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
362 <appeared-in>1.3.7</appeared-in> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
363 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
364 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
365 Разрешает или запрещает |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
366 <link url="http://tools.ietf.org/html/rfc4366#section-3.6">прикрепление |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
367 OCSP-ответов</link> сервером. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
368 Пример: |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
369 <example> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
370 ssl_stapling on; |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
371 resolver 192.0.2.1; |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
372 </example> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
373 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
374 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
375 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
376 Для работы OCSP stapling’а должен быть известен сертификат издателя |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
377 сертификата сервера. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
378 Если в заданном директивой <link id="ssl_certificate"/> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
379 файле не содержится промежуточных сертификатов, |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
380 то сертификат издателя сертификата сервера следует поместить в файл, |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
381 заданный директивой <link id="ssl_trusted_certificate"/>. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
382 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
383 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
384 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
385 Для преобразования имени хоста OCSP responder’а в адрес необходимо |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
386 дополнительно задать директиву |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
387 <link doc="ngx_http_core_module.xml" id="resolver"/>. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
388 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
389 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
390 </directive> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
391 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
392 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
393 <directive name="ssl_stapling_file"> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
394 <syntax><value>файл</value></syntax> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
395 <default/> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
396 <context>http</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
397 <context>server</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
398 <appeared-in>1.3.7</appeared-in> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
399 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
400 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
401 Если задано, то вместо опроса OCSP responder’а, |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
402 указанного в сертификате сервера, |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
403 ответ берётся из указанного <value>файла</value>. |
713
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
404 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
405 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
406 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
407 Ответ должен быть в формате DER и может быть сгенерирован командой |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
408 “<literal>openssl ocsp</literal>”. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
409 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
410 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
411 </directive> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
412 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
413 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
414 <directive name="ssl_stapling_responder"> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
415 <syntax><value>url</value></syntax> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
416 <default/> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
417 <context>http</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
418 <context>server</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
419 <appeared-in>1.3.7</appeared-in> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
420 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
421 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
422 Переопределяет URL OCSP responder’а, указанный в расширении сертификата |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
423 “<link url="http://tools.ietf.org/html/rfc5280#section-4.2.2.1">Authority |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
424 Information Access</link>”. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
425 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
426 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
427 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
428 Поддерживаются только “<literal>http://</literal>” OCSP responder’ы: |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
429 <example> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
430 ssl_stapling_responder http://ocsp.example.com/; |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
431 </example> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
432 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
433 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
434 </directive> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
435 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
436 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
437 <directive name="ssl_stapling_verify"> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
438 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
439 <default>off</default> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
440 <context>http</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
441 <context>server</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
442 <appeared-in>1.3.7</appeared-in> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
443 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
444 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
445 Разрешает или запрещает проверку сервером ответов OCSP. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
446 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
447 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
448 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
449 Для работоспособности проверки сертификат издателя сертификата сервера, |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
450 корневой сертификат и все промежуточные сертификаты должны быть указаны |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
451 как доверенные с помощью директивы |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
452 <link id="ssl_trusted_certificate"/>. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
453 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
454 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
455 </directive> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
456 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
457 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
458 <directive name="ssl_trusted_certificate"> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
459 <syntax><value>файл</value></syntax> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
460 <default/> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
461 <context>http</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
462 <context>server</context> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
463 <appeared-in>1.3.7</appeared-in> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
464 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
465 <para> |
715
3f25469cbc49
Highlighted 'file' parameters in the http_ssl_module directives.
Vladimir Homutov <vl@nginx.com>
parents:
713
diff
changeset
|
466 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM, |
713
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
467 которые используются для проверки клиентских сертификатов и ответов OCSP, |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
468 если включён <link id="ssl_stapling"/>. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
469 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
470 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
471 <para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
472 В отличие от <link id="ssl_client_certificate"/>, список этих сертификатов |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
473 не будет отправляться клиентам. |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
474 </para> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
475 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
476 </directive> |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
477 |
1de09d81acd1
Translated OCSP docs into Russian.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
478 |
379 | 479 <directive name="ssl_verify_client"> |
480 <syntax> | |
481 <literal>on</literal> | <literal>off</literal> | | |
717
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
482 <literal>optional</literal> | <literal>optional_no_ca</literal></syntax> |
379 | 483 <default>off</default> |
484 <context>http</context> | |
485 <context>server</context> | |
486 | |
487 <para> | |
488 Разрешает проверку клиентских сертификатов. | |
717
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
489 Результат проверки доступен через переменную |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
490 <var>$ssl_client_verify</var>. |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
491 </para> |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
492 |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
493 <para> |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
494 Параметр <literal>optional</literal> (0.8.7+) запрашивает клиентский |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
495 сертификат, и если сертификат был предоставлен, проверяет его. |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
496 </para> |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
497 |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
498 <para> |
763
cd581dbdaf76
The "optional_no_ca" parameter of the "ssl_verify_client" directive
Ruslan Ermilov <ru@nginx.com>
parents:
717
diff
changeset
|
499 Параметр <literal>optional_no_ca</literal> (1.3.8, 1.2.5) |
cd581dbdaf76
The "optional_no_ca" parameter of the "ssl_verify_client" directive
Ruslan Ermilov <ru@nginx.com>
parents:
717
diff
changeset
|
500 запрашивает сертификат |
717
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
501 клиента, но не требует, чтобы он был подписан доверенным сертификатом CA. |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
502 Это предназначено для случаев, когда фактическая проверка сертификата |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
503 осуществляется внешним по отношению к nginx’у сервисом. |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
504 Содержимое сертификата доступно через переменную |
c5facf2eff6f
Documented the recently added "optional_no_ca" parameter of the
Ruslan Ermilov <ru@nginx.com>
parents:
715
diff
changeset
|
505 <var>$ssl_client_cert</var>. |
379 | 506 </para> |
507 | |
508 </directive> | |
509 | |
510 | |
511 <directive name="ssl_verify_depth"> | |
512 <syntax><value>число</value></syntax> | |
513 <default>1</default> | |
514 <context>http</context> | |
515 <context>server</context> | |
516 | |
517 <para> | |
518 Устанавливает глубину проверки в цепочке клиентских сертификатов. | |
519 </para> | |
520 | |
521 </directive> | |
522 | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
523 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
524 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
525 |
379 | 526 <section id="errors" name="Обработка ошибок"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
527 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
528 <para> |
379 | 529 Модуль <literal>ngx_http_ssl_module</literal> поддерживает несколько |
530 нестандартных кодов ошибок, которые можно использовать для | |
531 перенаправления с помощью директивы | |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
532 <link doc="ngx_http_core_module.xml" id="error_page"/>: |
379 | 533 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
534 |
379 | 535 <tag-name>495</tag-name> |
536 <tag-desc> | |
537 при проверке клиентского сертификата произошла ошибка; | |
538 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
539 |
379 | 540 <tag-name>496</tag-name> |
541 <tag-desc> | |
542 клиент не предоставил требуемый сертификат; | |
543 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
544 |
379 | 545 <tag-name>497</tag-name> |
546 <tag-desc> | |
547 обычный запрос был послан на порт HTTPS. | |
548 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
549 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
550 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
551 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
552 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
553 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
554 Перенаправление делается после того, как запрос полностью разобран |
379 | 555 и доступны такие переменные, как <var>$request_uri</var>, |
556 <var>$uri</var>, <var>$args</var> и прочие. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
557 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
558 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
559 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
560 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
561 |
379 | 562 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
563 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
564 <para> |
379 | 565 Модуль <literal>ngx_http_ssl_module</literal> поддерживает |
566 несколько встроенных переменных: | |
567 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
568 |
379 | 569 <tag-name><var>$ssl_cipher</var></tag-name> |
570 <tag-desc> | |
571 возвращает строку используемых шифров для установленного SSL-соединения; | |
572 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
573 |
379 | 574 <tag-name><var>$ssl_client_cert</var></tag-name> |
575 <tag-desc> | |
576 возвращает клиентский сертификат | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
577 для установленного SSL-соединения в формате PEM |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
578 перед каждой строкой которого, кроме первой, вставляется символ табуляции; |
383
a73fa21add8a
Removed a misleading sentence.
Ruslan Ermilov <ru@nginx.com>
parents:
379
diff
changeset
|
579 предназначена для использования в директиве |
379 | 580 <link doc="ngx_http_proxy_module.xml" id="proxy_set_header"/>; |
581 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
582 |
379 | 583 <tag-name><var>$ssl_client_raw_cert</var></tag-name> |
584 <tag-desc> | |
585 возвращает клиентский сертификат | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
586 для установленного SSL-соединения в формате PEM; |
379 | 587 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
588 |
379 | 589 <tag-name><var>$ssl_client_serial</var></tag-name> |
590 <tag-desc> | |
591 возвращает серийный номер клиентского сертификата | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
592 для установленного SSL-соединения; |
379 | 593 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
594 |
379 | 595 <tag-name><var>$ssl_client_s_dn</var></tag-name> |
596 <tag-desc> | |
597 возвращает строку “subject DN” клиентского сертификата | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
598 для установленного SSL-соединения; |
379 | 599 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
600 |
379 | 601 <tag-name><var>$ssl_client_i_dn</var></tag-name> |
602 <tag-desc> | |
603 возвращает строку “issuer DN” клиентского сертификата | |
604 для установленного SSL-соединения; | |
605 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
606 |
379 | 607 <tag-name><var>$ssl_client_verify</var></tag-name> |
608 <tag-desc> | |
609 возвращает результат проверки клиентского сертификата: | |
610 “<literal>SUCCESS</literal>”, “<literal>FAILED</literal>” и, | |
611 если сертификат не был предоставлен — “<literal>NONE</literal>”; | |
612 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
613 |
379 | 614 <tag-name><var>$ssl_protocol</var></tag-name> |
615 <tag-desc> | |
616 возвращает протокол установленного SSL-соединения; | |
617 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
618 |
379 | 619 <tag-name><var>$ssl_session_id</var></tag-name> |
620 <tag-desc> | |
621 возвращает идентификатор сессии установленного SSL-соединения. | |
622 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
623 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
624 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
625 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
626 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
627 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
628 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
629 </module> |