Mercurial > hg > nginx-site

changeset 1587:c2a0a18e65ba

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added keepalive info for ntlm.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 26 Oct 2015 22:18:06 +0300
parents c4520ec8ce64
children d8d0f0eb1129
files xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_upstream_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_upstream_module.xml
diffstat 4 files changed, 78 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="41">
+        rev="42">
 
 <section id="summary">
 
@@ -897,7 +897,8 @@ Sets the HTTP protocol version for proxy
 By default, version 1.0 is used.
 Version 1.1 is recommended for use with
 <link doc="ngx_http_upstream_module.xml" id="keepalive"/>
-connections.
+connections and
+<link doc="ngx_http_upstream_module.xml" id="ntlm">NTLM authentication</link>.
 </para>
 
 </directive>
--- a/xml/en/docs/http/ngx_http_upstream_module.xml
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="43">
+        rev="44">
 
 <section id="summary">
 
@@ -536,6 +536,40 @@ keeping the authentication context.
 </para>
 
 <para>
+In order for NTLM authentication to work,
+it is necessary to enable keepalive connections to upstream servers.
+The <link doc="ngx_http_proxy_module.xml" id="proxy_http_version"/>
+directive should be set to “<literal>1.1</literal>”
+and the <header>Connection</header> header field should be cleared:
+<example>
+upstream http_backend {
+    server 127.0.0.1:8080;
+
+    ntlm;
+}
+
+server {
+    ...
+
+    location /http/ {
+        proxy_pass http://http_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Connection "";
+        ...
+    }
+}
+</example>
+</para>
+
+<para>
+<note>
+When using load balancer methods other than the default
+round-robin method, it is necessary to activate them before
+the <literal>ntlm</literal> directive.
+</note>
+</para>
+
+<para>
 <note>
 This directive is available as part of our
 <commercial_version>commercial subscription</commercial_version>.
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="41">
+        rev="42">
 
 <section id="summary">
 
@@ -896,7 +896,9 @@ nginx не передаёт клиенту поля заголовка <header>Date</header>,
 По умолчанию используется версия 1.0.
 Для работы
 <link doc="ngx_http_upstream_module.xml" id="keepalive">постоянных
-соединений</link> рекомендуется версия 1.1.
+соединений</link> и
+<link doc="ngx_http_upstream_module.xml" id="ntlm">проверки подлинности
+NTLM</link> рекомендуется версия 1.1.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="43">
+        rev="44">
 
 <section id="summary">
 
@@ -531,7 +531,7 @@ server {
 Позволяет проксировать запросы с
 <link url="https://en.wikipedia.org/wiki/Integrated_Windows_Authentication">проверкой
 подлинности NTLM</link>.
-Соединение с сервером группы привязывается к клиентскому соединению,
+Соединение с сервером группы привязывается к клиентскому соединению
 как только клиент отправляет запрос, в заголовке которого есть поле
 <header>Authorization</header> со значением,
 начинающимся с “<literal>Negotiate</literal>” или “<literal>NTLM</literal>”.
@@ -541,6 +541,40 @@ server {
 </para>
 
 <para>
+Для работы проверки подлинности NTLM
+необходимо разрешить постоянные соединения с серверами группы.
+Директиву <link doc="ngx_http_proxy_module.xml" id="proxy_http_version"/>
+следует установить в “<literal>1.1</literal>”,
+а поле заголовка <header>Connection</header> — очистить:
+<example>
+upstream http_backend {
+    server 127.0.0.1:8080;
+
+    ntlm;
+}
+
+server {
+    ...
+
+    location /http/ {
+        proxy_pass http://http_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Connection "";
+        ...
+    }
+}
+</example>
+</para>
+
+<para>
+<note>
+При использовании методов балансировки нагрузки, отличных
+от стандартного round-robin, следует активировать их до
+директивы <literal>ntlm</literal>.
+</note>
+</para>
+
+<para>
 <note>
 Эта директива доступна как часть
 <commercial_version>коммерческой подписки</commercial_version>.