Учебное пособие: Настройка обработчика правил

Область применения: ✔️ Front Door (классическая модель)

В этом руководстве показано, как создать конфигурацию движка правил и первое правило в портале Azure и CLI.

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

Prerequisites

• Прежде чем выполнить действия, описанные в этом руководстве, необходимо сначала создать Azure Front Door (классическую). Дополнительные сведения см. в статье "Создание Azure Front Door (классическая модель)".

Настройка обработчика правил на портале Azure

1. В вашем ресурсе Azure Front Door (классический) выберите конфигурация Rule Engine в разделе Settings в меню слева. Выберите +Добавить, введите имя конфигурации и начните создавать первую конфигурацию обработчика правил.

2. Введите имя первого правила. Затем нажмите кнопку +Добавить условие или +Добавить действие , чтобы определить правило.

   Note

   • Чтобы удалить условие или действие из правила, используйте значок корзины справа от конкретного условия или действия.
   • Чтобы создать правило, которое применяется ко всему входящему трафику, не указывайте никаких условий.
   • Чтобы отключить обработку правил после выполнения первого условия соответствия, установите флажок Остановить оценку оставшихся правил. Если это условие выполнено, остальные правила в конфигурации не выполняются.
   • Все пути в конфигурации обработчика правил чувствительны к регистру.
   • Имена заголовков должны соответствовать стандарту RFC 7230.

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

   Tip

   Если вы хотите проверить, когда изменения распространяются на Azure Front Door (классическая модель), можно создать пользовательский заголовок ответа в правиле, используя следующий пример. Вы можете добавить заголовок _X-<RuleName>-Version_ ответа и изменить значение при каждом обновлении правила.

   После обновления изменений можно перейти по URL-адресу, чтобы подтвердить вызываемую версию правила:

4. При создании одного или нескольких правил нажмите кнопку "Сохранить". Это действие создает конфигурацию подсистемы правил.

5. После создания конфигурации обработчика правил свяжите конфигурацию с правилом маршрутизации. Вы можете применить одну конфигурацию к нескольким правилам маршрутизации, но правило маршрутизации может иметь только одну конфигурацию подсистемы правил. Чтобы связать конфигурацию, перейдите в конструктор Azure Front Door (классическая модель) и выберите маршрут. Затем выберите конфигурацию обработчика правил, чтобы связаться с правилом маршрутизации.

   

Настройка обработчика правил в Azure CLI

1. Установите Azure CLI и добавьте расширение front-door:

   az extension add --name front-door
   

   Войдите и переключитесь на подписку:

   az account set --subscription <name_or_Id>
   

2. Создайте обработчик правил с одним правилом, включая действие на основе заголовков и условие соответствия:

   az network front-door rules-engine rule create -f {front_door} -g {resource_group} --rules-engine-name {rules_engine} --name {rule1} --priority 1 --action-type RequestHeader --header-action Overwrite --header-name Rewrite --header-value True --match-variable RequestFilenameExtension --operator Contains --match-values jpg png --transforms Lowercase
   

3. Список всех правил:

   az network front-door rules-engine rule list -f {front_door} -g {rg} --name {rules_engine}
   

4. Добавьте действие для изменения маршрута перенаправления.

   az network front-door rules-engine rule action add -f {front_door} -g {rg} --rules-engine-name {rules_engine} --name {rule1} --action-type ForwardRouteOverride --backend-pool {backend_pool_name} --caching Disabled
   

5. Перечислить все действия в правиле:

   az network front-door rules-engine rule action list -f {front_door} -g {rg} -r {rules_engine} --name {rule1}
   

6. Связывание конфигурации обработчика правил с правилом маршрутизации:

   az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --rules-engine {rules_engine}
   

7. Отмена связи подсистемы правил:

   az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine
   

Чтобы получить больше информации, см. полный список команд движка правил Azure Front Door (классическая модель).

Очистка ресурсов

Чтобы удалить конфигурацию обработчика правил из Front Door (классической):

1. Выберите три точки рядом с именем обработчика правил, а затем выберите "Связать правило маршрутизации ", чтобы отсоединить все правила маршрутизации от конфигурации подсистемы правил:

2. Снимите флажок всех правил маршрутизации, связанных с этой конфигурацией ядра правил, и нажмите кнопку "Сохранить".

3. Удалите конфигурацию обработчика правил из Front Door:

   

Дальнейшие шаги

Из этого руководства вы узнали, как:

• Создание конфигурации движка правил
• Связывание конфигурации с правилом маршрутизации

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