Mercurial > hg > nginx-site
changeset 356:ccb8e9a12e2f
Revision.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Wed, 25 Jan 2012 13:57:12 +0000 |
parents | 5d731825a6c2 |
children | 3d6c27e22625 |
files | xml/ru/docs/http/ngx_http_referer_module.xml |
diffstat | 1 files changed, 55 insertions(+), 45 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_referer_module.xml Wed Jan 25 13:34:17 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_referer_module.xml Wed Jan 25 13:57:12 2012 +0000 @@ -2,44 +2,46 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_referer_module" +<module name="Модуль ngx_http_referer_module" link="/ru/docs/http/ngx_http_referer_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_referer_module позволяет блокировать доступ -к сайту с неверными значениями строки "Referer" в заголовке запроса. -Следует иметь в виду, что подделать запрос с нужной строкой "Referer" -не составляет большого труда, поэтому цель использования данного модуля -заключается не в стопроцентном блокировании подобных запросов, -а в блокировании массового потока запросов, сделанных обычными браузерами. -Нужно также учитывать, что обычные браузеры могут не передавать строку -"Referer" даже для верных запросов. +Модуль <literal>ngx_http_referer_module</literal> позволяет блокировать доступ +к сайту для запросов с неверными значениями поля <header>Referer</header> в +заголовке. +Следует иметь в виду, что подделать запрос с нужным значением поля +<header>Referer</header> не составляет большого труда, поэтому цель +использования данного модуля заключается не в стопроцентном блокировании +подобных запросов, а в блокировании массового потока запросов, сделанных +обычными браузерами. +Нужно также учитывать, что обычные браузеры могут не передавать поле +<header>Referer</header> даже для верных запросов. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> - valid_referers none blocked server_names - *.example.com www.example.info/galleries/ - ~\.google\. ; +valid_referers none blocked server_names + *.example.com example.* www.example.info/galleries/ + ~\.google\.; - if ($invalid_referer) { - return 403; - } +if ($invalid_referer) { + return 403; +} </example> </para> </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="valid_referers"> <syntax> @@ -49,53 +51,61 @@ <value>строка</value> ...</syntax> <default/> -<context>server, location</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт значения строки "Referer" в заголовке запроса, при -которых встроенная переменная $invalid_referer будет иметь значение 0. +Задаёт значения поля <header>Referer</header> заголовка запроса, при +которых встроенная переменная <var>$invalid_referer</var> будет иметь +значение 0. </para> <para> Параметры могут быть следующие: -<list type="bullet"> +<list type="tag"> -<listitem> -none — строка "Referer" в заголовке запроса отсутствует; -</listitem> +<tag-name><literal>none</literal></tag-name> +<tag-desc> +поле <header>Referer</header> в заголовке запроса отсутствует; +</tag-desc> -<listitem> -blocked — строка "Referer" в заголовке запроса присутствует, -но её значение удалено файрволлом или прокси-сервером; к таким строкам -относятся строки, неначинающиеся на "http://"; -</listitem> +<tag-name><literal>blocked</literal></tag-name> +<tag-desc> +поле <header>Referer</header> в заголовке запроса присутствует, +но его значение удалено межсетевым экраном (firewall) или прокси-сервером; +к таким значениям относятся строки, не начинающиеся на +“<literal>http://</literal>”; +</tag-desc> -<listitem> -server_names — в строке "Referer" в заголовке запроса указано одно +<tag-name><literal>server_names</literal></tag-name> +<tag-desc> +в поле <header>Referer</header> заголовка запроса указано одно из имён сервера; -</listitem> +</tag-desc> -<listitem> -произвольная строка — задаёт имя сервера и необязательное начало URI. -В начале или конце имени сервера может быть "*". -При проверке порт сервера в строке "Referer" игнорируется. -</listitem> +<tag-name>произвольная строка</tag-name> +<tag-desc> +задаёт имя сервера и необязательное начало URI. +В начале или конце имени сервера может быть “<literal>*</literal>”. +При проверке порт сервера в поле <header>Referer</header> игнорируется; +</tag-desc> -<listitem> -регулярное выражение — в начале должен быть символ "~". +<tag-name>регулярное выражение</tag-name> +<tag-desc> +в начале должен быть символ “<literal>~</literal>”. Необходимо учитывать, что на совпадение с выражением будет проверяться -текст, начинающийся после "http://". -</listitem> +текст, начинающийся после “<literal>http://</literal>”. +</tag-desc> </list> </para> <para> -Пример использования: +Пример: <example> - valid_referers none blocked server_names - *.example.com example.* www.example.info/galleries/ - ~\.google\. ; +valid_referers none blocked server_names + *.example.com example.* www.example.info/galleries/ + ~\.google\.; </example> </para>