Mercurial > hg > nginx-site

changeset 1832:c30d3557ec68

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Translated the JWT module into Russian.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 25 Oct 2016 15:01:47 +0300
parents b5e416ace4bf
children 0c4b43e26cea
files xml/ru/GNUmakefile xml/ru/docs/http/ngx_http_auth_jwt_module.xml xml/ru/docs/index.xml
diffstat 3 files changed, 57 insertions(+), 58 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -28,6 +28,7 @@ REFS =									\
 		http/ngx_http_access_module				\
 		http/ngx_http_addition_module				\
 		http/ngx_http_auth_basic_module				\
+		http/ngx_http_auth_jwt_module				\
 		http/ngx_http_auth_request_module			\
 		http/ngx_http_autoindex_module				\
 		http/ngx_http_browser_module				\
copy from xml/en/docs/http/ngx_http_auth_jwt_module.xml
copy to xml/ru/docs/http/ngx_http_auth_jwt_module.xml
--- a/xml/en/docs/http/ngx_http_auth_jwt_module.xml
+++ b/xml/ru/docs/http/ngx_http_auth_jwt_module.xml
@@ -6,47 +6,45 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Module ngx_http_auth_jwt_module"
-        link="/en/docs/http/ngx_http_auth_jwt_module.html"
-        lang="en"
+<module name="Модуль ngx_http_auth_jwt_module"
+        link="/ru/docs/http/ngx_http_auth_jwt_module.html"
+        lang="ru"
         rev="2">
 
 <section id="summary">
 
 <para>
-The <literal>ngx_http_auth_jwt_module</literal> module (1.11.3)
-implements client authorization by validating the provided
+Модуль <literal>ngx_http_auth_jwt_module</literal> (1.11.3)
+предоставляет возможность авторизации клиента с проверкой предоставляемого
 <link url="https://tools.ietf.org/html/rfc7519">JSON Web Token</link> (JWT)
-using the specified keys.
-JWT claims must be encoded in a
-<link url="https://tools.ietf.org/html/rfc7515">JSON Web Signature</link> (JWS)
-structure.
-The module can be used for
-<link url="http://openid.net/specs/openid-connect-core-1_0.html">OpenID Connect</link>
-authentication.
+при помощи указанных ключей.
+JWT claims должны быть зашифрованы в структуре
+<link url="https://tools.ietf.org/html/rfc7515">JSON Web Signature</link> (JWS).
+Модуль может использоваться для настройки аутентификации
+<link url="http://openid.net/specs/openid-connect-core-1_0.html">OpenID Connect</link>.
 </para>
 
 <para>
-The module may be combined with
-other access modules, such as
+Модуль может быть скомбинирован с
+другими модулями доступа, такими как
 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
-<link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>,
-and
-<link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>,
-via the <link doc="ngx_http_core_module.xml" id="satisfy"/> directive.
+<link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
+и
+<link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
+с помощью директивы <link doc="ngx_http_core_module.xml" id="satisfy"/>.
 </para>
 
 <para>
 <note>
-This module is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Модуль доступен как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>
 
 </section>
 
 
-<section id="example" name="Example Configuration">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
@@ -60,12 +58,12 @@ location / {
 </section>
 
 
-<section id="directives" name="Directives">
+<section id="directives" name="Директивы">
 
 <directive name="auth_jwt">
 <syntax>
-    <value>string</value>
-    [<literal>token=</literal><value>$variable</value>] |
+    <value>строка</value>
+    [<literal>token=</literal><value>$переменная</value>] |
     <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
@@ -73,44 +71,44 @@ location / {
 <context>location</context>
 
 <para>
-Enables validation of JSON Web Token.
-The specified <value>string</value> is used as a <literal>realm</literal>.
-Parameter value can contain variables.
+Включает проверку JSON Web Token.
+Заданная <value>строка</value> используется в качестве <literal>realm</literal>.
+В значении параметра допустимо использование переменных.
 </para>
 
 <para>
-The optional <literal>token</literal> parameter specifies a variable
-that contains JSON Web Token.
-By default, JWT is passed in the <header>Authorization</header> header
-as a
+Необязательный параметр <literal>token</literal> задаёт переменную,
+содержащую JSON Web Token.
+По умолчанию JWT передаётся в заголовке <header>Authorization</header>
+в качестве
 <link url="https://tools.ietf.org/html/rfc6750">Bearer Token</link>.
-JWT may be also passed as a cookie or a part of a query string:
+JWT может также передаваться как кука или часть строки запроса:
 <example>
 auth_jwt "closed site" token=$cookie_auth_token;
 </example>
 </para>
 
 <para>
-The special value <literal>off</literal> cancels the effect
-of the <literal>auth_jwt</literal> directive
-inherited from the previous configuration level.
+Специальное значение <literal>off</literal> отменяет действие
+унаследованной с предыдущего уровня конфигурации
+директивы <literal>auth_jwt</literal>.
 </para>
 
 </directive>
 
 
 <directive name="auth_jwt_key_file">
-<syntax><value>file</value></syntax>
+<syntax><value>файл</value></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 
 <para>
-Specifies a <value>file</value> in
+Задаёт <value>файл</value> в формате
 <link url="https://tools.ietf.org/html/rfc7517#section-5">JSON Web Key Set</link>
-format for validating JWT signature.
-Parameter value can contain variables.
+для проверки подписи JWT.
+В значении параметра допустимо использование переменных.
 </para>
 
 </directive>
@@ -118,21 +116,21 @@ Parameter value can contain variables.
 </section>
 
 
-<section id="variables" name="Embedded Variables">
+<section id="variables" name="Встроенные переменные">
 
 <para>
-The <literal>ngx_http_auth_jwt_module</literal> module
-supports embedded variables.
+Модуль <literal>ngx_http_auth_jwt_module</literal>
+поддерживает встроенные переменные.
 </para>
 
 <para>
-Variables that return
+Переменные, возвращающие
 <link url="https://tools.ietf.org/html/rfc7519#section-4">JWT claims</link>:
 
 <list type="tag" compact="yes">
 <tag-name id="var_jwt_claim_aud"><var>$jwt_claim_aud</var></tag-name>
 <tag-desc>
-audience
+audience (аудитория)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_email"><var>$jwt_claim_email</var></tag-name>
@@ -142,64 +140,64 @@ email
 
 <tag-name id="var_jwt_claim_exp"><var>$jwt_claim_exp</var></tag-name>
 <tag-desc>
-expiration time
+expiration time (время окончания действия)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_iat"><var>$jwt_claim_iat</var></tag-name>
 <tag-desc>
-issued at
+issued at (когда выдан)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_iss"><var>$jwt_claim_iss</var></tag-name>
 <tag-desc>
-issuer
+issuer (издатель)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_jti"><var>$jwt_claim_jti</var></tag-name>
 <tag-desc>
-JWT ID
+JWT ID (идентификатор JWT)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_nbf"><var>$jwt_claim_nbf</var></tag-name>
 <tag-desc>
-not-before
+not-before (не ранее, чем)
 </tag-desc>
 
 <tag-name id="var_jwt_claim_sub"><var>$jwt_claim_sub</var></tag-name>
 <tag-desc>
-subject
+subject (субъект)
 </tag-desc>
 </list>
 </para>
 
 <para>
-Variables that return parameters of
-<link url="https://tools.ietf.org/html/rfc7515#section-4">JOSE header</link>:
+Переменные, возвращающие параметры
+<link url="https://tools.ietf.org/html/rfc7515#section-4">заголовка JOSE</link>:
 
 <list type="tag" compact="yes">
 <tag-name id="var_jwt_header_alg"><var>$jwt_header_alg</var></tag-name>
 <tag-desc>
-algorithm
+algorithm (алгоритм)
 </tag-desc>
 
 <tag-name id="var_jwt_header_cty"><var>$jwt_header_cty</var></tag-name>
 <tag-desc>
-content type
+content type (тип содержимого)
 </tag-desc>
 
 <tag-name id="var_jwt_header_enc"><var>$jwt_header_enc</var></tag-name>
 <tag-desc>
-encryption algorithm
+encryption algorithm (алгоритм шифрования)
 </tag-desc>
 
 <tag-name id="var_jwt_header_kid"><var>$jwt_header_kid</var></tag-name>
 <tag-desc>
-key ID
+key ID (идентификатор ключа)
 </tag-desc>
 
 <tag-name id="var_jwt_header_typ"><var>$jwt_header_typ</var></tag-name>
 <tag-desc>
-type
+type (тип)
 </tag-desc>
 
 </list>
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -213,7 +213,7 @@ ngx_http_auth_basic_module</link>
 
 <listitem>
 <link doc="http/ngx_http_auth_jwt_module.xml">
-ngx_http_auth_jwt_module</link> [en]
+ngx_http_auth_jwt_module</link>
 </listitem>
 
 <listitem>