nginx-site: xml/ru/docs/stream/ngx_stream_ssl

annotate xml/ru/docs/stream/ngx_stream_ssl_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.

author	Sergey Kandaurov <pluknet@nginx.com>
date	Thu, 30 Sep 2021 16:29:20 +0300
parents	ff357b676c2e
children	d16409187314

rev	line source
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1 <?xml version="1.0"?>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	2
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	3 <!--
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	4 Copyright (C) Nginx, Inc.
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	5 -->
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	6
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	9 <module name="Модуль ngx_stream_ssl_module"
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	10 link="/ru/docs/stream/ngx_stream_ssl_module.html"
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	11 lang="ru"
2769 16f6fa718be2 Updated TLSv1.3 support notes. Sergey Kandaurov <pluknet@nginx.com> parents: 2735 diff changeset	12 rev="25">
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	13
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14 <section id="summary">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	16 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	17 Модуль <literal>ngx_stream_ssl_module</literal> (1.9.0)
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	18 обеспечивает необходимую поддержку для работы
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	19 прокси-сервера по протоколу SSL/TLS.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	20 По умолчанию этот модуль не собирается, его сборку необходимо
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	21 разрешить с помощью конфигурационного параметра
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	22 <literal>--with-stream_ssl_module</literal>.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	23 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	24
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	25 </section>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	26
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	27
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	28 <section id="example" name="Пример конфигурации">
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	29
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	30 <para>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	31 Для уменьшения загрузки процессора рекомендуется
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	32 <list type="bullet">
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	33
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	34 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	35 установить число
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	36 <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: 1978 diff changeset	37 равным числу процессоров,
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	38 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	39
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	40 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	41 включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	42 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	43
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	44 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	45 выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	46 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	47
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	48 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	49 и, возможно, увеличить <link id="ssl_session_timeout">время жизни</link> сессии
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	50 (по умолчанию 5 минут):
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	51 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	52
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	53 </list>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	54
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	55 <example>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	56 <emphasis>worker_processes auto;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	57
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	58 stream {
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	59
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	60 ...
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	61
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	62 server {
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	63 listen 12345 ssl;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	64
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	65 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	66 ssl_ciphers AES128-SHA:AES256-SHA:RC4-SHA:DES-CBC3-SHA:RC4-MD5;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	67 ssl_certificate /usr/local/nginx/conf/cert.pem;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	68 ssl_certificate_key /usr/local/nginx/conf/cert.key;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	69 <emphasis>ssl_session_cache shared:SSL:10m;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	70 <emphasis>ssl_session_timeout 10m;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	71
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	72 ...
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	73 }
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	74 </example>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	75 </para>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	76
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	77 </section>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	78
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1520 diff changeset	79
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	80 <section id="directives" name="Директивы">
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	81
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	82 <directive name="ssl_certificate">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	83 <syntax><value>файл</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	84 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	85 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	86 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	87
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	88 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	89 Указывает <value>файл</value> с сертификатом в формате PEM
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	90 для данного сервера.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	91 Если вместе с основным сертификатом нужно указать промежуточные,
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	92 то они должны находиться в этом же файле в следующем порядке — сначала
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	93 основной сертификат, а затем промежуточные.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	94 В этом же файле может находиться секретный ключ в формате PEM.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	95 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	96
1726 a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	97 <para>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	98 Начиная с версии 1.11.0
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	99 эта директива может быть указана несколько раз
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	100 для загрузки сертификатов разных типов, например RSA и ECDSA:
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	101 <example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	102 server {
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	103 listen 12345 ssl;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	104
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	105 ssl_certificate example.com.rsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	106 ssl_certificate_key example.com.rsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	107
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	108 ssl_certificate example.com.ecdsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	109 ssl_certificate_key example.com.ecdsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	110
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	111 ...
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	112 }
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	113 </example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	114 <note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	115 Возможность задавать отдельные цепочки сертификатов для разных сертификатов
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	116 есть только в OpenSSL 1.0.2 и выше.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	117 Для более старых версий следует указывать только одну цепочку сертификатов.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	118 </note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	119 </para>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	120
2334 dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	121 <para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	122 Начиная с версии 1.15.9 в имени файла можно использовать переменные
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	123 при использовании OpenSSL 1.0.2 и выше:
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	124 <example>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	125 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	126 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	127 </example>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	128 Однако нужно учитывать, что при использовании переменных
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	129 сертификат загружается при каждой операции SSL handshake,
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	130 что может отрицательно влиять на производительность.
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	131 </para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	132
2350 8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	133 <para id="ssl_certificate_data">
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	134 Вместо <value>файла</value> можно указать значение
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	135 <literal>data</literal>:<value>$переменная</value> (1.15.10),
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	136 при котором сертификат загружается из переменной
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	137 без использования промежуточных файлов.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	138 При этом следует учитывать, что ненадлежащее использование
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	139 подобного синтаксиса может быть небезопасно,
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	140 например данные секретного ключа могут попасть в
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	141 <link doc="../ngx_core_module.xml" id="error_log">лог ошибок</link>.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	142 </para>
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	143
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	144 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	145
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	146
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	147 <directive name="ssl_certificate_key">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	148 <syntax><value>файл</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	149 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	150 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	152
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	153 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	154 Указывает <value>файл</value> с секретным ключом в формате PEM
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	155 для данного сервера.
1456 acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1450 diff changeset	156 </para>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1450 diff changeset	157
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1450 diff changeset	158 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	159 Вместо <value>файла</value> можно указать значение
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	160 <literal>engine</literal>:<value>имя</value>:<value>id</value>,
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	161 которое загружает ключ с указанным <value>id</value>
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	162 из OpenSSL engine с заданным <value>именем</value>.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	163 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	164
2350 8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	165 <para id="ssl_certificate_key_data">
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	166 Вместо <value>файла</value> можно указать значение
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	167 <literal>data</literal>:<value>$переменная</value> (1.15.10),
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	168 при котором секретный ключ загружается из переменной
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	169 без использования промежуточных файлов.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	170 При этом следует учитывать, что ненадлежащее использование
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	171 подобного синтаксиса может быть небезопасно,
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	172 например данные секретного ключа могут попасть в
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	173 <link doc="../ngx_core_module.xml" id="error_log">лог ошибок</link>.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	174 </para>
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2334 diff changeset	175
2334 dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	176 <para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	177 Начиная с версии 1.15.9 в имени файла можно использовать переменные
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	178 при использовании OpenSSL 1.0.2 и выше.
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	179 </para>
dbe55598d3f6 Added variables support in ssl_certificate and ssl_certificate_key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	180
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	181 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	182
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	183
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	184 <directive name="ssl_ciphers">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	185 <syntax><value>шифры</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	186 <default>HIGH:!aNULL:!MD5</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	187 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	188 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	189
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	190 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	191 Описывает разрешённые шифры.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	192 Шифры задаются в формате, поддерживаемом библиотекой
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	193 OpenSSL, например:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	194 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	195 ssl_ciphers ALL:!aNULL:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	196 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	197 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	198
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	199 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	200 Полный список можно посмотреть с помощью команды
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	201 “<command>openssl ciphers</command>”.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	202 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	203
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	204 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	205
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	206
1869 e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	207 <directive name="ssl_client_certificate">
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	208 <syntax><value>файл</value></syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	209 <default/>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	210 <context>stream</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	211 <context>server</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	212 <appeared-in>1.11.8</appeared-in>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	213
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	214 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	215 Указывает <value>файл</value> с доверенными сертификатами CA в формате
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	216 PEM, которые используются для
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	217 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	218 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	219
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	220 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	221 Список сертификатов будет отправляться клиентам.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	222 Если это нежелательно, можно воспользоваться директивой
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	223 <link id="ssl_trusted_certificate"/>.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	224 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	225
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	226 </directive>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	227
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	228
2616 d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	229 <directive name="ssl_conf_command">
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	230 <syntax><value>command</value></syntax>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	231 <default/>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	232 <context>stream</context>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	233 <context>server</context>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	234 <appeared-in>1.19.4</appeared-in>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	235
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	236 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	237 Задаёт произвольные конфигурационные
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	238 <link url="https://www.openssl.org/docs/man1.1.1/man3/SSL_CONF_cmd.html">команды</link>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	239 OpenSSL.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	240 <note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	241 Директива поддерживается при использовании OpenSSL 1.0.2 и выше.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	242 </note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	243 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	244
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	245 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	246 На одном уровне может быть указано
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	247 несколько директив <literal>ssl_conf_command</literal>:
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	248 <example>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	249 ssl_conf_command Options PrioritizeChaCha;
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	250 ssl_conf_command Ciphersuites TLS_CHACHA20_POLY1305_SHA256;
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	251 </example>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	252 Директивы наследуются с предыдущего уровня конфигурации при условии, что
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	253 на данном уровне не описаны свои директивы <literal>ssl_conf_command</literal>.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	254 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	255
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	256 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	257 <note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	258 Следует учитывать, что изменение настроек OpenSSL напрямую
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	259 может привести к неожиданному поведению.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	260 </note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	261 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	262
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	263 </directive>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	264
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2460 diff changeset	265
1869 e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	266 <directive name="ssl_crl">
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	267 <syntax><value>файл</value></syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	268 <default/>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	269 <context>stream</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	270 <context>server</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	271 <appeared-in>1.11.8</appeared-in>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	272
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	273 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	274 Указывает <value>файл</value> с отозванными сертификатами (CRL)
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	275 в формате PEM, используемыми для
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	276 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	277 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	278
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	279 </directive>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	280
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	281
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	282 <directive name="ssl_dhparam">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	283 <syntax><value>файл</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	284 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	285 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	286 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	287
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	288 <para>
1706 6f5497797cde Changed "EDH ciphers" to "DHE ciphers". Maxim Dounin <mdounin@mdounin.ru> parents: 1521 diff changeset	289 Указывает <value>файл</value> с параметрами для DHE-шифров.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	290 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	291
2296 e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	292 <para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	293 По умолчанию параметры не заданы,
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	294 и соответственно DHE-шифры не будут использоваться.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	295 <note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	296 До версии 1.11.0 по умолчанию использовались встроенные параметры.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	297 </note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	298 </para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2068 diff changeset	299
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	300 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	301
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	302
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	303 <directive name="ssl_ecdh_curve">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	304 <syntax><value>кривая</value></syntax>
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	305 <default>auto</default>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	306 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	307 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	308
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	309 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	310 Задаёт <value>кривую</value> для ECDHE-шифров.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	311 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	312
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	313 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	314 При использовании OpenSSL 1.0.2 и выше
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	315 можно указывать несколько кривых (1.11.0), например:
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	316 <example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	317 ssl_ecdh_curve prime256v1:secp384r1;
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	318 </example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	319 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	320
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	321 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	322 Специальное значение <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	323 встроенному в библиотеку OpenSSL списку кривых для OpenSSL 1.0.2 и выше,
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	324 или <literal>prime256v1</literal> для более старых версий.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	325 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	326
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	327 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	328 <note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	329 До версии 1.11.0
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	330 по умолчанию использовалась кривая <literal>prime256v1</literal>.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	331 </note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	332 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	333
2648 78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	334 <para>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	335 <note>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	336 При использовании OpenSSL 1.0.2 и выше
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	337 директива задаёт список кривых, поддерживаемых сервером.
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	338 Поэтому для работы ECDSA-сертификатов
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	339 важно, чтобы список включал кривые, используемые в сертификатах.
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	340 </note>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	341 </para>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	342
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	343 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	344
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	345
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	346 <directive name="ssl_handshake_timeout">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	347 <syntax><value>время</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	348 <default>60s</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	349 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	350 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	351
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	352 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	353 Задаёт таймаут для завершения операции SSL handshake.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	354 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	355
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	356 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	357
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	358
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	359 <directive name="ssl_password_file">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	360 <syntax><value>файл</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	361 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	362 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	363 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	364
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	365 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	366 Задаёт <value>файл</value> с паролями от
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	367 <link id="ssl_certificate_key">секретных ключей</link>,
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	368 где каждый пароль указан на отдельной строке.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	369 Пароли применяются по очереди в момент загрузки ключа.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	370 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	371
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	372 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	373 Пример:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	374 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	375 stream {
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	376 ssl_password_file /etc/keys/global.pass;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	377 ...
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	378
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	379 server {
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	380 listen 127.0.0.1:12345;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	381 ssl_certificate_key /etc/keys/first.key;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	382 }
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	383
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	384 server {
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	385 listen 127.0.0.1:12346;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	386
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	387 # вместо файла можно указать именованный канал
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	388 ssl_password_file /etc/keys/fifo;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	389 ssl_certificate_key /etc/keys/second.key;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	390 }
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	391 }
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	392 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	393 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	394
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	395 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	396
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	397
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	398 <directive name="ssl_prefer_server_ciphers">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	399 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	400 <default>off</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	401 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	402 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	403
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	404 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	405 Указывает, чтобы при использовании протоколов SSLv3 и TLS
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	406 серверные шифры были более приоритетны, чем клиентские.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	407 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	408
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	409 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	410
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	411
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	412 <directive name="ssl_protocols">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	413 <syntax>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	414 [<literal>SSLv2</literal>]
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	415 [<literal>SSLv3</literal>]
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	416 [<literal>TLSv1</literal>]
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	417 [<literal>TLSv1.1</literal>]
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	418 [<literal>TLSv1.2</literal>]
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	419 [<literal>TLSv1.3</literal>]</syntax>
1499 3687cc9a3592 Removed SSLv3 from the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1462 diff changeset	420 <default>TLSv1 TLSv1.1 TLSv1.2</default>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	421 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	422 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	423
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	424 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	425 Разрешает указанные протоколы.
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	426 <note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	427 Параметры <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	428 работают только при использовании OpenSSL 1.0.1 и выше.
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	429 </note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	430 <note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	431 Параметр <literal>TLSv1.3</literal> (1.13.0) работает только
2769 16f6fa718be2 Updated TLSv1.3 support notes. Sergey Kandaurov <pluknet@nginx.com> parents: 2735 diff changeset	432 при использовании OpenSSL 1.1.1 и выше.
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	433 </note>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	434 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	435
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	436 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	437
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	438
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	439 <directive name="ssl_session_cache">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	440 <syntax>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	441 <literal>off</literal> \|
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	442 <literal>none</literal> \|
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	443 [<literal>builtin</literal>[:<value>размер</value>]]
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	444 [<literal>shared</literal>:<value>название</value>:<value>размер</value>]</syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	445 <default>none</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	446 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	447 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	448
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	449 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	450 Задаёт тип и размеры кэшей для хранения параметров сессий.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	451 Тип кэша может быть следующим:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	452 <list type="tag">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	453
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	454 <tag-name><literal>off</literal></tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	455 <tag-desc>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	456 жёсткое запрещение использования кэша сессий:
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	457 nginx явно сообщает клиенту, что сессии не могут использоваться повторно.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	458 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	459
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	460 <tag-name><literal>none</literal></tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	461 <tag-desc>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	462 мягкое запрещение использования кэша сессий:
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	463 nginx сообщает клиенту, что сессии могут использоваться повторно, но
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	464 на самом деле не хранит параметры сессии в кэше.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	465 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	466
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	467 <tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	468 <tag-desc>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	469 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	470 Размер кэша задаётся в сессиях.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	471 Если размер не задан, то он равен 20480 сессиям.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	472 Использование встроенного кэша может вести к фрагментации памяти.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	473 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	474
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	475 <tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	476 <tag-desc>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	477 кэш, разделяемый между всеми рабочими процессами.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	478 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	479 около 4000 сессий.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	480 У каждого разделяемого кэша должно быть произвольное название.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	481 Кэш с одинаковым названием может использоваться в нескольких
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	482 серверах.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	483 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	484
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	485 </list>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	486 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	487
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	488 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	489 Можно использовать одновременно оба типа кэша, например:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	490 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	491 ssl_session_cache builtin:1000 shared:SSL:10m;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	492 </example>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	493 однако использование только разделяемого кэша без встроенного должно
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	494 быть более эффективным.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	495 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	496
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	497 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	498
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	499
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	500 <directive name="ssl_session_ticket_key">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	501 <syntax><value>файл</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	502 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	503 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	504 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	505
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	506 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	507 Задаёт <value>файл</value> с секретным ключом, применяемым при шифровании и
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	508 расшифровании TLS session tickets.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	509 Директива необходима, если один и тот же ключ нужно использовать
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	510 на нескольких серверах.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	511 По умолчанию используется случайно сгенерированный ключ.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	512 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	513
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	514 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	515 Если указано несколько ключей, то только первый ключ
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	516 используется для шифрования TLS session tickets.
ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	517 Это позволяет настроить ротацию ключей, например:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	518 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	519 ssl_session_ticket_key current.key;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	520 ssl_session_ticket_key previous.key;
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	521 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	522 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	523
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	524 <para>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1876 diff changeset	525 <value>Файл</value> должен содержать 80 или 48 байт случайных данных
aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1876 diff changeset	526 и может быть создан следующей командой:
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	527 <example>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1876 diff changeset	528 openssl rand 80 > ticket.key
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	529 </example>
2735 ff357b676c2e Removed trailing spaces. Maxim Dounin <mdounin@mdounin.ru> parents: 2648 diff changeset	530 В зависимости от размера файла для шифрования будет использоваться либо
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1876 diff changeset	531 AES256 (для 80-байтных ключей, 1.11.8), либо AES128 (для 48-байтных ключей).
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	532 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	533
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	534 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	535
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	536
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	537 <directive name="ssl_session_tickets">
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	538 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	539 <default>on</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	540 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	541 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	542
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	543 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	544 Разрешает или запрещает возобновление сессий при помощи
1923 66a30a380fba Fixed links to tools.ietf.org. Ruslan Ermilov <ru@nginx.com> parents: 1877 diff changeset	545 <link url="https://tools.ietf.org/html/rfc5077">TLS session tickets</link>.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	546 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	547
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	548 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	549
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	550
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	551 <directive name="ssl_session_timeout">
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	552 <syntax><value>время</value></syntax>
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	553 <default>5m</default>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	554 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	555 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	556
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	557 <para>
1520 ed36e909bc79 Translated stream_ssl_module into Russian. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	558 Задаёт время, в течение которого клиент может повторно
1785 3fa0944ddc6a Removed info about session cache from ssl_session_timeout. Yaroslav Zhuravlev <yar@nginx.com> parents: 1745 diff changeset	559 использовать параметры сессии.
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	560 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	561
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	562 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	563
1869 e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	564
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	565 <directive name="ssl_trusted_certificate">
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	566 <syntax><value>файл</value></syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	567 <default/>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	568 <context>stream</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	569 <context>server</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	570 <appeared-in>1.11.8</appeared-in>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	571
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	572 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	573 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	574 которые используются для <link id="ssl_verify_client">проверки</link>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	575 клиентских сертификатов.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	576 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	577
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	578 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	579 В отличие от <link id="ssl_client_certificate"/>, список этих сертификатов
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	580 не будет отправляться клиентам.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	581 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	582
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	583 </directive>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	584
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	585
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	586 <directive name="ssl_verify_client">
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	587 <syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	588 <literal>on</literal> \| <literal>off</literal> \|
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	589 <literal>optional</literal> \| <literal>optional_no_ca</literal></syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	590 <default>off</default>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	591 <context>stream</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	592 <context>server</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	593 <appeared-in>1.11.8</appeared-in>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	594
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	595
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	596 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	597 Разрешает проверку клиентских сертификатов.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	598 Результат проверки доступен через переменную
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	599 <link id="var_ssl_client_verify">$ssl_client_verify</link>.
1876 b451f03e0a4b Described behavior of stream ssl_verify_client in case of error. Yaroslav Zhuravlev <yar@nginx.com> parents: 1869 diff changeset	600 Если при проверке клиентского сертификата произошла ошибка
b451f03e0a4b Described behavior of stream ssl_verify_client in case of error. Yaroslav Zhuravlev <yar@nginx.com> parents: 1869 diff changeset	601 или клиент не предоставил требуемый сертификат,
b451f03e0a4b Described behavior of stream ssl_verify_client in case of error. Yaroslav Zhuravlev <yar@nginx.com> parents: 1869 diff changeset	602 соединение закрывается.
1869 e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	603 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	604
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	605 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	606 Параметр <literal>optional</literal> запрашивает клиентский
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	607 сертификат, и если сертификат был предоставлен, проверяет его.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	608 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	609
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	610 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	611 Параметр <literal>optional_no_ca</literal>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	612 запрашивает сертификат
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	613 клиента, но не требует, чтобы он был подписан доверенным сертификатом CA.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	614 Это предназначено для случаев, когда фактическая проверка сертификата
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	615 осуществляется внешним по отношению к nginx’у сервисом.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	616 Содержимое сертификата доступно через переменную
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	617 <link id="var_ssl_client_cert">$ssl_client_cert</link>.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	618 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	619
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	620 </directive>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	621
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	622
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	623 <directive name="ssl_verify_depth">
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	624 <syntax><value>число</value></syntax>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	625 <default>1</default>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	626 <context>stream</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	627 <context>server</context>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	628 <appeared-in>1.11.8</appeared-in>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	629
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	630 <para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	631 Устанавливает глубину проверки в цепочке клиентских сертификатов.
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	632 </para>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	633
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	634 </directive>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	635
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	636 </section>
f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	637
1745 0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	638
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	639 <section id="variables" name="Встроенные переменные">
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	640
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	641 <para>
1790 6da8d19f89c0 Corrected module name in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1785 diff changeset	642 Модуль <literal>ngx_stream_ssl_module</literal> поддерживает переменные
1745 0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	643 начиная с версии 1.11.2.
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	644 <list type="tag">
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	645
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	646 <tag-name id="var_ssl_cipher"><var>$ssl_cipher</var></tag-name>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	647 <tag-desc>
2460 c60a8a15010c Clarified description of the $ssl_cipher variable. Sergey Kandaurov <pluknet@nginx.com> parents: 2350 diff changeset	648 возвращает название используемого шифра для установленного SSL-соединения;
1745 0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	649 </tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	650
1857 0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	651 <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: 1790 diff changeset	652 <tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	653 возвращает список шифров, поддерживаемых клиентом (1.11.7).
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	654 Известные шифры указаны по имени, неизвестные указаны в шестнадцатеричном виде,
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	655 например:
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	656 <example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	657 AES128-SHA:AES256-SHA:0x00ff
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	658 </example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	659 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	660 Переменная полностью поддерживается при использовании OpenSSL версии 1.0.2
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	661 и выше.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	662 При использовании более старых версий переменная доступна
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	663 только для новых сессий и может содержать только известные шифры.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	664 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	665 </tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	666
1869 e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	667 <tag-name id="var_ssl_client_cert"><var>$ssl_client_cert</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	668 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	669 возвращает клиентский сертификат
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	670 для установленного SSL-соединения в формате PEM
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	671 перед каждой строкой которого, кроме первой, вставляется символ табуляции(1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	672 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	673
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	674 <tag-name id="var_ssl_client_fingerprint"><var>$ssl_client_fingerprint</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	675 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	676 возвращает SHA1-отпечаток клиентского сертификата
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	677 для установленного SSL-соединения (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	678 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	679
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	680 <tag-name id="var_ssl_client_i_dn"><var>$ssl_client_i_dn</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	681 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	682 возвращает строку “issuer DN” клиентского сертификата
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	683 для установленного SSL-соединения согласно
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	684 <link url="https://tools.ietf.org/html/rfc2253">RFC 2253</link> (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	685 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	686
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	687 <tag-name id="var_ssl_client_raw_cert"><var>$ssl_client_raw_cert</var>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	688 </tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	689 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	690 возвращает клиентский сертификат
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	691 для установленного SSL-соединения в формате PEM (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	692 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	693
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	694 <tag-name id="var_ssl_client_s_dn"><var>$ssl_client_s_dn</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	695 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	696 возвращает строку “subject DN” клиентского сертификата
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	697 для установленного SSL-соединения согласно
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	698 <link url="https://tools.ietf.org/html/rfc2253">RFC 2253</link> (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	699 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	700
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	701 <tag-name id="var_ssl_client_serial"><var>$ssl_client_serial</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	702 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	703 возвращает серийный номер клиентского сертификата
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	704 для установленного SSL-соединения (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	705 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	706
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	707 <tag-name id="var_ssl_client_v_end"><var>$ssl_client_v_end</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	708 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	709 возвращает дату окончания срока действия клиентского сертификата (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	710 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	711
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	712 <tag-name id="var_ssl_client_v_remain"><var>$ssl_client_v_remain</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	713 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	714 возвращает число дней,
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	715 оставшихся до истечения срока действия клиентского сертификата (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	716 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	717
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	718 <tag-name id="var_ssl_client_v_start"><var>$ssl_client_v_start</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	719 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	720 возвращает дату начала срока действия клиентского сертификата (1.11.8);
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	721 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	722
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	723 <tag-name id="var_ssl_client_verify"><var>$ssl_client_verify</var></tag-name>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	724 <tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	725 возвращает результат проверки клиентского сертификата (1.11.8):
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	726 “<literal>SUCCESS</literal>”, “<literal>FAILED:</literal><value>reason</value>”
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	727 и, если сертификат не был предоставлен, “<literal>NONE</literal>”;
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	728 </tag-desc>
e1d0b56c0310 Documented support for client certificate verification in stream. Yaroslav Zhuravlev <yar@nginx.com> parents: 1857 diff changeset	729
1857 0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	730 <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: 1790 diff changeset	731 <tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	732 возвращает список кривых, поддерживаемых клиентом (1.11.7).
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	733 Известные кривые указаны по имени, неизвестные указаны в шестнадцатеричном виде,
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	734 например:
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	735 <example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	736 0x001d:prime256v1:secp521r1:secp384r1
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	737 </example>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	738 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	739 Переменная поддерживается при использовании OpenSSL версии 1.0.2 и выше.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	740 При использовании более старых версий значением переменной будет пустая строка.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	741 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	742 <note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	743 Переменная доступна только для новых сессий.
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	744 </note>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	745 </tag-desc>
0882ccb0c00f Documented the $ssl_curves and $ssl_ciphers variables. Yaroslav Zhuravlev <yar@nginx.com> parents: 1790 diff changeset	746
1745 0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	747 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	748 <tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	749 возвращает протокол установленного SSL-соединения;
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	750 </tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	751
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	752 <tag-name id="var_ssl_server_name"><var>$ssl_server_name</var></tag-name>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	753 <tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	754 возвращает имя сервера, запрошенное через
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	755 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">SNI</link>;
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	756 </tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	757
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	758 <tag-name id="var_ssl_session_id"><var>$ssl_session_id</var></tag-name>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	759 <tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	760 возвращает идентификатор сессии установленного SSL-соединения;
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	761 </tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	762
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	763 <tag-name id="var_ssl_session_reused"><var>$ssl_session_reused</var></tag-name>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	764 <tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	765 возвращает “<literal>r</literal>”, если сессия была использована повторно,
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	766 иначе “<literal>.</literal>”.
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	767 </tag-desc>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	768
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	769 </list>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	770 </para>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	771
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	772 </section>
0dfb7628bfee Documented variables in ngx_stream_ssl_module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	773
1450 f5b5eefc43cb Updated commercial docs for the upcoming release. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	774 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/stream/ngx_stream_ssl_module.xml @ 2769:16f6fa718be2