nginx-site: xml/ru/docs/http/ngx_http_ssl

annotate xml/ru/docs/http/ngx_http_ssl_module.xml @ 2334:dbe55598d3f6

Added variables support in ssl_certificate and ssl_certificate_key.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Tue, 26 Feb 2019 18:33:47 +0300
parents	e2e71f9477a8
children	8e35f3af574b

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 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	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 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	12 lang="ru"
2334 dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	13 rev="45">
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 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	18 Модуль <literal>ngx_http_ssl_module</literal> обеспечивает работу
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	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 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	23 По умолчанию этот модуль не собирается, его сборку необходимо
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	24 разрешить с помощью конфигурационного параметра
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	25 <literal>--with-http_ssl_module</literal>.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	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 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	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 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	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>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	42 установить число
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	43 <link doc="../ngx_core_module.xml" id="worker_processes">рабочих процессов</link>
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	44 равным числу процессоров,
76 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
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	48 разрешить
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	49 <link doc="ngx_http_core_module.xml" id="keepalive_timeout">keep-alive</link>
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	50 соединения,
76 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>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	54 включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
76 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>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	58 выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	59 </listitem>
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	60
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	61 <listitem>
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	62 и, возможно, увеличить <link id="ssl_session_timeout">время жизни</link> сессии
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	63 (по умолчанию 5 минут):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	64 </listitem>
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 </list>
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 <example>
817 4fecf0715bbf Introducing "worker_processes auto" in SSL configuration examples. Andrei Belov <defan@nginx.com> parents: 801 diff changeset	69 <emphasis>worker_processes auto;</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71 http {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 ...
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	74
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	75 server {
801 b95a6d779c89 Documented that "listen ... ssl" is preferred over "ssl on". Ruslan Ermilov <ru@nginx.com> parents: 763 diff changeset	76 listen 443 ssl;
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	77 <emphasis>keepalive_timeout 70;</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	78
1411 8fe28c6edaa1 Removed SSLv3 from ssl_protocols parameters list as insecure example. Sergey Budnevitch <sb@waeme.net> parents: 1239 diff changeset	79 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	80 ssl_ciphers AES128-SHA:AES256-SHA:RC4-SHA:DES-CBC3-SHA:RC4-MD5;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	81 ssl_certificate /usr/local/nginx/conf/cert.pem;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	82 ssl_certificate_key /usr/local/nginx/conf/cert.key;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	83 <emphasis>ssl_session_cache shared:SSL:10m;</emphasis>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	84 <emphasis>ssl_session_timeout 10m;</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	85
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 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	91 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	92
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	93
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	94 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	95
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	96 <directive name="ssl">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	97 <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	98 <default>off</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	99 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	100 <context>server</context>
76 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 <para>
2168 3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2162 diff changeset	103 Эта директива устарела в версии 1.15.0.
3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2162 diff changeset	104 Вместо неё следует
3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2162 diff changeset	105 использовать параметр <literal>ssl</literal>
3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2162 diff changeset	106 директивы <link doc="ngx_http_core_module.xml" id="listen"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	107 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	108
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	109 </directive>
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
1039 f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	112 <directive name="ssl_buffer_size">
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	113 <syntax><value>size</value></syntax>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	114 <default>16k</default>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	115 <context>http</context>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	116 <context>server</context>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	117 <appeared-in>1.5.9</appeared-in>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	118
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	119 <para>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	120 Задаёт размер буфера, используемого при отправке данных.
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	121 </para>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	122
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	123 <para>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	124 По умолчанию размер буфера равен 16k, что соответствует минимальным
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	125 накладным расходам при передаче больших ответов.
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	126 С целью минимизации времени получения начала ответа (Time To First Byte)
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	127 может быть полезно использовать меньшие значения,
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	128 например:
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	129 <example>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	130 ssl_buffer_size 4k;
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	131 </example>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	132 </para>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	133
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	134 </directive>
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	135
f7ca80263893 Documented the "ssl_buffer_size" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1020 diff changeset	136
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	137 <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	138 <syntax><value>файл</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	139 <default/>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	140 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	141 <context>server</context>
76 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 <para>
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	144 Указывает <value>файл</value> с сертификатом в формате PEM
76 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 Если вместе с основным сертификатом нужно указать промежуточные,
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	147 то они должны находиться в этом же файле в следующем порядке: сначала
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	148 основной сертификат, а затем промежуточные.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	149 В этом же файле может находиться секретный ключ в формате PEM.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	150 </para>
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>
1726 a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	153 Начиная с версии 1.11.0
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	154 эта директива может быть указана несколько раз
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	155 для загрузки сертификатов разных типов, например RSA и ECDSA:
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	156 <example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	157 server {
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	158 listen 443 ssl;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	159 server_name example.com;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	160
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	161 ssl_certificate example.com.rsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	162 ssl_certificate_key example.com.rsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	163
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	164 ssl_certificate example.com.ecdsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	165 ssl_certificate_key example.com.ecdsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	166
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	167 ...
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	168 }
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	169 </example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	170 <note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	171 Возможность задавать отдельные
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	172 <link doc="configuring_https_servers.xml" id="chains">цепочки
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	173 сертификатов</link>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	174 для разных сертификатов есть только в OpenSSL 1.0.2 и выше.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	175 Для более старых версий следует указывать только одну цепочку сертификатов.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	176 </note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	177 </para>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	178
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1725 diff changeset	179 <para>
2334 dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	180 Начиная с версии 1.15.9 в имени файла можно использовать переменные
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	181 при использовании OpenSSL 1.0.2 и выше:
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	182 <example>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	183 ssl_certificate $ssl_server_name.crt;
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	184 ssl_certificate_key $ssl_server_name.key;
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	185 </example>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	186 Однако нужно учитывать, что при использовании переменных
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	187 сертификат загружается при каждой операции SSL handshake,
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	188 что может отрицательно влиять на производительность.
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	189 </para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	190
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	191 <para>
280 cbb789d3ce5e Fixed grammar error. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	192 Нужно иметь в виду, что из-за ограничения протокола HTTPS
2040 093855e77388 Updated info about SNI. Yaroslav Zhuravlev <yar@nginx.com> parents: 2027 diff changeset	193 для максимальной совместимости виртуальные серверы должны слушать на
093855e77388 Updated info about SNI. Yaroslav Zhuravlev <yar@nginx.com> parents: 2027 diff changeset	194 <link doc="configuring_https_servers.xml" id="name_based_https_servers">разных
093855e77388 Updated info about SNI. Yaroslav Zhuravlev <yar@nginx.com> parents: 2027 diff changeset	195 IP-адресах</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	196 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	197
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	198 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	199
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	200
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	201 <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	202 <syntax><value>файл</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	203 <default/>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	204 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	205 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	206
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	207 <para>
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	208 Указывает <value>файл</value> с секретным ключом в формате PEM
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	209 для данного виртуального сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	211
1456 acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	212 <para>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	213 Вместо <value>файла</value> можно указать значение
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	214 <literal>engine</literal>:<value>имя</value>:<value>id</value> (1.7.9),
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	215 которое загружает ключ с указанным <value>id</value>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	216 из OpenSSL engine с заданным <value>именем</value>.
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	217 </para>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1428 diff changeset	218
2334 dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	219 <para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	220 Начиная с версии 1.15.9 в имени файла можно использовать переменные
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	221 при использовании OpenSSL 1.0.2 и выше.
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	222 </para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	223
76 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_ciphers">
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>
538 58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	229 <default>HIGH:!aNULL:!MD5</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	230 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	231 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	232
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	234 Описывает разрешённые шифры.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	235 Шифры задаются в формате, поддерживаемом библиотекой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	236 OpenSSL, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	237 <example>
538 58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	238 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	239 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	240 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	241
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	242 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	243 Полный список можно посмотреть с помощью команды
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	244 “<command>openssl ciphers</command>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	246
538 58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	247 <para>
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	248 <note>
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	249 В предыдущих версиях nginx по умолчанию использовались
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	250 <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	251 шифры.
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	252 </note>
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	253 </para>
58dd64aef626 Documented ciphers used by default in modern nginx versions (closes #177). Ruslan Ermilov <ru@nginx.com> parents: 393 diff changeset	254
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	257
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	258 <directive name="ssl_client_certificate">
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	259 <syntax><value>файл</value></syntax>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	260 <default/>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	261 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	262 <context>server</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	263
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	264 <para>
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	265 Указывает <value>файл</value> с доверенными сертификатами CA в формате
1428 933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	266 PEM, которые используются для
933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	267 <link id="ssl_verify_client">проверки</link> клиентских сертификатов и
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	268 ответов OCSP, если включён <link id="ssl_stapling"/>.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	269 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	270
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	271 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	272 Список сертификатов будет отправляться клиентам.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	273 Если это нежелательно, можно воспользоваться директивой
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	274 <link id="ssl_trusted_certificate"/>.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	275 </para>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	276
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	277 </directive>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	278
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	279
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	280 <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	281 <syntax><value>файл</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	282 <default/>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	283 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	284 <context>server</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	285 <appeared-in>0.8.7</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	286
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	287 <para>
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	288 Указывает <value>файл</value> с отозванными сертификатами (CRL)
1428 933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	289 в формате PEM, используемыми для
933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	290 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	291 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	292
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	293 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	294
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	295
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	296 <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	297 <syntax><value>файл</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	298 <default/>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	299 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	300 <context>server</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	301 <appeared-in>0.7.2</appeared-in>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	302
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	303 <para>
1706 6f5497797cde Changed "EDH ciphers" to "DHE ciphers". Maxim Dounin <mdounin@mdounin.ru> parents: 1522 diff changeset	304 Указывает <value>файл</value> с параметрами для DHE-шифров.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	306
2296 e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	307 <para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	308 По умолчанию параметры не заданы,
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	309 и соответственно DHE-шифры не будут использоваться.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	310 <note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	311 До версии 1.11.0 по умолчанию использовались встроенные параметры.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	312 </note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	313 </para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2241 diff changeset	314
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	315 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	317
2219 f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	318 <directive name="ssl_early_data">
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	319 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	320 <default>off</default>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	321 <context>http</context>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	322 <context>server</context>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	323 <appeared-in>1.15.3</appeared-in>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	324
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	325 <para>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	326 Разрешает или запрещает TLS 1.3
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	327 <link url="https://tools.ietf.org/html/rfc8446#section-2.3">early data</link>.
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	328 <note>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	329 Запросы, отправленные внутри early data, могут быть подвержены
2238 0761b770a94e RFC8470. Sergey Kandaurov <pluknet@nginx.com> parents: 2234 diff changeset	330 <link url="https://tools.ietf.org/html/rfc8470">атакам повторного воспроизведения</link> (replay).
2234 20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	331 Для защиты от подобных атак на уровне приложения
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	332 необходимо использовать
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	333 переменную <link id="var_ssl_early_data">$ssl_early_data</link>.
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	334 </note>
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	335
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	336 <example>
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	337 proxy_set_header Early-Data $ssl_early_data;
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	338 </example>
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	339
20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	340 <note>
2241 b7ac730b96f3 Documented TLS 1.3 early data support with OpenSSL. Sergey Kandaurov <pluknet@nginx.com> parents: 2238 diff changeset	341 Директива поддерживается при использовании OpenSSL 1.1.1 и выше (1.15.4) или
2234 20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	342 <link url="https://boringssl.googlesource.com/boringssl/">BoringSSL</link>.
2219 f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	343 </note>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	344 </para>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	345
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	346 </directive>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	347
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	348
1054 c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	349 <directive name="ssl_ecdh_curve">
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	350 <syntax><value>кривая</value></syntax>
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	351 <default>auto</default>
1054 c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	352 <context>http</context>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	353 <context>server</context>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	354 <appeared-in>1.1.0</appeared-in>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	355 <appeared-in>1.0.6</appeared-in>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	356
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	357 <para>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	358 Задаёт кривую для ECDHE-шифров.
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	359 </para>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	360
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	361 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	362 При использовании OpenSSL 1.0.2 и выше
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	363 можно указывать несколько кривых (1.11.0), например:
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	364 <example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	365 ssl_ecdh_curve prime256v1:secp384r1;
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	366 </example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	367 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	368
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	369 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	370 Специальное значение <literal>auto</literal> (1.11.0) соответствует
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	371 встроенному в библиотеку OpenSSL списку кривых для OpenSSL 1.0.2 и выше,
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	372 или <literal>prime256v1</literal> для более старых версий.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	373 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	374
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	375 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	376 <note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	377 До версии 1.11.0
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	378 по умолчанию использовалась кривая <literal>prime256v1</literal>.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	379 </note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	380 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	381
1054 c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	382 </directive>
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	383
c5793e5c30d4 Documented the "ssl_ecdh_curve" directive. Maxim Dounin <mdounin@mdounin.ru> parents: 1039 diff changeset	384
1239 35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	385 <directive name="ssl_password_file">
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	386 <syntax><value>файл</value></syntax>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	387 <default/>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	388 <context>http</context>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	389 <context>server</context>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	390 <appeared-in>1.7.3</appeared-in>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	391
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	392 <para>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	393 Задаёт <value>файл</value> с паролями от
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	394 <link id="ssl_certificate_key">секретных ключей</link>,
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	395 где каждый пароль указан на отдельной строке.
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	396 Пароли применяются по очереди в момент загрузки ключа.
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	397 </para>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	398
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	399 <para>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	400 Пример:
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	401 <example>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	402 http {
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	403 ssl_password_file /etc/keys/global.pass;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	404 ...
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	405
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	406 server {
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	407 server_name www1.example.com;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	408 ssl_certificate_key /etc/keys/first.key;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	409 }
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	410
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	411 server {
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	412 server_name www2.example.com;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	413
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	414 # вместо файла можно указать именованный канал
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	415 ssl_password_file /etc/keys/fifo;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	416 ssl_certificate_key /etc/keys/second.key;
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	417 }
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	418 }
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	419 </example>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	420 </para>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	421
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	422 </directive>
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	423
35cf5dca5fa4 SSL: added the ssl_password_file directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1201 diff changeset	424
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425 <directive name="ssl_prefer_server_ciphers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	426 <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	427 <default>off</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	428 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	429 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	430
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	432 Указывает, чтобы при использовании протоколов SSLv3 и TLS
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	433 серверные шифры были более приоритетны, чем клиентские.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	434 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	436 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	439 <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	440 <syntax>
95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	441 [<literal>SSLv2</literal>]
95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	442 [<literal>SSLv3</literal>]
95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	443 [<literal>TLSv1</literal>]
95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	444 [<literal>TLSv1.1</literal>]
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	445 [<literal>TLSv1.2</literal>]
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	446 [<literal>TLSv1.3</literal>]</syntax>
1499 3687cc9a3592 Removed SSLv3 from the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1456 diff changeset	447 <default>TLSv1 TLSv1.1 TLSv1.2</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	448 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	449 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	450
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	451 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	452 Разрешает указанные протоколы.
314 95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	453 <note>
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	454 Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	455 (1.1.13, 1.0.12) работают только при использовании OpenSSL 1.0.1 и выше.
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	456 </note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	457 <note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	458 Параметр <literal>TLSv1.3</literal> (1.13.0) работает только
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	459 при использовании OpenSSL 1.1.1, собранной с поддержкой TLSv1.3.
314 95d5dc7c9884 Documented the new "TLSv1.1" and "TLSv1.2" parameters of the Ruslan Ermilov <ru@nginx.com> parents: 285 diff changeset	460 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	461 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	462
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	463 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	464
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	465
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	466 <directive name="ssl_session_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	467 <syntax>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	468 <literal>off</literal> \|
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	469 <literal>none</literal> \|
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	470 [<literal>builtin</literal>[:<value>размер</value>]]
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	471 [<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	472 <default>none</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	473 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	474 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	475
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	476 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	477 Задаёт тип и размеры кэшей для хранения параметров сессий.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	478 Тип кэша может быть следующим:
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	479 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	480
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	481 <tag-name><literal>off</literal></tag-name>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	482 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	483 жёсткое запрещение использования кэша сессий:
1522 ee91c95fca48 Corrected Russian translation of the ssl_session_cache directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	484 nginx явно сообщает клиенту, что сессии не могут использоваться повторно.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	485 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	486
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	487 <tag-name><literal>none</literal></tag-name>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	488 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	489 мягкое запрещение использования кэша сессий:
1522 ee91c95fca48 Corrected Russian translation of the ssl_session_cache directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	490 nginx сообщает клиенту, что сессии могут использоваться повторно, но
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 817 diff changeset	491 на самом деле не хранит параметры сессии в кэше.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	492 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	493
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	494 <tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	495 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	496 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	497 Размер кэша задаётся в сессиях.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	498 Если размер не задан, то он равен 20480 сессиям.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	499 Использование встроенного кэша может вести к фрагментации памяти.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	500 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	501
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 2040 diff changeset	502 <tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	503 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 817 diff changeset	504 кэш, разделяемый между всеми рабочими процессами.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	505 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	506 около 4000 сессий.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	507 У каждого разделяемого кэша должно быть произвольное название.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	508 Кэш с одинаковым названием может использоваться в нескольких
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	509 виртуальных серверах.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	510 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	511
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	512 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	513 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	514
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	515 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	516 Можно использовать одновременно оба типа кэша, например:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	517 <example>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	518 ssl_session_cache builtin:1000 shared:SSL:10m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	519 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	520 однако использование только разделяемого кэша без встроенного должно
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	521 быть более эффективным.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	522 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	523
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	524 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	525
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	526
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	527 <directive name="ssl_session_ticket_key">
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	528 <syntax><value>файл</value></syntax>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	529 <default/>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	530 <context>http</context>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	531 <context>server</context>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	532 <appeared-in>1.5.7</appeared-in>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	533
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	534 <para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	535 Задаёт <value>файл</value> с секретным ключом, применяемым при шифровании и
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	536 расшифровании TLS session tickets.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	537 Директива необходима, если один и тот же ключ нужно использовать
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	538 на нескольких серверах.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	539 По умолчанию используется случайно сгенерированный ключ.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	540 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	541
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	542 <para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	543 Если указано несколько ключей, то только первый ключ
1020 00403cb3005a Fixed a typo. Vladimir Homutov <vl@nginx.com> parents: 1019 diff changeset	544 используется для шифрования TLS session tickets.
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	545 Это позволяет настроить ротацию ключей, например:
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	546 <example>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	547 ssl_session_ticket_key current.key;
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	548 ssl_session_ticket_key previous.key;
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	549 </example>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	550 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	551
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	552 <para>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1871 diff changeset	553 <value>Файл</value> должен содержать 80 или 48 байт случайных данных
aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1871 diff changeset	554 и может быть создан следующей командой:
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	555 <example>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1871 diff changeset	556 openssl rand 80 > ticket.key
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	557 </example>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1871 diff changeset	558 В зависимости от размера файла для шифрования будет использоваться либо
aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1871 diff changeset	559 AES256 (для 80-байтных ключей, 1.11.8), либо AES128 (для 48-байтных ключей).
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	560 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	561
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	562 </directive>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	563
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	564
1055 e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	565 <directive name="ssl_session_tickets">
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	566 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	567 <default>on</default>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	568 <context>http</context>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	569 <context>server</context>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	570 <appeared-in>1.5.9</appeared-in>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	571
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	572 <para>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	573 Разрешает или запрещает возобновление сессий при помощи
1923 66a30a380fba Fixed links to tools.ietf.org. Ruslan Ermilov <ru@nginx.com> parents: 1877 diff changeset	574 <link url="https://tools.ietf.org/html/rfc5077">TLS session tickets</link>.
1055 e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	575 </para>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	576
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	577 </directive>
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	578
e26a9f598e40 Documented the "ssl_session_tickets" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1054 diff changeset	579
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 <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	581 <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	582 <default>5m</default>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	583 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	584 <context>server</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	585
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	586 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	587 Задаёт время, в течение которого клиент может повторно
1785 3fa0944ddc6a Removed info about session cache from ssl_session_timeout. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	588 использовать параметры сессии.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	589 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	590
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	591 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	592
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	593
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	594 <directive name="ssl_stapling">
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	595 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	596 <default>off</default>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	597 <context>http</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	598 <context>server</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	599 <appeared-in>1.3.7</appeared-in>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	600
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	601 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	602 Разрешает или запрещает
2162 aa5d65fe4916 Updated link to TLS Certificate Status Request extension reference. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	603 <link url="https://tools.ietf.org/html/rfc6066#section-8">прикрепление
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	604 OCSP-ответов</link> сервером.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	605 Пример:
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	606 <example>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	607 ssl_stapling on;
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	608 resolver 192.0.2.1;
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	609 </example>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	610 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	611
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	612 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	613 Для работы OCSP stapling’а должен быть известен сертификат издателя
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	614 сертификата сервера.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	615 Если в заданном директивой <link id="ssl_certificate"/>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	616 файле не содержится промежуточных сертификатов,
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	617 то сертификат издателя сертификата сервера следует поместить в файл,
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	618 заданный директивой <link id="ssl_trusted_certificate"/>.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	619 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	620
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	621 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	622 Для преобразования имени хоста OCSP responder’а в адрес необходимо
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	623 дополнительно задать директиву
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	624 <link doc="ngx_http_core_module.xml" id="resolver"/>.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	625 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	626
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	627 </directive>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	628
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	629
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	630 <directive name="ssl_stapling_file">
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	631 <syntax><value>файл</value></syntax>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	632 <default/>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	633 <context>http</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	634 <context>server</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	635 <appeared-in>1.3.7</appeared-in>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	636
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	637 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	638 Если задано, то вместо опроса OCSP responder’а,
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	639 указанного в сертификате сервера,
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	640 ответ берётся из указанного <value>файла</value>.
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	641 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	642
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	643 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	644 Ответ должен быть в формате DER и может быть сгенерирован командой
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	645 “<literal>openssl ocsp</literal>”.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	646 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	647
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	648 </directive>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	649
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	650
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	651 <directive name="ssl_stapling_responder">
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	652 <syntax><value>url</value></syntax>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	653 <default/>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	654 <context>http</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	655 <context>server</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	656 <appeared-in>1.3.7</appeared-in>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	657
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	658 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	659 Переопределяет URL OCSP responder’а, указанный в расширении сертификата
1923 66a30a380fba Fixed links to tools.ietf.org. Ruslan Ermilov <ru@nginx.com> parents: 1877 diff changeset	660 “<link url="https://tools.ietf.org/html/rfc5280#section-4.2.2.1">Authority
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	661 Information Access</link>”.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	662 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	663
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	664 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	665 Поддерживаются только “<literal>http://</literal>” OCSP responder’ы:
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	666 <example>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	667 ssl_stapling_responder http://ocsp.example.com/;
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	668 </example>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	669 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	670
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	671 </directive>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	672
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	673
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	674 <directive name="ssl_stapling_verify">
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	675 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	676 <default>off</default>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	677 <context>http</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	678 <context>server</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	679 <appeared-in>1.3.7</appeared-in>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	680
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	681 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	682 Разрешает или запрещает проверку сервером ответов OCSP.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	683 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	684
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	685 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	686 Для работоспособности проверки сертификат издателя сертификата сервера,
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	687 корневой сертификат и все промежуточные сертификаты должны быть указаны
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	688 как доверенные с помощью директивы
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	689 <link id="ssl_trusted_certificate"/>.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	690 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	691
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	692 </directive>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	693
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	694
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	695 <directive name="ssl_trusted_certificate">
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	696 <syntax><value>файл</value></syntax>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	697 <default/>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	698 <context>http</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	699 <context>server</context>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	700 <appeared-in>1.3.7</appeared-in>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	701
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	702 <para>
715 3f25469cbc49 Highlighted 'file' parameters in the http_ssl_module directives. Vladimir Homutov <vl@nginx.com> parents: 713 diff changeset	703 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
1428 933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	704 которые используются для <link id="ssl_verify_client">проверки</link>
933831d7bf0b Link to "ssl_verify_client" from client certificate directives. Sergey Kandaurov <pluknet@nginx.com> parents: 1411 diff changeset	705 клиентских сертификатов и ответов OCSP,
713 1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	706 если включён <link id="ssl_stapling"/>.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	707 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	708
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	709 <para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	710 В отличие от <link id="ssl_client_certificate"/>, список этих сертификатов
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	711 не будет отправляться клиентам.
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	712 </para>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	713
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	714 </directive>
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	715
1de09d81acd1 Translated OCSP docs into Russian. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	716
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	717 <directive name="ssl_verify_client">
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	718 <syntax>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	719 <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	720 <literal>optional</literal> \| <literal>optional_no_ca</literal></syntax>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	721 <default>off</default>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	722 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	723 <context>server</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	724
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	725 <para>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	726 Разрешает проверку клиентских сертификатов.
717 c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	727 Результат проверки доступен через переменную
1871 5f156621b8b5 Added links to $ssl_client_verify and $ssl_client_cert. Yaroslav Zhuravlev <yar@nginx.com> parents: 1870 diff changeset	728 <link id="var_ssl_client_verify">$ssl_client_verify</link>.
717 c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	729 </para>
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	730
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	731 <para>
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	732 Параметр <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	733 сертификат, и если сертификат был предоставлен, проверяет его.
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	734 </para>
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	735
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	736 <para>
763 cd581dbdaf76 The "optional_no_ca" parameter of the "ssl_verify_client" directive Ruslan Ermilov <ru@nginx.com> parents: 717 diff changeset	737 Параметр <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	738 запрашивает сертификат
717 c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	739 клиента, но не требует, чтобы он был подписан доверенным сертификатом CA.
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	740 Это предназначено для случаев, когда фактическая проверка сертификата
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	741 осуществляется внешним по отношению к nginx’у сервисом.
c5facf2eff6f Documented the recently added "optional_no_ca" parameter of the Ruslan Ermilov <ru@nginx.com> parents: 715 diff changeset	742 Содержимое сертификата доступно через переменную
1871 5f156621b8b5 Added links to $ssl_client_verify and $ssl_client_cert. Yaroslav Zhuravlev <yar@nginx.com> parents: 1870 diff changeset	743 <link id="var_ssl_client_cert">$ssl_client_cert</link>.
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	744 </para>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	745
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	746 </directive>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	747
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	748
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	749 <directive name="ssl_verify_depth">
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	750 <syntax><value>число</value></syntax>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	751 <default>1</default>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	752 <context>http</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	753 <context>server</context>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	754
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	755 <para>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	756 Устанавливает глубину проверки в цепочке клиентских сертификатов.
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	757 </para>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	758
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	759 </directive>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	760
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	761 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	762
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	764 <section id="errors" name="Обработка ошибок">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	765
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	766 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	767 Модуль <literal>ngx_http_ssl_module</literal> поддерживает несколько
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	768 нестандартных кодов ошибок, которые можно использовать для
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	769 перенаправления с помощью директивы
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	770 <link doc="ngx_http_core_module.xml" id="error_page"/>:
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	771 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	772
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	773 <tag-name>495</tag-name>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	774 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	775 при проверке клиентского сертификата произошла ошибка;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	776 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	777
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	778 <tag-name>496</tag-name>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	779 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	780 клиент не предоставил требуемый сертификат;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	781 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	782
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	783 <tag-name>497</tag-name>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	784 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	785 обычный запрос был послан на порт HTTPS.
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	786 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	787
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	788 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	789 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	790
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792 Перенаправление делается после того, как запрос полностью разобран
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	793 и доступны такие переменные, как <var>$request_uri</var>,
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 817 diff changeset	794 <var>$uri</var>, <var>$args</var> и другие переменные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	796
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	797 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	798
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	799
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	800 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	801
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	802 <para>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	803 Модуль <literal>ngx_http_ssl_module</literal> поддерживает
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	804 несколько встроенных переменных:
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	805 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	806
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	807 <tag-name id="var_ssl_cipher"><var>$ssl_cipher</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	808 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	809 возвращает строку используемых шифров для установленного SSL-соединения;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	810 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	811
1857 0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	812 <tag-name id="var_ssl_ciphers"><var>$ssl_ciphers</var></tag-name>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	813 <tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	814 возвращает список шифров, поддерживаемых клиентом (1.11.7).
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	815 Известные шифры указаны по имени, неизвестные указаны в шестнадцатеричном виде,
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	816 например:
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	817 <example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	818 AES128-SHA:AES256-SHA:0x00ff
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	819 </example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	820 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	821 Переменная полностью поддерживается при использовании OpenSSL версии 1.0.2
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	822 и выше.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	823 При использовании более старых версий переменная доступна
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	824 только для новых сессий и может содержать только известные шифры.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	825 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	826 </tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	827
2027 dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	828 <tag-name id="var_ssl_client_escaped_cert"><var>$ssl_client_escaped_cert</var></tag-name>
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	829 <tag-desc>
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	830 возвращает клиентский сертификат в формате PEM
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	831 (закодирован в формате urlencode) для установленного SSL-соединения (1.13.5);
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	832 </tag-desc>
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	833
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	834 <tag-name id="var_ssl_client_cert"><var>$ssl_client_cert</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	835 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	836 возвращает клиентский сертификат
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837 для установленного SSL-соединения в формате PEM
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838 перед каждой строкой которого, кроме первой, вставляется символ табуляции;
383 a73fa21add8a Removed a misleading sentence. Ruslan Ermilov <ru@nginx.com> parents: 379 diff changeset	839 предназначена для использования в директиве
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	840 <link doc="ngx_http_proxy_module.xml" id="proxy_set_header"/>;
2027 dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	841 <note>
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	842 Переменная устарела, вместо неё следует использовать
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	843 переменную <var>$ssl_client_escaped_cert</var>.
dabca59da4ce Documented the $ssl_client_escaped_cert variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	844 </note>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	845 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	846
1201 db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	847 <tag-name id="var_ssl_client_fingerprint"><var>$ssl_client_fingerprint</var></tag-name>
db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	848 <tag-desc>
db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	849 возвращает SHA1-отпечаток клиентского сертификата
db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	850 для установленного SSL-соединения (1.7.1);
db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	851 </tag-desc>
db4b017b5796 SSL: documented the ssl_client_fingerprint variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1167 diff changeset	852
1870 fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	853 <tag-name id="var_ssl_client_i_dn"><var>$ssl_client_i_dn</var></tag-name>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	854 <tag-desc>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	855 возвращает строку “issuer DN” клиентского сертификата
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	856 для установленного SSL-соединения согласно
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	857 <link url="https://tools.ietf.org/html/rfc2253">RFC 2253</link> (1.11.6);
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	858 </tag-desc>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	859
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	860 <tag-name id="var_ssl_client_i_dn_legacy"><var>$ssl_client_i_dn_legacy</var></tag-name>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	861 <tag-desc>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	862 возвращает строку “issuer DN” клиентского сертификата
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	863 для установленного SSL-соединения;
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	864 <note>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	865 До версии 1.11.6 переменная называлась <var>$ssl_client_s_dn</var>.
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	866 </note>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	867 </tag-desc>
fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	868
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	869 <tag-name id="var_ssl_client_raw_cert"><var>$ssl_client_raw_cert</var>
07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	870 </tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	871 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	872 возвращает клиентский сертификат
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	873 для установленного SSL-соединения в формате PEM;
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	874 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	875
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	876 <tag-name id="var_ssl_client_s_dn"><var>$ssl_client_s_dn</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	877 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	878 возвращает строку “subject DN” клиентского сертификата
1824 e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	879 для установленного SSL-соединения согласно
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	880 <link url="https://tools.ietf.org/html/rfc2253">RFC 2253</link> (1.11.6);
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	881 </tag-desc>
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	882
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	883 <tag-name id="var_ssl_client_s_dn_legacy"><var>$ssl_client_s_dn_legacy</var></tag-name>
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	884 <tag-desc>
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	885 возвращает строку “subject DN” клиентского сертификата
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	886 для установленного SSL-соединения;
1824 e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	887 <note>
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	888 До версии 1.11.6 переменная называлась <var>$ssl_client_s_dn</var>.
e8811a423130 Added RFC2253-compliant $ssl_client_s_dn, $ssl_client_i_dn and legacy vars. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	889 </note>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	890 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	891
1870 fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	892 <tag-name id="var_ssl_client_serial"><var>$ssl_client_serial</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	893 <tag-desc>
1870 fa7542e40381 Relocated $ssl_client_i_dn, $ssl_client_i_dn_legacy, $ssl_client_serial. Yaroslav Zhuravlev <yar@nginx.com> parents: 1863 diff changeset	894 возвращает серийный номер клиентского сертификата
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	895 для установленного SSL-соединения;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	896 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	897
1855 2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	898 <tag-name id="var_ssl_client_v_end"><var>$ssl_client_v_end</var></tag-name>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	899 <tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	900 возвращает дату окончания срока действия клиентского сертификата (1.11.7);
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	901 </tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	902
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	903 <tag-name id="var_ssl_client_v_remain"><var>$ssl_client_v_remain</var></tag-name>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	904 <tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	905 возвращает число дней,
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	906 оставшихся до истечения срока действия клиентского сертификата (1.11.7);
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	907 </tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	908
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	909 <tag-name id="var_ssl_client_v_start"><var>$ssl_client_v_start</var></tag-name>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	910 <tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	911 возвращает дату начала срока действия клиентского сертификата (1.11.7);
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	912 </tag-desc>
2ef67c4d2226 Documented $ssl_client_v_end, $ssl_client_v_start, $ssl_client_v_remain variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1824 diff changeset	913
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	914 <tag-name id="var_ssl_client_verify"><var>$ssl_client_verify</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	915 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	916 возвращает результат проверки клиентского сертификата:
1856 7133004fa5b3 $ssl_client_verify extended with a failure reason. Yaroslav Zhuravlev <yar@nginx.com> parents: 1855 diff changeset	917 “<literal>SUCCESS</literal>”, “<literal>FAILED:</literal><value>reason</value>”
1863 fef4ab2d990c Removed unnecessary version for "FAILED:reason" in $ssl_client_verify. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	918 и, если сертификат не был предоставлен, “<literal>NONE</literal>”;
1856 7133004fa5b3 $ssl_client_verify extended with a failure reason. Yaroslav Zhuravlev <yar@nginx.com> parents: 1855 diff changeset	919 <note>
7133004fa5b3 $ssl_client_verify extended with a failure reason. Yaroslav Zhuravlev <yar@nginx.com> parents: 1855 diff changeset	920 До версии 1.11.7 результат “<literal>FAILED</literal>”
7133004fa5b3 $ssl_client_verify extended with a failure reason. Yaroslav Zhuravlev <yar@nginx.com> parents: 1855 diff changeset	921 не содержал строку <value>reason</value>.
7133004fa5b3 $ssl_client_verify extended with a failure reason. Yaroslav Zhuravlev <yar@nginx.com> parents: 1855 diff changeset	922 </note>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	923 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	924
1857 0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	925 <tag-name id="var_ssl_curves"><var>$ssl_curves</var></tag-name>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	926 <tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	927 возвращает список кривых, поддерживаемых клиентом (1.11.7).
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	928 Известные кривые указаны по имени, неизвестные указаны в шестнадцатеричном виде,
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	929 например:
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	930 <example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	931 0x001d:prime256v1:secp521r1:secp384r1
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	932 </example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	933 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	934 Переменная поддерживается при использовании OpenSSL версии 1.0.2 и выше.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	935 При использовании более старых версий значением переменной будет пустая строка.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	936 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	937 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	938 Переменная доступна только для новых сессий.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	939 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	940 </tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1856 diff changeset	941
2219 f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	942 <tag-name id="var_ssl_early_data"><var>$ssl_early_data</var></tag-name>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	943 <tag-desc>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	944 возвращает “<literal>1</literal>”, если
2234 20a189bdb15f Updated SSL early data documentation. Yaroslav Zhuravlev <yar@nginx.com> parents: 2219 diff changeset	945 используется TLS 1.3 <link id="ssl_early_data">early data</link>
2219 f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	946 и операция handshake не завершена, иначе “” (1.15.3).
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	947 </tag-desc>
f1e12641fc8a Documented TLS 1.3 early data. Yaroslav Zhuravlev <yar@nginx.com> parents: 2168 diff changeset	948
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	949 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	950 <tag-desc>
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	951 возвращает протокол установленного SSL-соединения;
f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	952 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	953
1167 cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	954 <tag-name id="var_ssl_server_name"><var>$ssl_server_name</var></tag-name>
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	955 <tag-desc>
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	956 возвращает имя сервера, запрошенное через
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	957 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">SNI</link>
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	958 (1.7.0);
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	959 </tag-desc>
cac06b81957c Documented the $ssl_server_name variable. Ruslan Ermilov <ru@nginx.com> parents: 1155 diff changeset	960
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	961 <tag-name id="var_ssl_session_id"><var>$ssl_session_id</var></tag-name>
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	962 <tag-desc>
1072 502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	963 возвращает идентификатор сессии установленного SSL-соединения;
502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	964 </tag-desc>
502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	965
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1072 diff changeset	966 <tag-name id="var_ssl_session_reused"><var>$ssl_session_reused</var></tag-name>
1072 502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	967 <tag-desc>
502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	968 возвращает “<literal>r</literal>”, если сессия была использована повторно,
502f4be2d62e Documented the "ssl_session_reused" variable. Yaroslav Zhuravlev <yar@nginx.com> parents: 1055 diff changeset	969 иначе “<literal>.</literal>” (1.5.11).
379 f13435414ed8 Revision. Ruslan Ermilov <ru@nginx.com> parents: 314 diff changeset	970 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	971
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	972 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	973 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	974
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	975 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	976
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	977 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_ssl_module.xml @ 2334:dbe55598d3f6