Mercurial > hg > nginx-site

changeset 2790:a281f61b5ad8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the ssl_alpn directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 01 Nov 2021 21:16:24 +0000
parents d16409187314
children 9385526a9b2d
files xml/en/docs/stream/ngx_stream_ssl_module.xml xml/ru/docs/stream/ngx_stream_ssl_module.xml
diffstat 2 files changed, 61 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:06:06 2021 +0000
+++ b/xml/en/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:16:24 2021 +0000
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_ssl_module"
         link="/en/docs/stream/ngx_stream_ssl_module.html"
         lang="en"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -79,6 +79,35 @@
 
 <section id="directives" name="Directives">
 
+<directive name="ssl_alpn">
+<syntax><value>protocol</value> ...</syntax>
+<default/>
+<context>stream</context>
+<context>server</context>
+<appeared-in>1.21.4</appeared-in>
+
+<para>
+Specifies the list of supported
+<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link> protocols.
+One of the protocols must be
+<link id="var_ssl_alpn_protocol">negotiated</link> if the client uses ALPN:
+<example>
+map $ssl_alpn_protocol $proxy {
+    h2                127.0.0.1:8001;
+    http/1.1          127.0.0.1:8002;
+}
+
+server {
+    listen      12346;
+    proxy_pass  $proxy;
+    ssl_alpn    h2 http/1.1;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="ssl_certificate">
 <syntax><value>file</value></syntax>
 <default/>
--- a/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:06:06 2021 +0000
+++ b/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:16:24 2021 +0000
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_ssl_module"
         link="/ru/docs/stream/ngx_stream_ssl_module.html"
         lang="ru"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -79,6 +79,36 @@
 
 <section id="directives" name="Директивы">
 
+<directive name="ssl_alpn">
+<syntax><value>протокол</value> ...</syntax>
+<default/>
+<context>stream</context>
+<context>server</context>
+<appeared-in>1.21.4</appeared-in>
+
+<para>
+Задаёт список поддерживаемых
+протоколов
+<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link>.
+Один из протоколов должен быть
+<link id="var_ssl_alpn_protocol">согласован</link>, если клиент использует ALPN:
+<example>
+map $ssl_alpn_protocol $proxy {
+    h2                 127.0.0.1:8001;
+    http/1.1           127.0.0.1:8002;
+}
+
+server {
+    listen      12346;
+    proxy_pass  $proxy;
+    ssl_alpn    h2 http/1.1;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="ssl_certificate">
 <syntax><value>файл</value></syntax>
 <default/>