Mercurial > hg > nginx-site
changeset 2773:a2852750c379
Added fetch directives to js http and stream modules.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Thu, 14 Oct 2021 18:53:16 +0100 |
parents | 91aaf82442e9 |
children | 7255a5468474 |
files | xml/en/docs/http/ngx_http_js_module.xml xml/en/docs/stream/ngx_stream_js_module.xml xml/ru/docs/http/ngx_http_js_module.xml xml/ru/docs/stream/ngx_stream_js_module.xml |
diffstat | 4 files changed, 309 insertions(+), 4 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_js_module.xml +++ b/xml/en/docs/http/ngx_http_js_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_http_js_module" link="/en/docs/http/ngx_http_js_module.html" lang="en" - rev="29"> + rev="30"> <section id="summary"> @@ -202,6 +202,84 @@ a module function can be referenced. </directive> +<directive name="js_fetch_ciphers"> +<syntax><value>ciphers</value></syntax> +<default>HIGH:!aNULL:!MD5</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Specifies the enabled ciphers for HTTPS requests +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +The ciphers are specified in the format understood by the +OpenSSL library. +</para> + +<para> +The full list can be viewed using the +“<command>openssl ciphers</command>” command. +</para> + +</directive> + + +<directive name="js_fetch_protocols"> +<syntax> + [<literal>TLSv1</literal>] + [<literal>TLSv1.1</literal>] + [<literal>TLSv1.2</literal>] + [<literal>TLSv1.3</literal>]</syntax> +<default>TLSv1 TLSv1.1 TLSv1.2</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Enables the specified protocols for HTTPS requests +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_trusted_certificate"> +<syntax><value>file</value></syntax> +<default/> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Specifies a <value>file</value> with trusted CA certificates in the PEM format +used to +<link doc="../njs/reference.xml" id="fetch_verify">verify</link> +the HTTPS certificate +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_verify_depth"> +<syntax><value>number</value></syntax> +<default>100</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Sets the verification depth in the HTTPS server certificates chain +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + <directive name="js_header_filter"> <syntax><value>function</value> | <value>module.function</value></syntax> <default/>
--- a/xml/en/docs/stream/ngx_stream_js_module.xml +++ b/xml/en/docs/stream/ngx_stream_js_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_stream_js_module" link="/en/docs/stream/ngx_stream_js_module.html" lang="en" - rev="28"> + rev="29"> <section id="summary"> @@ -145,6 +145,79 @@ a module function can be referenced. </directive> +<directive name="js_fetch_ciphers"> +<syntax><value>ciphers</value></syntax> +<default>HIGH:!aNULL:!MD5</default> +<context>stream</context> +<context>server</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Specifies the enabled ciphers for HTTPS connections +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +The ciphers are specified in the format understood by the OpenSSL library. +</para> + +<para> +The full list can be viewed using the +“<command>openssl ciphers</command>” command. +</para> + +</directive> + + +<directive name="js_fetch_protocols"> +<syntax> + [<literal>TLSv1</literal>] + [<literal>TLSv1.1</literal>] + [<literal>TLSv1.2</literal>] + [<literal>TLSv1.3</literal>]</syntax> +<default>TLSv1 TLSv1.1 TLSv1.2</default> +<context>stream</context> +<context>server</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Enables the specified protocols for HTTPS connections +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_trusted_certificate"> +<syntax><value>file</value></syntax> +<default/> +<context>stream</context> +<context>server</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Specifies a <value>file</value> with trusted CA certificates in the PEM format +used to +<link doc="../njs/reference.xml" id="fetch_verify">verify</link> +the HTTPS certificate +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_verify_depth"> +<syntax><value>number</value></syntax> +<default>100</default> +<context>stream</context> +<context>server</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Sets the verification depth in the HTTPS server certificates chain +with <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + <directive name="js_filter"> <syntax><value>function</value> | <value>module.function</value></syntax> <default/>
--- a/xml/ru/docs/http/ngx_http_js_module.xml +++ b/xml/ru/docs/http/ngx_http_js_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_http_js_module" link="/ru/docs/http/ngx_http_js_module.html" lang="ru" - rev="29"> + rev="30"> <section id="summary"> @@ -202,6 +202,83 @@ function filter(r, data, flags) { </directive> +<directive name="js_fetch_ciphers"> +<syntax><value>шифры</value></syntax> +<default>HIGH:!aNULL:!MD5</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Описывает разрешённые шифры для HTTPS-запросов +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +Шифры задаются в формате, поддерживаемом библиотекой OpenSSL. +</para> + +<para> +Полный список можно посмотреть с помощью команды +“<command>openssl ciphers</command>”. +</para> + +</directive> + + +<directive name="js_fetch_protocols"> +<syntax> + [<literal>TLSv1</literal>] + [<literal>TLSv1.1</literal>] + [<literal>TLSv1.2</literal>] + [<literal>TLSv1.3</literal>]</syntax> +<default>TLSv1 TLSv1.1 TLSv1.2</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Разрешает указанные протоколы для HTTPS-запросов +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_trusted_certificate"> +<syntax><value>файл</value></syntax> +<default/> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM, +используемыми при +<link doc="../njs/reference.xml" id="fetch_verify">проверке</link> +HTTPS-сертификата +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_verify_depth"> +<syntax><value>число</value></syntax> +<default>100</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Устанавливает глубину проверки в цепочке HTTPS-сертификатов +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + <directive name="js_header_filter"> <syntax><value>функция</value> | <value>модуль.функция</value></syntax> <default/>
--- a/xml/ru/docs/stream/ngx_stream_js_module.xml +++ b/xml/ru/docs/stream/ngx_stream_js_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_stream_js_module" link="/ru/docs/stream/ngx_stream_js_module.html" lang="ru" - rev="28"> + rev="29"> <section id="summary"> @@ -145,6 +145,83 @@ export default {bar, preread, req_line, </directive> +<directive name="js_fetch_ciphers"> +<syntax><value>шифры</value></syntax> +<default>HIGH:!aNULL:!MD5</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Описывает разрешённые шифры для HTTPS-соединений +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +Шифры задаются в формате, поддерживаемом библиотекой OpenSSL. +</para> + +<para> +Полный список можно посмотреть с помощью команды +“<command>openssl ciphers</command>”. +</para> + +</directive> + + +<directive name="js_fetch_protocols"> +<syntax> + [<literal>TLSv1</literal>] + [<literal>TLSv1.1</literal>] + [<literal>TLSv1.2</literal>] + [<literal>TLSv1.3</literal>]</syntax> +<default>TLSv1 TLSv1.1 TLSv1.2</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Разрешает указанные протоколы для HTTPS-соединений +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_trusted_certificate"> +<syntax><value>файл</value></syntax> +<default/> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM, +используемыми при +<link doc="../njs/reference.xml" id="fetch_verify">проверке</link> +HTTPS-сертификата +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + +<directive name="js_fetch_verify_depth"> +<syntax><value>число</value></syntax> +<default>100</default> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.0</appeared-in> + +<para> +Устанавливает глубину проверки в цепочке HTTPS-сертификатов +при помощи <link doc="../njs/reference.xml" id="ngx_fetch">Fetch API</link>. +</para> + +</directive> + + <directive name="js_filter"> <syntax><value>функция</value> | <value>модуль.функция</value></syntax> <default/>