diff xml/en/docs/http/ngx_http_ssl_module.xml @ 2334:dbe55598d3f6

Added variables support in ssl_certificate and ssl_certificate_key.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 26 Feb 2019 18:33:47 +0300
parents e2e71f9477a8
children 8e35f3af574b
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_ssl_module.xml	Tue Feb 26 18:23:25 2019 +0300
+++ b/xml/en/docs/http/ngx_http_ssl_module.xml	Tue Feb 26 18:33:47 2019 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_ssl_module"
         link="/en/docs/http/ngx_http_ssl_module.html"
         lang="en"
-        rev="44">
+        rev="45">
 
 <section id="summary">
 
@@ -175,6 +175,18 @@
 </para>
 
 <para>
+Since version 1.15.9, variables can be used in the <value>file</value> name
+when using OpenSSL 1.0.2 or higher:
+<example>
+ssl_certificate     $ssl_server_name.crt;
+ssl_certificate_key $ssl_server_name.key;
+</example>
+Note that using variables implies that
+a certificate will be loaded for each SSL handshake,
+and this may have a negative impact on performance.
+</para>
+
+<para>
 It should be kept in mind that due to the HTTPS protocol limitations
 for maximum interoperability virtual servers should listen on
 <link doc="configuring_https_servers.xml" id="name_based_https_servers">different
@@ -203,6 +215,11 @@
 from the OpenSSL engine <value>name</value>.
 </para>
 
+<para>
+Since version 1.15.9, variables can be used in the <value>file</value> name
+when using OpenSSL 1.0.2 or higher.
+</para>
+
 </directive>