diff xml/ru/docs/http/ngx_http_auth_jwt_module.xml @ 2082:fee7627f6a5a

Updated docs for the upcoming NGINX Plus release.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 11 Dec 2017 12:13:09 +0300
parents a58b35cc0823
children bdfbdf74fb3d
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_auth_jwt_module.xml
+++ b/xml/ru/docs/http/ngx_http_auth_jwt_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_http_auth_jwt_module"
         link="/ru/docs/http/ngx_http_auth_jwt_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -35,6 +35,30 @@ JWT claims должны быть зашифрованы в структуре
 </para>
 
 <para>
+Модуль поддерживает следующие криптографические
+<link url="https://tools.ietf.org/html/rfc7518#section-3.1">алгоритмы</link>:
+
+<list type="bullet">
+
+<listitem>
+HS256, HS384, HS512
+</listitem>
+
+<listitem>
+RS256, RS384, RS512
+</listitem>
+
+<listitem>
+ES256, ES384, ES512
+</listitem>
+
+</list>
+
+До версии 1.13.7
+поддерживались только алгоритмы HS256, RS256 и RS256.
+</para>
+
+<para>
 <note>
 Модуль доступен как часть
 <commercial_version>коммерческой подписки</commercial_version>.
@@ -98,28 +122,48 @@ auth_jwt "closed site" token=$cookie_aut
 
 
 <directive name="auth_jwt_header_set">
-<syntax><value>$переменная</value> <value>имя</value></syntax>
+<syntax><value>$переменная</value> <value>имя</value> ...</syntax>
 <default/>
 <context>http</context>
 <appeared-in>1.11.10</appeared-in>
 
 <para>
-Устанавливает <value>переменную</value> в заданное
-<value>имя</value> параметра заголовка JOSE.
+Устанавливает <value>переменную</value> в параметр заголовка JOSE,
+определяемый именами ключей.
+Сопоставление имён начинается с верхнего уровня дерева JSON.
+Для массива переменная хранит список его элементов, разделяемых запятыми.
+<note>
+До версии 1.13.7 можно было указать лишь одно имя,
+результат для массивов был не определён.
+</note>
 </para>
 
 </directive>
 
 
 <directive name="auth_jwt_claim_set">
-<syntax><value>$переменная</value> <value>имя</value></syntax>
+<syntax><value>$переменная</value> <value>имя</value> ...</syntax>
 <default/>
 <context>http</context>
 <appeared-in>1.11.10</appeared-in>
 
 <para>
-Устанавливает <value>переменную</value> в заданное
-<value>имя</value> параметра JWT claim.
+Устанавливает <value>переменную</value> в параметр JWT claim,
+определяемый именами ключей.
+Сопоставление имён начинается с верхнего уровня дерева JSON.
+Для массива переменная хранит список его элементов, разделяемых запятыми.
+<example>
+location / {
+    auth_jwt           "closed site";
+    auth_jwt_key_file  conf/keys.json;
+    auth_jwt_claim_set $email info e-mail;
+    auth_jwt_claim_set $job info "job title";
+}
+</example>
+<note>
+До версии 1.13.7 можно было указать лишь одно имя,
+результат для массивов был не определён.
+</note>
 </para>
 
 </directive>