# HG changeset patch
# User Sergey Kandaurov <pluknet@nginx.com>
# Date 1629314272 -10800
# Node ID 96d6d66d36e4298a1114a0c3c31abbcbdec7640b
# Parent  7898e090ad721a44e6032df7df16b562effd7d31
Documented Auth-SSL-Protocol and Auth-SSL-Cipher mail auth headers.

diff --git a/xml/en/docs/mail/ngx_mail_auth_http_module.xml b/xml/en/docs/mail/ngx_mail_auth_http_module.xml
--- a/xml/en/docs/mail/ngx_mail_auth_http_module.xml
+++ b/xml/en/docs/mail/ngx_mail_auth_http_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_auth_http_module"
         link="/en/docs/mail/ngx_mail_auth_http_module.html"
         lang="en"
-        rev="10">
+        rev="11">
 
 <section id="directives" name="Directives">
 
@@ -221,6 +221,9 @@ its details are passed in the following 
 If <link id="auth_http_pass_client_cert"/> is enabled,
 the certificate itself is passed in the
 <header>Auth-SSL-Cert</header> header.
+The protocol and cipher of the established connection
+are passed in the <header>Auth-SSL-Protocol</header>
+and <header>Auth-SSL-Cipher</header> headers (1.21.2).
 The request will look as follows:
 <example>
 GET /auth HTTP/1.0
@@ -232,6 +235,8 @@ Auth-Protocol: imap
 Auth-Login-Attempt: 1
 Client-IP: 192.0.2.42
 Auth-SSL: on
+Auth-SSL-Protocol: TLSv1.3
+Auth-SSL-Cipher: TLS_AES_256_GCM_SHA384
 Auth-SSL-Verify: SUCCESS
 Auth-SSL-Subject: /CN=example.com
 Auth-SSL-Issuer: /CN=example.com
diff --git a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml
--- a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_auth_http_module"
         link="/ru/docs/mail/ngx_mail_auth_http_module.html"
         lang="ru"
-        rev="10">
+        rev="11">
 
 <section id="directives" name="Директивы">
 
@@ -219,6 +219,9 @@ Auth-SMTP-To: RCPT TO: &lt;postmaster@ma
 Если директива <link id="auth_http_pass_client_cert"/> включена,
 сам сертификат передаётся в заголовке
 <header>Auth-SSL-Cert</header>.
+Протокол и шифр установленного соединения
+передаются в заголовках <header>Auth-SSL-Protocol</header>
+и <header>Auth-SSL-Cipher</header> (1.21.2).
 Запрос будет выглядеть так:
 <example>
 GET /auth HTTP/1.0
@@ -230,6 +233,8 @@ Auth-Protocol: imap
 Auth-Login-Attempt: 1
 Client-IP: 192.0.2.42
 Auth-SSL: on
+Auth-SSL-Protocol: TLSv1.3
+Auth-SSL-Cipher: TLS_AES_256_GCM_SHA384
 Auth-SSL-Verify: SUCCESS
 Auth-SSL-Subject: /CN=example.com
 Auth-SSL-Issuer: /CN=example.com