Обратный прокси-сервер с переопределением URL-адресов версии 2 и маршрутизацией запросов приложений

Статья
07/19/2023

В этом пошаговом руководстве описано, как использовать модуль переопределения URL-адресов и маршрутизацию запросов приложений (ARR) для реализации обратного прокси-сервера для нескольких внутренних приложений.

Предварительные требования

Чтобы выполнить это пошаговое руководство, вам потребуется следующее:

IIS 7 или более поздней версии с включенной службой ASP.NET роли.
Установленный модуль переопределения URL-адресов (требуется версия 2.0, если вы хотите выполнить часть о перезаписи ответа)
Установлена маршрутизация запросов приложений версии 1.0 или 2.0

Введение

С помощью модуля переопределения URL-адресов и маршрутизации запросов приложений можно реализовать сложные и гибкие конфигурации балансировки нагрузки и обратного прокси-сервера. Очень распространенный сценарий обратного прокси-сервера — сделать несколько внутренних веб-приложений доступными через Интернет. Веб-сервер, доступный через Интернет, используется в качестве сервера обратного прокси-сервера, который получает веб-запросы, а затем пересылает их нескольким приложениям интрасети для обработки. На следующем рисунке показана типичная конфигурация для сценария обратного прокси-сервера:

При условии, что сервер ARR имеет доменное имя http://contoso.com, каждое веб-приложение можно получить с помощью следующих URL-адресов:

http://contoso.com/webmail/
http://contoso.com/payroll/

Когда выполняется запрос к http://contoso.com/webmail/default.aspx, ARR перенаправит эти запросы на внутренний сервер, используя URL-адрес http://webmail/default.aspx. Аналогичным образом запросы к http://contoso.com/payroll/ перенаправляются в http://payroll/default.aspx.

Кроме того, если внутреннее приложение вставляет ссылки в HTML-код ответа, которые ссылаются на другие части этих приложений, эти ссылки следует изменить до возврата ответа клиенту. Например, страница из http://webmail/default.aspx может содержать такую ссылку:

<a href="/default.aspx?id=1">link</a>

Затем сервер ARR должен изменить эту ссылку на следующую:

<a href="/webmail/default.aspx?id=1">link</a>

Создание примеров веб-сайтов

Для простоты сценарий обратного прокси-сервера, с которым вы будете работать в этом пошаговом руководстве, будет реализован на одном сервере, при этом iis "веб-сайт по умолчанию" выступает в качестве сайта обратного прокси-сервера, а приложения веб-почты и зарплаты размещены на разных веб-сайтах IIS на одном сервере.

Чтобы создать примеры веб-сайтов, выполните следующие действия.

Создайте две папки с именами "webmail" и "payroll" в следующей папке:
```
%SystemDrive%\inetpub\ folder.
```
Создайте два веб-сайта IIS с именами "webmail" и "payroll", которые указывают на соответствующие папки в разделе %SystemDrive%\inetpub\. Используйте разные IP-порты для каждого сайта.
Для создания сайтов можно использовать следующие команды:
```
%windir%\System32\inetsrv\appcmd.exe add site /name:"webmail" /bindings:http/*:8081: /physicalPath:"%SystemDrive%\inetpub\webmail"

%windir%\System32\inetsrv\appcmd.exe add site /name:"payroll" /bindings:http/*:8082: /physicalPath:"%SystemDrive%\inetpub\payroll"
```
Создайте файл с именем default.aspx в следующей папке:
```
%SystemDrive%\inetpub\webmail
```

Скопируйте следующую разметку ASP.NET, вставьте ее в файл и сохраните файл:

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Reverse Proxy Test - WebMail Application</title>
</head>
<body>
    <h1>Reverse Proxy Test Page - WebMail Application</h1>
    <p>Requested URL path is <%= Request.ServerVariables["SCRIPT_NAME"] %><p>
    <p><a href="<%= Request.ServerVariables["SCRIPT_NAME"] %>">Here</a> is the link to this page.</p>
</body>
</html>

Создайте файл с именем default.aspx в следующей папке:
```
%SystemDrive%\inetpub\payroll
```

Скопируйте следующую разметку ASP.NET, вставьте ее в файл и сохраните файл:

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Reverse Proxy Test - Payroll Application</title>
</head>
<body>
    <h1>Reverse Proxy Test Page - Payroll Application</h1>
    <p>Requested URL path is <%= Request.ServerVariables["SCRIPT_NAME"] %><p>
    <p><a href="<%= Request.ServerVariables["SCRIPT_NAME"] %>">Here</a> is the link to this page.</p>
</body>
</html>

Чтобы убедиться, что сайты работают правильно, откройте веб-страницу и запросите следующие URL-адреса:
```
http://localhost:8081/default.aspx
```
```
http://localhost:8082/default.aspx
```

Настройка правил для обратного прокси-сервера

В этом разделе пошагового руководства вы настроите функции обратного прокси-сервера для работы с созданными примерами веб-сайтов.

Включение функции обратного прокси-сервера

Функция обратного прокси-сервера отключена по умолчанию, поэтому ее необходимо начать с включения.

Открытие диспетчера IIS
Выберите узел сервера в представлении в виде дерева слева и щелкните функцию "Маршрутизация запросов приложений".
Установите флажок "Включить прокси-сервер" проверка. Оставьте значения по умолчанию для всех остальных параметров на этой странице:

Создание правила для приложения веб-почты

Вы создадите два правила перезаписи:

Правило переопределения, которое будет выполнять прокси-запрос к приложению webmail при http://localhost:8081/ условии, что запрошенный URL-путь начинается с "webmail".
Правило перезаписи, которое будет выполнять прокси-запрос к приложению для расчета заработной платы до http://localhost:8082/ тех пор, пока запрошенный URL-адрес начинается с "payroll".

Чтобы добавить правила перезаписи обратного прокси-сервера, выполните следующие действия.

Откройте файлweb.config , расположенный в следующем расположении:
```
%SystemDrive%\inetpub\wwwroot\
```

В элементе /configuration/system.webServer добавьте следующее, а затем сохраните файл:

<rewrite>
    <rules>
        <rule name="Reverse Proxy to webmail" stopProcessing="true">
            <match url="^webmail/(.*)" />
            <action type="Rewrite" url="http://localhost:8081/{R:1}" />
        </rule>
        <rule name="Reverse Proxy to payroll" stopProcessing="true">
            <match url="^payroll/(.*)" />
            <action type="Rewrite" url="http://localhost:8082/{R:1}" />
        </rule>
    </rules>
</rewrite>

Дополнительные сведения о создании правил перезаписи см. в статье Создание правил переопределения для модуля переопределения URL-адресов.

Тестирование функции обратного прокси-сервера

Откройте веб-браузер и отправьте запрос к http://localhost/webmail/default.aspx. Вы должны увидеть ответ на тестовой странице веб-почты. Кроме того, сделайте запрос к http://localhost/payroll/default.aspx. Вы должны увидеть ответ на странице тестирования заработной платы.

Обратите внимание, что в обоих случаях ссылка внутри ответа указывает на http://localhost/default.aspx. Если щелкнуть эту ссылку, сервер получит ответ 404 (файл не найден). В следующем разделе вы узнаете, как создать правило для исходящего трафика для исправления связей HTML-кода ответа, созданного приложением.

Настройка правил для перезаписи ответов

Этот раздел документации относится к модулю переопределения URL-адресов версии 2.0 для IIS 7.

Вы определите правило для исходящего трафика, которое заменит все ссылки в HTML-коде ответа следующим образом:

<a href="/default.aspx">...</a>

будет заменен на:

<a href="/webmail/default.aspx">...</a>

(если ответ получен из приложения веб-почты)

<a href="/payroll/default.aspx">...</a>

(если ответ получен из приложения для расчета заработной платы)

Предупреждение

При изменении заголовков ответов или содержимого ответа с помощью правила исходящего перезаписи следует соблюдать дополнительную осторожность, чтобы убедиться, что текст, который вставляется в ответ, не содержит исполняемый код на стороне клиента, что может привести к уязвимостям межсайтовых сценариев. Это особенно важно, если правило перезаписи использует ненадежные данные, такие как заголовки HTTP или строка запроса, для создания строки, которая будет вставлена в HTTP-ответ. В таких случаях строка замены должна быть закодирована с помощью функции HtmlEncode , например:

<action type="Rewrite" value="{HtmlEncode:{HTTP_REFERER}}" />

Чтобы создать правило, выполните следующие действия.

Перейти к диспетчеру IIS
Выберите "Веб-сайт по умолчанию"
В представлении функций щелкните "Переопределение URL-адреса".
В области Действия справа щелкните "Добавить правила...". В диалоговом окне "Добавление правил" выберите "Пустое правило" в категории "Правила для исходящего трафика" и нажмите кнопку ОК:

Теперь необходимо определить фактическое правило для исходящего трафика. В модуле переопределения URL-адресов 2.0 правило перезаписи исходящего трафика определяется путем указания следующих сведений:

Имя правила.
Необязательное условие, определяющее, следует ли применять это правило к ответу.
Шаблон, используемый для сопоставления строки в ответе.
Необязательный набор условий.
Действие, выполняемое при совпадении шаблона и успешном выполнении всех проверок условий.

Именование правила

В текстовом поле "Имя" введите имя, которое будет однозначно определять правило, например"Добавить префикс приложения".

Определение условия

Предварительное условие используется для оценки того, следует ли выполнять оценку правил для исходящего трафика в ответе. Например, если правило изменяет html-содержимое, следует оценивать только HTTP-ответы с заголовком типа контента, для которого задано значение "text/html". Оценка исходящих правил и перезапись содержимого — это ресурсоемкая операция, которая может негативно повлиять на производительность веб-приложения. Поэтому используйте предварительные условия, чтобы сузить случаи применения правил исходящего трафика.

Так как создаваемое правило должно применяться только к HTML-ответам, вы определите условие, которое проверяет, эквивалентен ли тип содержимого заголовка HTTP-ответа "text/html".

Чтобы определить условие, выполните следующие действия.

В списке Предварительные условия выберите "<Создать новое предварительное условие...>".
Откроется диалоговое окно редактора предварительных условий, где необходимо определить условие. Укажите параметры предварительных условий следующим образом:
- Имя: "IsHTML"
- Использование регулярных выражений
- Нажмите кнопку "Добавить", чтобы открыть диалоговое окно "Добавить условие". В этом диалоговом окне укажите:
  - Входные данные условия: "{RESPONSE_CONTENT_TYPE}"
  - Проверьте, соответствует ли входная строка : "Соответствует шаблону"
  - Шаблон: "^text/html"
Нажмите кнопку ОК, чтобы сохранить предварительное условие и вернуться на страницу "Изменение правила".

Определение соответствующего область

Правило перезаписи для исходящего трафика может работать с содержимым заголовка HTTP или с содержимым текста ответа. Это правило должно заменить ссылки в содержимом ответа, поэтому в раскрывающемся списке "Область сопоставления" выберите "Ответ".

Определение фильтра тегов

Фильтры тегов используются для область сопоставления шаблонов только с определенными элементами HTML, а не для оценки всего ответа по шаблону правила. Сопоставление шаблонов — это очень ресурсоемкая операция, и если весь ответ вычисляется по шаблону, это может значительно замедлить время отклика веб-приложения. Фильтры тегов позволяют указать, что сопоставление шаблонов должно применяться только в содержимом определенных html-тегов, что значительно сокращает объем данных, которые необходимо оценить по шаблону регулярного выражения.

Чтобы определить фильтр тегов, разверните раскрывающийся список "Соответствие содержимого в: ", а затем выберите и проверка поле проверка "A (атрибут href)".

Это задает правило для применения шаблона только к значению атрибута href гиперссылки, как показано в следующем примере:

<a href="this string will be used for pattern matching">Some link</a>

Определение шаблона

В текстовом поле "Шаблон" введите следующую строку:

^/(.*)

Эта строка является регулярным выражением, которое указывает, что шаблон будет соответствовать любой строке URL-пути, начинающейся с символа "/".

Обратите внимание на использование круглых скобок в шаблоне. Эти круглые скобки создают группу отслеживания, на которую позже можно ссылаться в правиле с помощью обратных ссылок.

Определение условия

Вам нужно изменять ссылки в HTML-коде ответа, только если ответ получен из веб-почты или приложения для расчета заработной платы. Чтобы проверка, что вы будете использовать условие, которое анализирует путь URL-адреса, запрошенный клиентом. Кроме того, вы определите шаблон условия, который записывает папку приложения из запрошенного URL-адреса, чтобы правило могло повторно использовать его при перезаписи ссылок в ответе.

Разверните поле группы условия.
Нажмите кнопку "Добавить..." чтобы открыть диалоговое окно для определения условий.
Для параметра "Condition input:" введите эту строку: "{URL}". Модуль переопределения URL-адресов настраивается для использования URL-пути, запрошенного веб-клиентом.
В раскрывающемся списке выберите "Соответствует шаблону".
Введите ^/(webmail|payroll)/.* в текстовое поле Шаблон . Это регулярное выражение используется для сопоставления URL-путей, которые начинаются с /webmail или /payroll. Круглые скобки в шаблоне захватывают часть совпадающей строки URL-адреса, чтобы ее можно было использовать при создании замещающего URL-адреса.
Нажмите кнопку ОК, чтобы сохранить условие и вернуться к пользовательскому интерфейсу "Добавить правило".

Определение действия

Выберите тип действия "Перезаписать", указанный в поле группы "Действие". В текстовом поле "Значение" введите следующую строку:

/{C:1}/{R:1}

Эта строка задает новое значение, на которое необходимо переписать адрес ссылки. {C:1} является обратной ссылкой на группу отслеживания шаблонов условий, и она будет заменена строками "webmail" или "payroll". {R:1} является обратной ссылкой на группу отслеживания шаблонов правил, и в этом конкретном случае она будет заменена исходным URL-путем, который использовался в гиперссылке.

Оставьте значения по умолчанию для всех остальных параметров. Страница свойств "Изменить правило исходящего трафика" должна выглядеть следующим образом:

Сохраните правило, щелкнув действие "Применить" справа.

Чтобы проверка конфигурацию только что созданных правил, откройте файл web.config, расположенный в %SystemDrive%\inetput\wwwroot\. В этом файле вы увидите <rewrite> раздел, содержащий это определение правила:

<rewrite>
    <rules>
        <rule name="Reverse Proxy to webmail" stopProcessing="true">
            <match url="^webmail/(.*)" />
            <action type="Rewrite" url="http://localhost:8081/{R:1}" />
        </rule>
        <rule name="Reverse Proxy to payroll" stopProcessing="true">
            <match url="^payroll/(.*)" />
            <action type="Rewrite" url="http://localhost:8082/{R:1}" />
        </rule>
    </rules>
    <outboundRules>
        <rule name="Add application prefix" preCondition="IsHTML">
            <match filterByTags="A" pattern="^/(.*)" />
            <conditions>
                <add input="{URL}" pattern="^/(webmail|payroll)/.*" />
            </conditions>
            <action type="Rewrite" value="/{C:1}/{R:1}" />
        </rule>
        <preConditions>
            <preCondition name="IsHTML">
                <add input="{RESPONSE_CONTENT_TYPE}" pattern="^text/html" />
            </preCondition>
        </preConditions>
    </outboundRules>
</rewrite>

Тестирование правила

Чтобы проверить, правильно ли правило перезаписывает URL-адреса в ответе, откройте веб-браузер и отправьте запрос к http://localhost/webmail/default.aspx или http://localhost/payroll/default.aspx. Вы увидите, что правило перезаписи для исходящего трафика изменило ссылку в HTML-ответе:

Итоги

В этом пошаговом руководстве вы узнали, как настроить модуль перезаписи URL-адресов и маршрутизацию запросов приложений для реализации сценария обратного прокси-сервера. Кроме того, вы узнали, как использовать новую функцию исходящего перезаписи модуля переопределения URL-адресов 2.0 для исправления ссылок в ответах приложений перед их обслуживанием веб-клиенту.

Обратите внимание, что при использовании обратного прокси-сервера часто также требуется перезаписать заголовки HTTP-ответа. Сведения о том, как использовать модуль переопределения URL-адресов 2.0 для изменения заголовка HTTP ответа, см. в статье Изменение заголовков ответа HTTP.

Обратный прокси-сервер с переопределением URL-адресов версии 2 и маршрутизацией запросов приложений

Предварительные требования

Введение

Создание примеров веб-сайтов

Настройка правил для обратного прокси-сервера

Включение функции обратного прокси-сервера

Создание правила для приложения веб-почты

Тестирование функции обратного прокси-сервера

Настройка правил для перезаписи ответов

Именование правила

Определение условия

Определение соответствующего область

Определение фильтра тегов

Определение шаблона

Определение условия

Определение действия

Тестирование правила

Итоги

Обратная связь

Обратная связь

Дополнительные ресурсы