nginx-site: xml/ru/docs/mail/ngx_mail_ssl

annotate xml/ru/docs/mail/ngx_mail_ssl_module.xml @ 2978:2b02fee0d12e

Documented removal of the ssl directive.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Tue, 13 Jun 2023 19:24:58 +0100
parents	37e082fd009c
children

rev	line source
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1 <?xml version="1.0"?>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	2
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	3 <!--
638 179336bb5c03 Fixed copyright lines. Ruslan Ermilov <ru@nginx.com> parents: 630 diff changeset	4 Copyright (C) 2006, 2007 Anton Yuzhaninov
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	5 Copyright (C) Nginx, Inc.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	6 -->
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	7
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	10 <module name="Модуль ngx_mail_ssl_module"
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	11 link="/ru/docs/mail/ngx_mail_ssl_module.html"
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	12 lang="ru"
2978 2b02fee0d12e Documented removal of the ssl directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2948 diff changeset	13 rev="28">
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14
640 febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	15 <section id="summary">
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	16
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	17 <para>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	18 Модуль <literal>ngx_mail_ssl_module</literal> обеспечивает работу
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	19 почтового прокси-сервера по протоколу SSL/TLS.
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	20 </para>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	21
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	22 <para>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	23 По умолчанию этот модуль не собирается, его сборку необходимо
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	24 разрешить с помощью конфигурационного параметра
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	25 <literal>--with-mail_ssl_module</literal>.
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	26 <note>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	27 Для сборки и работы этого модуля нужна библиотека
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	28 <link url="http://www.openssl.org">OpenSSL</link>.
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	29 </note>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	30 </para>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	31
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	32 </section>
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	33
febc8a4ad739 Added the "summary" section to ngx_mail_ssl_module. Ruslan Ermilov <ru@nginx.com> parents: 638 diff changeset	34
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	35 <section id="example" name="Пример конфигурации">
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	36
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	37 <para>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	38 Для уменьшения загрузки процессора рекомендуется
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	39 <list type="bullet">
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	40
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	41 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	42 установить число
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	43 <link doc="../ngx_core_module.xml" id="worker_processes">рабочих процессов</link>
3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	44 равным числу процессоров,
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	45 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	46
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	47 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	48 включить <link id="ssl_session_cache_shared">разделяемый</link> кэш сессий,
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	49 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	50
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	51 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	52 выключить <link id="ssl_session_cache_builtin">встроенный</link> кэш сессий
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	53 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	54
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	55 <listitem>
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	56 и, возможно, увеличить <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	57 (по умолчанию 5 минут):
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	58 </listitem>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	59
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	60 </list>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	61
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	62 <example>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	63 <emphasis>worker_processes auto;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	64
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	65 mail {
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	66
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	67 ...
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	68
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	69 server {
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	70 listen 993 ssl;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	71
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	72 ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
1521 e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	73 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: 1499 diff changeset	74 ssl_certificate /usr/local/nginx/conf/cert.pem;
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	75 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: 1499 diff changeset	76 <emphasis>ssl_session_cache shared:SSL:10m;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	77 <emphasis>ssl_session_timeout 10m;</emphasis>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	78
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	79 ...
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	80 }
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	81 </example>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	82 </para>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	83
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	84 </section>
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	85
e3d3e2ed4275 Added example configuration to mail and stream ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1499 diff changeset	86
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	87 <section id="directives" name="Директивы">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	88
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	89 <directive name="ssl">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	90 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	91 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	92 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	93 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	94
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	95 <para>
2978 2b02fee0d12e Documented removal of the ssl directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2948 diff changeset	96 Эта директива устарела в версии 1.15.0
2b02fee0d12e Documented removal of the ssl directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2948 diff changeset	97 и была удалена в версии 1.25.1.
2168 3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2068 diff changeset	98 Вместо неё следует
3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2068 diff changeset	99 использовать параметр <literal>ssl</literal>
3535437f97d2 Deprecated the "ssl" directive for http and mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2068 diff changeset	100 директивы <link doc="ngx_mail_core_module.xml" id="listen"/>.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	101 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	102
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	103 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	104
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	105
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	106 <directive name="ssl_certificate">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	107 <syntax><value>файл</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	108 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	109 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	110 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	111
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	112 <para>
1456 acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	113 Указывает <value>файл</value> с сертификатом в формате PEM
751 9c1ffd02f1b7 Removed "virtual" and HTTPS references from mail modules. Vladimir Homutov <vl@nginx.com> parents: 640 diff changeset	114 для данного сервера.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	115 Если вместе с основным сертификатом нужно указать промежуточные,
1457 78ccd1af1400 Minimized diffs between http, mail, and stream. Ruslan Ermilov <ru@nginx.com> parents: 1456 diff changeset	116 то они должны находиться в этом же файле в следующем порядке: сначала
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	117 основной сертификат, а затем промежуточные.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	118 В этом же файле может находиться секретный ключ в формате PEM.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	119 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	120
1726 a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	121 <para>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	122 Начиная с версии 1.11.0
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	123 эта директива может быть указана несколько раз
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	124 для загрузки сертификатов разных типов, например RSA и ECDSA:
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	125 <example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	126 server {
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	127 listen 993 ssl;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	128
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	129 ssl_certificate example.com.rsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	130 ssl_certificate_key example.com.rsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	131
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	132 ssl_certificate example.com.ecdsa.crt;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	133 ssl_certificate_key example.com.ecdsa.key;
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	134
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	135 ...
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	136 }
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	137 </example>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	138 <note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	139 Возможность задавать отдельные цепочки сертификатов для разных сертификатов
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	140 есть только в OpenSSL 1.0.2 и выше.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	141 Для более старых версий следует указывать только одну цепочку сертификатов.
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	142 </note>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	143 </para>
a0bc284941f6 Documented multiple certificates support. Maxim Dounin <mdounin@mdounin.ru> parents: 1711 diff changeset	144
2350 8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	145 <para id="ssl_certificate_data">
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	146 Вместо <value>файла</value> можно указать значение
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	147 <literal>data</literal>:<value>сертификат</value> (1.15.10),
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	148 при котором сертификат загружается
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	149 без использования промежуточных файлов.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	150 При этом следует учитывать, что ненадлежащее использование
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	151 подобного синтаксиса может быть небезопасно,
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	152 например данные секретного ключа могут попасть в
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	153 <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: 2296 diff changeset	154 </para>
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	155
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	156 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	157
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	158
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	159 <directive name="ssl_certificate_key">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	160 <syntax><value>файл</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	161 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	162 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	163 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	164
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	165 <para>
1456 acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	166 Указывает <value>файл</value> с секретным ключом в формате PEM
751 9c1ffd02f1b7 Removed "virtual" and HTTPS references from mail modules. Vladimir Homutov <vl@nginx.com> parents: 640 diff changeset	167 для данного сервера.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	168 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	169
1456 acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	170 <para>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	171 Вместо <value>файла</value> можно указать значение
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	172 <literal>engine</literal>:<value>имя</value>:<value>id</value> (1.7.9),
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	173 которое загружает ключ с указанным <value>id</value>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	174 из OpenSSL engine с заданным <value>именем</value>.
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	175 </para>
acba294382d6 Documented engine support in ssl_certificate_key and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1429 diff changeset	176
2350 8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	177 <para id="ssl_certificate_key_data">
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	178 Вместо <value>файла</value> можно указать значение
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	179 <literal>data</literal>:<value>ключ</value> (1.15.10),
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	180 при котором секретный ключ загружается
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	181 без использования промежуточных файлов.
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	182 При этом следует учитывать, что ненадлежащее использование
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	183 подобного синтаксиса может быть небезопасно,
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	184 например данные секретного ключа могут попасть в
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	185 <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: 2296 diff changeset	186 </para>
8e35f3af574b Documented the "data:" syntax for ssl_certificate and key. Yaroslav Zhuravlev <yar@nginx.com> parents: 2296 diff changeset	187
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	188 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	189
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	190
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	191 <directive name="ssl_ciphers">
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	192 <syntax><value>шифры</value></syntax>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	193 <default>HIGH:!aNULL:!MD5</default>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	194 <context>mail</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	195 <context>server</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	196
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	197 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	198 Описывает разрешённые шифры.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	199 Шифры задаются в формате, поддерживаемом библиотекой
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	200 OpenSSL, например:
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	201 <example>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	202 ssl_ciphers ALL:!aNULL:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	203 </example>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	204 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	205
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	206 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	207 Полный список можно посмотреть с помощью команды
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	208 “<command>openssl ciphers</command>”.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	209 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	210
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	211 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	212 <note>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	213 В предыдущих версиях nginx по умолчанию использовались
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	214 <link doc="../http/configuring_https_servers.xml" id="compatibility">другие</link>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	215 шифры.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	216 </note>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	217 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	218
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	219 </directive>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	220
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	221
1429 06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	222 <directive name="ssl_client_certificate">
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	223 <syntax><value>файл</value></syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	224 <default/>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	225 <context>mail</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	226 <context>server</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	227 <appeared-in>1.7.11</appeared-in>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	228
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	229 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	230 Указывает <value>файл</value> с доверенными сертификатами CA в формате
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	231 PEM, которые используются для
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	232 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	233 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	234
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	235 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	236 Список сертификатов будет отправляться клиентам.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	237 Если это нежелательно, можно воспользоваться директивой
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	238 <link id="ssl_trusted_certificate"/>.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	239 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	240
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	241 </directive>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	242
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	243
2616 d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	244 <directive name="ssl_conf_command">
2865 0d355d154181 Corrected syntax of ssl_conf_command and friends. Sergey Kandaurov <pluknet@nginx.com> parents: 2837 diff changeset	245 <syntax><value>имя</value> <value>значение</value></syntax>
2616 d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	246 <default/>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	247 <context>mail</context>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	248 <context>server</context>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	249 <appeared-in>1.19.4</appeared-in>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	250
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	251 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	252 Задаёт произвольные конфигурационные
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	253 <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: 2350 diff changeset	254 OpenSSL.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	255 <note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	256 Директива поддерживается при использовании OpenSSL 1.0.2 и выше.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	257 </note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	258 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	259
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	260 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	261 На одном уровне может быть указано
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	262 несколько директив <literal>ssl_conf_command</literal>:
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	263 <example>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	264 ssl_conf_command Options PrioritizeChaCha;
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	265 ssl_conf_command Ciphersuites TLS_CHACHA20_POLY1305_SHA256;
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	266 </example>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	267 Директивы наследуются с предыдущего уровня конфигурации при условии, что
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	268 на данном уровне не описаны свои директивы <literal>ssl_conf_command</literal>.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	269 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	270
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	271 <para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	272 <note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	273 Следует учитывать, что изменение настроек OpenSSL напрямую
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	274 может привести к неожиданному поведению.
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	275 </note>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	276 </para>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	277
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	278 </directive>
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	279
d8bf37d20449 Documented the ssl_conf_command directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 2350 diff changeset	280
1429 06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	281 <directive name="ssl_crl">
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	282 <syntax><value>файл</value></syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	283 <default/>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	284 <context>mail</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	285 <context>server</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	286 <appeared-in>1.7.11</appeared-in>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	287
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	288 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	289 Указывает <value>файл</value> с отозванными сертификатами (CRL)
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	290 в формате PEM, используемыми для
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	291 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	292 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	293
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	294 </directive>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	295
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	296
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	297 <directive name="ssl_dhparam">
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	298 <syntax><value>файл</value></syntax>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	299 <default/>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	300 <context>mail</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	301 <context>server</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	302 <appeared-in>0.7.2</appeared-in>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	303
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	304 <para>
1706 6f5497797cde Changed "EDH ciphers" to "DHE ciphers". Maxim Dounin <mdounin@mdounin.ru> parents: 1522 diff changeset	305 Указывает <value>файл</value> с параметрами для DHE-шифров.
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	306 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	307
2296 e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	308 <para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	309 По умолчанию параметры не заданы,
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	310 и соответственно DHE-шифры не будут использоваться.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	311 <note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	312 До версии 1.11.0 по умолчанию использовались встроенные параметры.
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	313 </note>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	314 </para>
e2e71f9477a8 Added note about ssl_dhparam defaults. Sergey Kandaurov <pluknet@nginx.com> parents: 2168 diff changeset	315
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	316 </directive>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	317
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	318
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	319 <directive name="ssl_ecdh_curve">
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	320 <syntax><value>кривая</value></syntax>
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	321 <default>auto</default>
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	322 <context>mail</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	323 <context>server</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	324 <appeared-in>1.1.0</appeared-in>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	325 <appeared-in>1.0.6</appeared-in>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	326
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	327 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	328 Задаёт кривую для ECDHE-шифров.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	329 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	330
1711 38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	331 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	332 При использовании OpenSSL 1.0.2 и выше
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	333 можно указывать несколько кривых (1.11.0), например:
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	334 <example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	335 ssl_ecdh_curve prime256v1:secp384r1;
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	336 </example>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	337 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	338
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	339 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	340 Специальное значение <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	341 встроенному в библиотеку OpenSSL списку кривых для OpenSSL 1.0.2 и выше,
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	342 или <literal>prime256v1</literal> для более старых версий.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	343 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	344
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	345 <para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	346 <note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	347 До версии 1.11.0
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	348 по умолчанию использовалась кривая <literal>prime256v1</literal>.
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	349 </note>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	350 </para>
38fb3e6b71e8 Documented ssl_ecdh_curve changes in 1.11.0. Maxim Dounin <mdounin@mdounin.ru> parents: 1706 diff changeset	351
2648 78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	352 <para>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	353 <note>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	354 При использовании OpenSSL 1.0.2 и выше
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	355 директива задаёт список кривых, поддерживаемых сервером.
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	356 Поэтому для работы ECDSA-сертификатов
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	357 важно, чтобы список включал кривые, используемые в сертификатах.
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	358 </note>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	359 </para>
78161967514f Mentioned ECDSA in ssl_ecdh_curve. Yaroslav Zhuravlev <yar@nginx.com> parents: 2616 diff changeset	360
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	361 </directive>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	362
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	363
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	364 <directive name="ssl_password_file">
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	365 <syntax><value>файл</value></syntax>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	366 <default/>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	367 <context>mail</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	368 <context>server</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	369 <appeared-in>1.7.3</appeared-in>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	370
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	371 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	372 Задаёт <value>файл</value> с паролями от
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	373 <link id="ssl_certificate_key">секретных ключей</link>,
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	374 где каждый пароль указан на отдельной строке.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	375 Пароли применяются по очереди в момент загрузки ключа.
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	376 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	377
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	378 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	379 Пример:
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	380 <example>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	381 mail {
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	382 ssl_password_file /etc/keys/global.pass;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	383 ...
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	384
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	385 server {
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	386 server_name mail1.example.com;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	387 ssl_certificate_key /etc/keys/first.key;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	388 }
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	389
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	390 server {
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	391 server_name mail2.example.com;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	392
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	393 # вместо файла можно указать именованный канал
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	394 ssl_password_file /etc/keys/fifo;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	395 ssl_certificate_key /etc/keys/second.key;
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	396 }
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	397 }
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	398 </example>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	399 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	400
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	401 </directive>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	402
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	403
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	404 <directive name="ssl_prefer_server_ciphers">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	405 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	406 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	407 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	408 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	409
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	410 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	411 Указывает, чтобы при использовании протоколов SSLv3 и TLS
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	412 серверные шифры были более приоритетны, чем клиентские.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	413 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	414
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	415 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	416
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	417
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	418 <directive name="ssl_protocols">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	419 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	420 [<literal>SSLv2</literal>]
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	421 [<literal>SSLv3</literal>]
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	422 [<literal>TLSv1</literal>]
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	423 [<literal>TLSv1.1</literal>]
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	424 [<literal>TLSv1.2</literal>]
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	425 [<literal>TLSv1.3</literal>]</syntax>
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	426 <default>TLSv1 TLSv1.1 TLSv1.2 TLSv1.3</default>
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	427 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	428 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	429
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	430 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	431 Разрешает указанные протоколы.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	432 <note>
1978 8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	433 Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	434 (1.1.13, 1.0.12) работают только при использовании OpenSSL 1.0.1 и выше.
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	435 </note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	436 <note>
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive. Sergey Kandaurov <pluknet@nginx.com> parents: 1924 diff changeset	437 Параметр <literal>TLSv1.3</literal> (1.13.0) работает только
2769 16f6fa718be2 Updated TLSv1.3 support notes. Sergey Kandaurov <pluknet@nginx.com> parents: 2735 diff changeset	438 при использовании OpenSSL 1.1.1 и выше.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	439 </note>
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	440 <note>
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	441 Параметр <literal>TLSv1.3</literal> используется по умолчанию
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	442 начиная с 1.23.4.
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2920 diff changeset	443 </note>
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	444 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	445
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	446 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	447
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	448
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	449 <directive name="ssl_session_cache">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	450 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	451 <literal>off</literal> \|
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	452 <literal>none</literal> \|
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	453 [<literal>builtin</literal>[:<value>размер</value>]]
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	454 [<literal>shared</literal>:<value>название</value>:<value>размер</value>]</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	455 <default>none</default>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	456 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	457 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	458
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	459 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	460 Задаёт тип и размеры кэшей для хранения параметров сессий.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	461 Тип кэша может быть следующим:
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	462 <list type="tag" compact="no">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	463
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	464 <tag-name><literal>off</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	465 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	466 жёсткое запрещение использования кэша сессий:
1522 ee91c95fca48 Corrected Russian translation of the ssl_session_cache directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1521 diff changeset	467 nginx явно сообщает клиенту, что сессии не могут использоваться повторно.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	468 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	469
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	470 <tag-name><literal>none</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	471 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	472 мягкое запрещение использования кэша сессий:
1522 ee91c95fca48 Corrected Russian translation of the ssl_session_cache directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1521 diff changeset	473 nginx сообщает клиенту, что сессии могут использоваться повторно, но
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 751 diff changeset	474 на самом деле не хранит параметры сессии в кэше.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	475 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	476
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	477 <tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	478 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	479 встроенный в OpenSSL кэш, используется в рамках только одного рабочего процесса.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	480 Размер кэша задаётся в сессиях.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	481 Если размер не задан, то он равен 20480 сессиям.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	482 Использование встроенного кэша может вести к фрагментации памяти.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	483 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	484
2068 3d9e7993c201 Added links to directives in the example of ssl modules. Yaroslav Zhuravlev <yar@nginx.com> parents: 1978 diff changeset	485 <tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	486 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 751 diff changeset	487 кэш, разделяемый между всеми рабочими процессами.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	488 Размер кэша задаётся в байтах, в 1 мегабайт может поместиться
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	489 около 4000 сессий.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	490 У каждого разделяемого кэша должно быть произвольное название.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	491 Кэш с одинаковым названием может использоваться в нескольких
751 9c1ffd02f1b7 Removed "virtual" and HTTPS references from mail modules. Vladimir Homutov <vl@nginx.com> parents: 640 diff changeset	492 серверах.
2920 8033ffaedeb9 Documented automatic rotation of TLS ticket keys for stream/mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	493 Также он используется для автоматического создания, хранения и
8033ffaedeb9 Documented automatic rotation of TLS ticket keys for stream/mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	494 периодического обновления ключей TLS session tickets (1.23.2),
8033ffaedeb9 Documented automatic rotation of TLS ticket keys for stream/mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	495 если они не указаны явно
8033ffaedeb9 Documented automatic rotation of TLS ticket keys for stream/mail. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	496 с помощью директивы <link id="ssl_session_ticket_key"/>.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	497 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	498
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	499 </list>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	500 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	501
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	502 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	503 Можно использовать одновременно оба типа кэша, например:
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	504 <example>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	505 ssl_session_cache builtin:1000 shared:SSL:10m;
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	506 </example>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	507 однако использование только разделяемого кэша без встроенного должно
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	508 быть более эффективным.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	509 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	510
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	511 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	512
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	513
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	514 <directive name="ssl_session_ticket_key">
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	515 <syntax><value>файл</value></syntax>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	516 <default/>
1020 00403cb3005a Fixed a typo. Vladimir Homutov <vl@nginx.com> parents: 1019 diff changeset	517 <context>mail</context>
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	518 <context>server</context>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	519 <appeared-in>1.5.7</appeared-in>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	520
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	521 <para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	522 Задаёт <value>файл</value> с секретным ключом, применяемым при шифровании и
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	523 расшифровании TLS session tickets.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	524 Директива необходима, если один и тот же ключ нужно использовать
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	525 на нескольких серверах.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	526 По умолчанию используется случайно сгенерированный ключ.
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	527 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	528
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	529 <para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	530 Если указано несколько ключей, то только первый ключ
1020 00403cb3005a Fixed a typo. Vladimir Homutov <vl@nginx.com> parents: 1019 diff changeset	531 используется для шифрования TLS session tickets.
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	532 Это позволяет настроить ротацию ключей, например:
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	533 <example>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	534 ssl_session_ticket_key current.key;
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	535 ssl_session_ticket_key previous.key;
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	536 </example>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	537 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	538
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	539 <para>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1785 diff changeset	540 <value>Файл</value> должен содержать 80 или 48 байт случайных данных
aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1785 diff changeset	541 и может быть создан следующей командой:
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	542 <example>
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1785 diff changeset	543 openssl rand 80 > ticket.key
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	544 </example>
2735 ff357b676c2e Removed trailing spaces. Maxim Dounin <mdounin@mdounin.ru> parents: 2648 diff changeset	545 В зависимости от размера файла для шифрования будет использоваться либо
1877 aa29a64a5e9d Documented ssl_session_ticket_key 80-byte keys. Maxim Dounin <mdounin@mdounin.ru> parents: 1785 diff changeset	546 AES256 (для 80-байтных ключей, 1.11.8), либо AES128 (для 48-байтных ключей).
1019 2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	547 </para>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	548
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	549 </directive>
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	550
2b6a858c60dc Documented the "ssl_session_ticket_key" directive in http and mail. Vladimir Homutov <vl@nginx.com> parents: 966 diff changeset	551
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	552 <directive name="ssl_session_tickets">
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	553 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	554 <default>on</default>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	555 <context>mail</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	556 <context>server</context>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	557 <appeared-in>1.5.9</appeared-in>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	558
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	559 <para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	560 Разрешает или запрещает возобновление сессий при помощи
2831 4add6ae1296f Updated links to datatracker.ietf.org. Sergey Kandaurov <pluknet@nginx.com> parents: 2769 diff changeset	561 <link url="https://datatracker.ietf.org/doc/html/rfc5077">TLS session tickets</link>.
1266 35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	562 </para>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	563
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	564 </directive>
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	565
35d6ac64bf27 Documented five directives in the mail ssl module. Yaroslav Zhuravlev <yar@nginx.com> parents: 1020 diff changeset	566
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	567 <directive name="ssl_session_timeout">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	568 <syntax><value>время</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	569 <default>5m</default>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	570 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	571 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	572
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	573 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	574 Задаёт время, в течение которого клиент может повторно
1785 3fa0944ddc6a Removed info about session cache from ssl_session_timeout. Yaroslav Zhuravlev <yar@nginx.com> parents: 1726 diff changeset	575 использовать параметры сессии.
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	576 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	577
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	578 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	579
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	580
1429 06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	581 <directive name="ssl_trusted_certificate">
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	582 <syntax><value>файл</value></syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	583 <default/>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	584 <context>mail</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	585 <context>server</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	586 <appeared-in>1.7.11</appeared-in>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	587
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	588 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	589 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	590 которые используются для
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	591 <link id="ssl_verify_client">проверки</link> клиентских сертификатов.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	592 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	593
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	594 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	595 В отличие от <link id="ssl_client_certificate"/>, список этих сертификатов
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	596 не будет отправляться клиентам.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	597 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	598
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	599 </directive>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	600
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	601
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	602 <directive name="ssl_verify_client">
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	603 <syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	604 <literal>on</literal> \| <literal>off</literal> \|
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	605 <literal>optional</literal> \| <literal>optional_no_ca</literal></syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	606 <default>off</default>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	607 <context>mail</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	608 <context>server</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	609 <appeared-in>1.7.11</appeared-in>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	610
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	611 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	612 Разрешает проверку клиентских сертификатов.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	613 Результат проверки передаётся в заголовке
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	614 <header>Auth-SSL-Verify</header> в запросе
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	615 <link doc="ngx_mail_auth_http_module.xml" id="auth_http">аутентификации</link>.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	616 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	617
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	618 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	619 Параметр <literal>optional</literal> запрашивает клиентский
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	620 сертификат, и если сертификат был предоставлен, проверяет его.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	621 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	622
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	623 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	624 Параметр <literal>optional_no_ca</literal>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	625 запрашивает сертификат
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	626 клиента, но не требует, чтобы он был подписан доверенным сертификатом CA.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	627 Это предназначено для случаев, когда фактическая проверка сертификата
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	628 осуществляется внешним по отношению к nginx’у сервисом.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	629 Содержимое сертификата доступно в запросах,
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	630 <link doc="ngx_mail_auth_http_module.xml"
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	631 id="auth_http_pass_client_cert">посылаемых</link>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	632 на сервер аутентификации.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	633 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	634
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	635 </directive>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	636
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	637
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	638 <directive name="ssl_verify_depth">
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	639 <syntax><value>число</value></syntax>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	640 <default>1</default>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	641 <context>mail</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	642 <context>server</context>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	643 <appeared-in>1.7.11</appeared-in>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	644
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	645 <para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	646 Устанавливает глубину проверки в цепочке клиентских сертификатов.
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	647 </para>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	648
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	649 </directive>
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	650
06322891b4e3 Client certificate directives in mail_ssl_module and associates. Sergey Kandaurov <pluknet@nginx.com> parents: 1266 diff changeset	651
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	652 <directive name="starttls">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	653 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	654 <literal>on</literal> \|
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	655 <literal>off</literal> \|
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	656 <literal>only</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	657 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	658 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	659 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	660
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	661 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	662 <list type="tag">
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	663
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	664 <tag-name><literal>on</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	665 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	666 разрешить использование команд <literal>STLS</literal> для POP3
1924 237a10fb98d2 Clarified imap/pop3/smtp_capabilities and starttls interaction. Sergey Kandaurov <pluknet@nginx.com> parents: 1923 diff changeset	667 и <literal>STARTTLS</literal> для IMAP и SMTP;
630 a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	668 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	669
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	670 <tag-name><literal>off</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	671 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	672 запретить использование команд <literal>STLS</literal>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	673 и <literal>STARTTLS</literal>;
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	674 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	675
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	676 <tag-name><literal>only</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	677 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	678 требовать предварительного перехода на TLS.
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	679 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	680
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	681 </list>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	682 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	683
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	684 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	685
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	686 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	687
a235ce0f8eef Initial mail proxy server documentation in Russian. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	688 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/mail/ngx_mail_ssl_module.xml @ 2978:2b02fee0d12e