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

comparison xml/ru/docs/http/configuring_https_servers.xml @ 801:b95a6d779c89

Documented that "listen ... ssl" is preferred over "ssl on".

author	Ruslan Ermilov <ru@nginx.com>
date	Thu, 27 Dec 2012 17:16:39 +0000
parents	2ceaef0e84a1
children	4fecf0715bbf

comparison

equal deleted inserted replaced

-:015981070efd
+:b95a6d779c89
 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
 <article name="Настройка HTTPS-серверов"
 link="/ru/docs/http/configuring_https_servers.html"
 lang="ru"
-rev="4"
+rev="5"
 author="Игорь Сысоев"
 editor="Brian Mercer">
 <section>
 <para>
-Чтобы настроить HTTPS-сервер, необходимо включить протокол SSL
+Чтобы настроить HTTPS-сервер, необходимо включить параметр
-в блоке server, а также указать местоположение файлов с
+<literal>ssl</literal> на
+<link doc="ngx_http_core_module.xml" id="listen">слушающих сокетах</link>
+в блоке <link doc="ngx_http_core_module.xml" id="server"/>,
+а также указать местоположение файлов с
 сертификатом сервера и секретным ключом:
 <programlisting>
 server {
-listen              443;
+listen              443 <b>ssl</b>;
 server_name         www.example.com;
-ssl                 <b>on</b>;
 ssl_certificate     <b>www.example.com.crt</b>;
 ssl_certificate_key <b>www.example.com.key</b>;
 ssl_protocols       SSLv3 TLSv1 TLSv1.1 TLSv1.2;
 ssl_ciphers         HIGH:!aNULL:!MD5;
 ...
 http {
 <b>ssl_session_cache   shared:SSL:10m</b>;
 <b>ssl_session_timeout 10m</b>;
 server {
-listen              443;
+listen              443 ssl;
 server_name         www.example.com;
 <b>keepalive_timeout   70</b>;
-ssl                 on;
 ssl_certificate     www.example.com.crt;
 ssl_certificate_key www.example.com.key;
 ssl_protocols       SSLv3 TLSv1 TLSv1.1 TLSv1.2;
 ssl_ciphers         HIGH:!aNULL:!MD5;
 ...
 Полученный файл следует указать в директиве
 <link doc="ngx_http_ssl_module.xml" id="ssl_certificate"/>:
 <programlisting>
 server {
-listen              443;
+listen              443 ssl;
 server_name         www.example.com;
-ssl                 on;
 ssl_certificate     www.example.com.chained.crt;
 ssl_certificate_key www.example.com.key;
 ...
 }
 </programlisting>
 <section id="single_http_https_server" name="Единый HTTP/HTTPS сервер">
 <para>
-Если серверы HTTP и HTTPS идентичны,
+Можно настроить единый сервер, который обслуживает как HTTP-,
-можно настроить единый сервер, который обслуживает как HTTP-,
+так и HTTPS-запросы:
-так и HTTPS-запросы.
-Для этого следует исключить директиву “<literal>ssl on</literal>”
-и добавить параметр <literal>ssl</literal> к порту *:443:
 <programlisting>
 server {
 listen              80;
 listen              443 ssl;
 ...
 }
 </programlisting>
 <note>
-До версии 0.8.21 nginx допускал указание параметра <literal>ssl</literal>
+До версии 0.7.14 SSL нельзя было включить выборочно для
-на слушающем сокете только совместно с параметром <literal>default</literal>:
+отдельных слущающих сокетов, как показано выше.
-<programlisting>
+SSL можно было включить только для всего сервера целиком,
-listen  443  default  ssl;
+с помощью директивы <link doc="ngx_http_ssl_module.xml" id="ssl"/>,
-</programlisting>
+что не позволяло настроить единый HTTP/HTTPS сервер.
+Для решения этой задачи был добавлен
+параметр <literal>ssl</literal>
+директивы <link doc="ngx_http_core_module.xml" id="listen"/>.
+Поэтому использование
+директивы <link doc="ngx_http_ssl_module.xml" id="ssl"/>
+в современных версиях не рекомендуется.
 </note>
 </para>
 </section>
 Типичная проблема возникает при настройке двух и более серверов HTTPS,
 слушающих на одном и том же IP-адресе:
 <programlisting>
 server {
-listen          443;
+listen          443 ssl;
 server_name     www.example.com;
-ssl             on;
 ssl_certificate www.example.com.crt;
 ...
 }
 server {
-listen          443;
+listen          443 ssl;
 server_name     www.example.org;
-ssl             on;
 ssl_certificate www.example.org.crt;
 ...
 }
 </programlisting>
 Наиболее старым и надёжным способом решения этой проблемы
 является назначение каждому HTTPS-серверу своего IP-адреса:
 <programlisting>
 server {
-listen          192.168.1.1:443;
+listen          192.168.1.1:443 ssl;
 server_name     www.example.com;
-ssl             on;
 ssl_certificate www.example.com.crt;
 ...
 }
 server {
-listen          192.168.1.2:443;
+listen          192.168.1.2:443 ssl;
 server_name     www.example.org;
-ssl             on;
 ssl_certificate www.example.org.crt;
 ...
 }
 </programlisting>
 </para>
-</section>
 <section id="certificate_with_several_names"
 name="SSL-сертификат с несколькими именами">
 <programlisting>
 ssl_certificate     common.crt;
 ssl_certificate_key common.key;
 server {
-listen          443;
+listen          443 ssl;
 server_name     www.example.com;
-ssl             on;
+...
-...
+}
-}
+server {
-server {
+listen          443 ssl;
-listen          443;
 server_name     www.example.org;
-ssl             on;
 ...
 }
 </programlisting>
 </para>
 </programlisting>
 </para>
 </section>
+</section>
 <section id="compatibility" name="Совместимость">
 <para>
 <list type="bullet">
 <listitem>
 Параметр <literal>ssl</literal> директивы
 <link doc="ngx_http_core_module.xml" id="listen"/>
 поддерживается начиная с версии 0.7.14.
+До версии 0.8.21 его можно было указывать только совместно с
+параметром <literal>default</literal>.
 </listitem>
 <listitem>
 SNI поддерживается начиная с версии 0.5.32.
 </listitem>

Mercurial > hg > nginx-site

comparison xml/ru/docs/http/configuring_https_servers.xml @ 801:b95a6d779c89