comparison xml/en/docs/stream/ngx_stream_ssl_module.xml @ 2790:a281f61b5ad8

Documented the ssl_alpn directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 01 Nov 2021 21:16:24 +0000
parents d16409187314
children 4b73197f8ca9
comparison
equal deleted inserted replaced
2789:d16409187314 2790:a281f61b5ad8
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Module ngx_stream_ssl_module" 9 <module name="Module ngx_stream_ssl_module"
10 link="/en/docs/stream/ngx_stream_ssl_module.html" 10 link="/en/docs/stream/ngx_stream_ssl_module.html"
11 lang="en" 11 lang="en"
12 rev="26"> 12 rev="27">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 The <literal>ngx_stream_ssl_module</literal> module (1.9.0) 17 The <literal>ngx_stream_ssl_module</literal> module (1.9.0)
76 76
77 </section> 77 </section>
78 78
79 79
80 <section id="directives" name="Directives"> 80 <section id="directives" name="Directives">
81
82 <directive name="ssl_alpn">
83 <syntax><value>protocol</value> ...</syntax>
84 <default/>
85 <context>stream</context>
86 <context>server</context>
87 <appeared-in>1.21.4</appeared-in>
88
89 <para>
90 Specifies the list of supported
91 <link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link> protocols.
92 One of the protocols must be
93 <link id="var_ssl_alpn_protocol">negotiated</link> if the client uses ALPN:
94 <example>
95 map $ssl_alpn_protocol $proxy {
96 h2 127.0.0.1:8001;
97 http/1.1 127.0.0.1:8002;
98 }
99
100 server {
101 listen 12346;
102 proxy_pass $proxy;
103 ssl_alpn h2 http/1.1;
104 }
105 </example>
106 </para>
107
108 </directive>
109
81 110
82 <directive name="ssl_certificate"> 111 <directive name="ssl_certificate">
83 <syntax><value>file</value></syntax> 112 <syntax><value>file</value></syntax>
84 <default/> 113 <default/>
85 <context>stream</context> 114 <context>stream</context>