diff xml/ru/docs/mail/ngx_mail_auth_http_module.xml @ 1429:06322891b4e3

Client certificate directives in mail_ssl_module and associates.
author Sergey Kandaurov <pluknet@nginx.com>
date Sat, 28 Feb 2015 00:31:18 +0300
parents ebfcd76e23b6
children 7133004fa5b3
line wrap: on
line diff
--- a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Sat Feb 28 00:31:16 2015 +0300
+++ b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml	Sat Feb 28 00:31:18 2015 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_auth_http_module"
         link="/ru/docs/mail/ngx_mail_auth_http_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="directives" name="Директивы">
 
@@ -47,6 +47,23 @@
 </directive>
 
 
+<directive name="auth_http_pass_client_cert">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>mail</context>
+<context>server</context>
+<appeared-in>1.7.11</appeared-in>
+
+<para>
+Добавляет заголовок <header>Auth-SSL-Cert</header> с
+<link doc="ngx_mail_ssl_module.xml" id="ssl_verify_client">клиентским</link>
+сертификатом в формате PEM (закодирован в формате urlencode)
+к запросам, посылаемым на сервер аутентификации.
+</para>
+
+</directive>
+
+
 <directive name="auth_http_timeout">
 <syntax><value>время</value></syntax>
 <default>60s</default>
@@ -183,6 +200,40 @@
 </example>
 </para>
 
+<para>
+Для клиентского соединения по протоколу SSL/TLS (1.7.11)
+добавляется заголовок <header>Auth-SSL</header>, и если директива
+<link doc="ngx_mail_ssl_module.xml" id="ssl_verify_client"/> включена,
+заголовок <header>Auth-SSL-Verify</header> содержит
+результат проверки клиентского сертификата:
+“<literal>SUCCESS</literal>”, “<literal>FAILED</literal>” и,
+если сертификат не был предоставлен — “<literal>NONE</literal>”.
+Если клиентский сертификат был предоставлен,
+информация о нём передаётся в следующих заголовках запроса:
+<header>Auth-SSL-Subject</header>, <header>Auth-SSL-Issuer</header>,
+<header>Auth-SSL-Serial</header> и <header>Auth-SSL-Fingerprint</header>.
+Если директива <link id="auth_http_pass_client_cert"/> включена,
+сам сертификат передаётся в заголовке
+<header>Auth-SSL-Cert</header>.
+Запрос будет выглядеть так:
+<example>
+GET /auth HTTP/1.0
+Host: localhost
+Auth-Method: plain
+Auth-User: user
+Auth-Pass: password
+Auth-Protocol: imap
+Auth-Login-Attempt: 1
+Client-IP: 192.0.2.42
+Auth-SSL: on
+Auth-SSL-Verify: SUCCESS
+Auth-SSL-Subject: /CN=example.com
+Auth-SSL-Issuer: /CN=example.com
+Auth-SSL-Serial: C07AD56B846B5BFF
+Auth-SSL-Fingerprint: 29d6a80a123d13355ed16b4b04605e29cb55a5ad
+</example>
+</para>
+
 </section>
 
 </module>