Mercurial > hg > nginx-site

changeset 2773:a2852750c379

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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	Tue Oct 12 20:55:26 2021 +0100
+++ b/xml/en/docs/http/ngx_http_js_module.xml	Thu Oct 14 18:53:16 2021 +0100
@@ -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 @@
 </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	Tue Oct 12 20:55:26 2021 +0100
+++ b/xml/en/docs/stream/ngx_stream_js_module.xml	Thu Oct 14 18:53:16 2021 +0100
@@ -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 @@
 </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	Tue Oct 12 20:55:26 2021 +0100
+++ b/xml/ru/docs/http/ngx_http_js_module.xml	Thu Oct 14 18:53:16 2021 +0100
@@ -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 @@
 </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	Tue Oct 12 20:55:26 2021 +0100
+++ b/xml/ru/docs/stream/ngx_stream_js_module.xml	Thu Oct 14 18:53:16 2021 +0100
@@ -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 @@
 </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/>