Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_internal_redirect_module.xml @ 2956:a85e4d126bc7
Updated docs for the upcoming NGINX Plus release.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 02 May 2023 11:39:21 +0100 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
2955:2c4d7151b9a9 | 2956:a85e4d126bc7 |
---|---|
1 <?xml version="1.0"?> | |
2 | |
3 <!-- | |
4 Copyright (C) Nginx, Inc. | |
5 --> | |
6 | |
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | |
8 | |
9 <module name="Модуль ngx_http_internal_redirect_module" | |
10 link="/ru/docs/http/ngx_http_internal_redirect_module.html" | |
11 lang="ru" | |
12 rev="1"> | |
13 | |
14 <section id="summary"> | |
15 | |
16 <para> | |
17 Модуль <literal>ngx_http_internal_redirect_module</literal> (1.23.4) позволяет | |
18 осуществлять внутреннее перенаправление. | |
19 В отличие от | |
20 <link doc="ngx_http_rewrite_module.xml">изменения URI</link>, | |
21 перенаправление происходит после проверок ограничений | |
22 <link doc="ngx_http_limit_req_module.xml">скорости обработки запросов</link>, | |
23 <link doc="ngx_http_limit_conn_module.xml">числа соединений</link> | |
24 и <link doc="ngx_http_access_module.xml">доступа</link>. | |
25 </para> | |
26 | |
27 <para> | |
28 <note> | |
29 Модуль доступен как часть | |
30 <commercial_version>коммерческой подписки</commercial_version> | |
31 </note> | |
32 </para> | |
33 | |
34 </section> | |
35 | |
36 | |
37 <section id="example" name="Пример конфигурации"> | |
38 | |
39 <para> | |
40 <example> | |
41 limit_req_zone $jwt_claim_sub zone=jwt_sub:10m rate=1r/s; | |
42 | |
43 server { | |
44 location / { | |
45 auth_jwt "realm"; | |
46 auth_jwt_key_file key.jwk; | |
47 | |
48 internal_redirect @rate_limited; | |
49 } | |
50 | |
51 location @rate_limited { | |
52 internal; | |
53 | |
54 limit_req zone=jwt_sub burst=10; | |
55 proxy_pass http://backend; | |
56 } | |
57 } | |
58 </example> | |
59 В примере | |
60 <link doc="ngx_http_limit_req_module.xml">скорость обработки запросов</link> | |
61 ограничивается по | |
62 <link url="https://datatracker.ietf.org/doc/html/rfc7519#section-4.1.2">идентификатору | |
63 клиента</link>. | |
64 Конфигурация без <link id="internal_redirect">internal_redirect</link> | |
65 может быть подвержена DoS-атакам при помощи неподписанных JWT, так как проверка | |
66 <link doc="ngx_http_limit_req_module.xml" id="limit_req">limit_req</link> | |
67 выполняется | |
68 <link doc="../dev/development_guide.xml" id="http_phases">перед</link> | |
69 проверкой | |
70 <link doc="ngx_http_auth_jwt_module.xml" id="auth_jwt">auth_jwt</link>. | |
71 Использование <link id="internal_redirect">internal_redirect</link> | |
72 позволяет изменить порядок этих проверок. | |
73 </para> | |
74 | |
75 </section> | |
76 | |
77 | |
78 <section id="directives" name="Директивы"> | |
79 | |
80 <directive name="internal_redirect"> | |
81 <syntax><value>uri</value></syntax> | |
82 <default/> | |
83 <context>server</context> | |
84 <context>location</context> | |
85 | |
86 <para> | |
87 Задаёт URI для внутреннего перенаправления запроса. | |
88 Вместо URI также можно использовать | |
89 <link doc="ngx_http_core_module.xml" id="location_named">именованный location</link>. | |
90 В значении <value>uri</value> можно использовать переменные. | |
91 Если значение <value>uri</value> пустое, | |
92 то перенаправление не осуществляется. | |
93 </para> | |
94 | |
95 </directive> | |
96 | |
97 </section> | |
98 | |
99 </module> |