Mercurial > hg > nginx-site
changeset 1832:c30d3557ec68
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>