Поделиться через


Microsoft.Network FrontDoorWebApplicationFirewallPolicies 2018-08-01

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

Тип ресурса FrontDoorWebApplicationFirewallPolicies можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    customRules: {
      rules: [
        {
          action: 'string'
          matchConditions: [
            {
              matchValue: [
                'string'
              ]
              matchVariable: 'string'
              negateCondition: bool
              operator: 'string'
              selector: 'string'
            }
          ]
          name: 'string'
          priority: int
          rateLimitDurationInMinutes: int
          rateLimitThreshold: int
          ruleType: 'string'
          transforms: [
            'string'
          ]
        }
      ]
    }
    managedRules: {
      ruleSets: [
        {
          priority: int
          version: int
          ruleSetType: 'string'
          // For remaining properties, see ManagedRuleSet objects
        }
      ]
    }
    policySettings: {
      enabledState: 'string'
      mode: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты ManagedRuleSet

Задайте свойство ruleSetType, чтобы указать тип объекта.

Для AzureManagedRuleSetиспользуйте:

{
  ruleGroupOverrides: [
    {
      action: 'string'
      ruleGroupOverride: 'string'
    }
  ]
  ruleSetType: 'AzureManagedRuleSet'
}

Значения свойств

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Имя Описание Ценность
ETag Получает уникальную строку только для чтения, которая изменяется при обновлении ресурса. струна
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Максимальная длина = 128 (обязательно)
свойства Свойства политики брандмауэра веб-приложения. WebApplicationFirewallPolicyPropertiesFormat
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

AzureManagedOverrideRuleGroup

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
правилоПереопределение группы правил Описание переопределения группы правил "SqlInjection"
XSS (обязательно)

Набор правил AzureManagedRuleSet

Имя Описание Ценность
ruleGroupOverrides Список переопределения управляемого поставщика Azure (необязательно) AzureManagedOverrideRuleGroup[]
тип набора правил RuleSetType — AzureManagedRuleSet или наборы правил OWASP. AzureManagedRuleSet (обязательно)

Пользовательское правило

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
matchConditions Список условий соответствия MatchConditionAutoGenerated[] (обязательно)
имя Возвращает имя ресурса, уникального в политике. Это имя можно использовать для доступа к ресурсу. струна

Ограничения целостности:
Максимальная длина = 128
приоритет Описывает приоритет правила. Правила с более низким значением будут оцениваться перед правилами с более высоким значением. int (обязательно)
rateLimitDurationInMinutes Определяет длительность ограничения скорости. Значение по умолчанию — 1 минуту инт
rateLimitThreshold Определяет пороговое значение ограничения скорости инт
Тип правила Описание типа правила MatchRule
RateLimitRule (обязательный)
Преобразует Список преобразований Массив строк, содержащий любой из:
"HtmlEntityDecode"
Нижний регистр
RemoveNulls
"Обрезка"
"Верхний регистр"
UrlDecode
UrlEncode

Пользовательские правила

Имя Описание Ценность
Правила Список правил Пользовательское правило[]

ManagedRuleSet (УправляемыйНабор Правил)

Имя Описание Ценность
приоритет Описание приоритета правила инт
тип набора правил Установите значение "AzureManagedRuleSet" для типа AzureManagedRuleSet. AzureManagedRuleSet (обязательно)
Версия определяет версию набора правил инт

ManagedRuleSets (УправляемыеНаборы Правил)

Имя Описание Ценность
Наборы правил Список правил ManagedRuleSet[]

MatchConditionAutoGenerated

Имя Описание Ценность
matchValue Значение соответствия string[] (обязательно)
matchVariable Совпадать с переменной PostArgs
QueryString
RemoteAddr
"RequestBody"
"RequestHeader"
RequestMethod
RequestUri (обязательный)
negateCondition Описывает, является ли это неуготным условием или нет булевая переменная (bool)
оператор Описание соответствующего оператора "Любой"
BeginsWith
"Содержит"
"EndsWith"
"Равно"
"GeoMatch"
«Больше, чем»
«Больше, чем Или Равно»
"IPMatch"
"LessThan"
LessThanOrEqual (обязательный)
селектор Имя селектора в RequestHeader или RequestBody для сопоставления струна

PolicySettings (PolicySettings)

Имя Описание Ценность
enabledState описывает, включена ли политика в состоянии или отключенном состоянии. "Отключено"
"Включено"
режим Описание того, находится ли он в режиме обнаружения или режиме предотвращения на уровне политики "Обнаружение"
"Предотвращение"

Теги ресурса

Имя Описание Ценность

WebApplicationFirewallPolicyPropertiesFormat

Имя Описание Ценность
customRules Описание настраиваемых правил внутри политики Пользовательские правила
managedRules Описание управляемых правил внутри политики ManagedRuleSets (УправляемыеНаборы Правил)
настройки политики Описание policySettings для политики PolicySettings (PolicySettings)

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
политика брандмауэра веб-приложений Front Door (WAF) Модуль ресурсов AVM для политики брандмауэра веб-приложений Front Door (WAF)

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
Настройка управляемого waF defaultRuleSet для Azure Front Door Этот шаблон настраивает управляемый WAF defaultRuleSet для Azure Front Door
Front Door Premium с источником BLOB-объектов и приватным каналом Этот шаблон создает контейнер BLOB-объектов службы хранилища Azure Front Door premium и использует частную конечную точку для Front Door для отправки трафика в учетную запись хранения.
Front Door Premium с наборами правил, управляемыми Корпорацией Майкрософт, Этот шаблон создает Front Door Premium, включая брандмауэр веб-приложения с наборами правил защиты ботов, управляемых Корпорацией Майкрософт.
Front Door Standard/Premium с геофильтровкой Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с правилом геофильтрации.
Front Door Standard/Premium с ограничением скорости Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с правилом ограничения скорости.
Front Door Standard/Premium с WAF и пользовательским правилом Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с настраиваемым правилом.
Front Door с источниками BLOB-объектов для отправки Этот шаблон создает Front Door с источниками, маршрутами и наборами правил и учетными записями хранения Azure с контейнерами BLOB-объектов. Front Door отправляет трафик в учетные записи хранения при отправке файлов.
CDN FrontDoor с WAF, доменами и журналами в EventHub Этот шаблон создает новый профиль cdn Azure FrontDoor. Создайте WAF с настраиваемыми и управляемыми правилами, маршрутами cdn, источником и группами с их связью с WAF и маршрутами, настраивает настраиваемые домены, создает концентратор событий и параметры диагностики для отправки журналов доступа CDN с помощью концентратора событий.
приложение-функция , защищенное Azure Frontdoor Этот шаблон позволяет развернуть функцию Azure premium, защищенную и опубликованную Azure Frontdoor premium. Соединение между Azure Frontdoor и Функциями Azure защищено приватным каналом Azure.

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

Тип ресурса FrontDoorWebApplicationFirewallPolicies можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies",
  "apiVersion": "2018-08-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "customRules": {
      "rules": [
        {
          "action": "string",
          "matchConditions": [
            {
              "matchValue": [ "string" ],
              "matchVariable": "string",
              "negateCondition": "bool",
              "operator": "string",
              "selector": "string"
            }
          ],
          "name": "string",
          "priority": "int",
          "rateLimitDurationInMinutes": "int",
          "rateLimitThreshold": "int",
          "ruleType": "string",
          "transforms": [ "string" ]
        }
      ]
    },
    "managedRules": {
      "ruleSets": [ {
        "priority": "int",
        "version": "int",
        "ruleSetType": "string"
        // For remaining properties, see ManagedRuleSet objects
      } ]
    },
    "policySettings": {
      "enabledState": "string",
      "mode": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты ManagedRuleSet

Задайте свойство ruleSetType, чтобы указать тип объекта.

Для AzureManagedRuleSetиспользуйте:

{
  "ruleGroupOverrides": [
    {
      "action": "string",
      "ruleGroupOverride": "string"
    }
  ],
  "ruleSetType": "AzureManagedRuleSet"
}

Значения свойств

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Имя Описание Ценность
apiVersion Версия API '2018-08-01'
ETag Получает уникальную строку только для чтения, которая изменяется при обновлении ресурса. струна
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Максимальная длина = 128 (обязательно)
свойства Свойства политики брандмауэра веб-приложения. WebApplicationFirewallPolicyPropertiesFormat
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies"

AzureManagedOverrideRuleGroup

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
правилоПереопределение группы правил Описание переопределения группы правил "SqlInjection"
XSS (обязательно)

Набор правил AzureManagedRuleSet

Имя Описание Ценность
ruleGroupOverrides Список переопределения управляемого поставщика Azure (необязательно) AzureManagedOverrideRuleGroup[]
тип набора правил RuleSetType — AzureManagedRuleSet или наборы правил OWASP. AzureManagedRuleSet (обязательно)

Пользовательское правило

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
matchConditions Список условий соответствия MatchConditionAutoGenerated[] (обязательно)
имя Возвращает имя ресурса, уникального в политике. Это имя можно использовать для доступа к ресурсу. струна

Ограничения целостности:
Максимальная длина = 128
приоритет Описывает приоритет правила. Правила с более низким значением будут оцениваться перед правилами с более высоким значением. int (обязательно)
rateLimitDurationInMinutes Определяет длительность ограничения скорости. Значение по умолчанию — 1 минуту инт
rateLimitThreshold Определяет пороговое значение ограничения скорости инт
Тип правила Описание типа правила MatchRule
RateLimitRule (обязательный)
Преобразует Список преобразований Массив строк, содержащий любой из:
"HtmlEntityDecode"
Нижний регистр
RemoveNulls
"Обрезка"
"Верхний регистр"
UrlDecode
UrlEncode

Пользовательские правила

Имя Описание Ценность
Правила Список правил Пользовательское правило[]

ManagedRuleSet (УправляемыйНабор Правил)

Имя Описание Ценность
приоритет Описание приоритета правила инт
тип набора правил Установите значение "AzureManagedRuleSet" для типа AzureManagedRuleSet. AzureManagedRuleSet (обязательно)
Версия определяет версию набора правил инт

ManagedRuleSets (УправляемыеНаборы Правил)

Имя Описание Ценность
Наборы правил Список правил ManagedRuleSet[]

MatchConditionAutoGenerated

Имя Описание Ценность
matchValue Значение соответствия string[] (обязательно)
matchVariable Совпадать с переменной PostArgs
QueryString
RemoteAddr
"RequestBody"
"RequestHeader"
RequestMethod
RequestUri (обязательный)
negateCondition Описывает, является ли это неуготным условием или нет булевая переменная (bool)
оператор Описание соответствующего оператора "Любой"
BeginsWith
"Содержит"
"EndsWith"
"Равно"
"GeoMatch"
«Больше, чем»
«Больше, чем Или Равно»
"IPMatch"
"LessThan"
LessThanOrEqual (обязательный)
селектор Имя селектора в RequestHeader или RequestBody для сопоставления струна

PolicySettings (PolicySettings)

Имя Описание Ценность
enabledState описывает, включена ли политика в состоянии или отключенном состоянии. "Отключено"
"Включено"
режим Описание того, находится ли он в режиме обнаружения или режиме предотвращения на уровне политики "Обнаружение"
"Предотвращение"

Теги ресурса

Имя Описание Ценность

WebApplicationFirewallPolicyPropertiesFormat

Имя Описание Ценность
customRules Описание настраиваемых правил внутри политики Пользовательские правила
managedRules Описание управляемых правил внутри политики ManagedRuleSets (УправляемыеНаборы Правил)
настройки политики Описание policySettings для политики PolicySettings (PolicySettings)

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
Настройка ограничения IP-адресов клиента WAF для Azure Front Door

развертывание в Azure
Этот шаблон настраивает ограничение IP-адресов клиента WAF для конечной точки Azure Front Door
Настройка управляемого waF defaultRuleSet для Azure Front Door

развертывание в Azure
Этот шаблон настраивает управляемый WAF defaultRuleSet для Azure Front Door
Настройка правила листик скорости WAF для конечной точки Azure Front Door

развертывание в Azure
Этот шаблон настраивает правило WAF для Azure Front Door для ограничения входящего трафика для данного внешнего узла.
Настройка правил WAF с параметрами HTTP для Front Door

развертывание в Azure
Этот шаблон настраивает пользовательские правила WAF на основе определенных параметров HTTP для конечной точки Azure Front Door.
создание Azure Front Door перед управления API Azure

развертывание в Azure
В этом примере показано, как использовать Azure Front Door в качестве глобальной подсистемы балансировки нагрузки перед управлением API Azure.
Создание правила геофильтрации WAF для конечной точки Azure Front Door

развертывание в Azure
Этот шаблон создает правило геофильтрации WAF для Azure Front Door, которое разрешает или блокирует трафик из определенных стран.
Front Door Premium с источником BLOB-объектов и приватным каналом

развертывание в Azure
Этот шаблон создает контейнер BLOB-объектов службы хранилища Azure Front Door premium и использует частную конечную точку для Front Door для отправки трафика в учетную запись хранения.
Front Door Premium с наборами правил, управляемыми Корпорацией Майкрософт,

развертывание в Azure
Этот шаблон создает Front Door Premium, включая брандмауэр веб-приложения с наборами правил защиты ботов, управляемых Корпорацией Майкрософт.
Front Door Standard/Premium с геофильтровкой

развертывание в Azure
Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с правилом геофильтрации.
Front Door Standard/Premium с ограничением скорости

развертывание в Azure
Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с правилом ограничения скорости.
Front Door Standard/Premium с WAF и пользовательским правилом

развертывание в Azure
Этот шаблон создает Front Door Standard/Premium, включая брандмауэр веб-приложения с настраиваемым правилом.
Front Door с источниками BLOB-объектов для отправки

развертывание в Azure
Этот шаблон создает Front Door с источниками, маршрутами и наборами правил и учетными записями хранения Azure с контейнерами BLOB-объектов. Front Door отправляет трафик в учетные записи хранения при отправке файлов.
CDN FrontDoor с WAF, доменами и журналами в EventHub

развертывание в Azure
Этот шаблон создает новый профиль cdn Azure FrontDoor. Создайте WAF с настраиваемыми и управляемыми правилами, маршрутами cdn, источником и группами с их связью с WAF и маршрутами, настраивает настраиваемые домены, создает концентратор событий и параметры диагностики для отправки журналов доступа CDN с помощью концентратора событий.
приложение-функция , защищенное Azure Frontdoor

развертывание в Azure
Этот шаблон позволяет развернуть функцию Azure premium, защищенную и опубликованную Azure Frontdoor premium. Соединение между Azure Frontdoor и Функциями Azure защищено приватным каналом Azure.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса FrontDoorWebApplicationFirewallPolicies можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    etag = "string"
    properties = {
      customRules = {
        rules = [
          {
            action = "string"
            matchConditions = [
              {
                matchValue = [
                  "string"
                ]
                matchVariable = "string"
                negateCondition = bool
                operator = "string"
                selector = "string"
              }
            ]
            name = "string"
            priority = int
            rateLimitDurationInMinutes = int
            rateLimitThreshold = int
            ruleType = "string"
            transforms = [
              "string"
            ]
          }
        ]
      }
      managedRules = {
        ruleSets = [
          {
            priority = int
            version = int
            ruleSetType = "string"
            // For remaining properties, see ManagedRuleSet objects
          }
        ]
      }
      policySettings = {
        enabledState = "string"
        mode = "string"
      }
    }
  }
}

Объекты ManagedRuleSet

Задайте свойство ruleSetType, чтобы указать тип объекта.

Для AzureManagedRuleSetиспользуйте:

{
  ruleGroupOverrides = [
    {
      action = "string"
      ruleGroupOverride = "string"
    }
  ]
  ruleSetType = "AzureManagedRuleSet"
}

Значения свойств

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Имя Описание Ценность
ETag Получает уникальную строку только для чтения, которая изменяется при обновлении ресурса. струна
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Максимальная длина = 128 (обязательно)
свойства Свойства политики брандмауэра веб-приложения. WebApplicationFirewallPolicyPropertiesFormat
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01"

AzureManagedOverrideRuleGroup

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
правилоПереопределение группы правил Описание переопределения группы правил "SqlInjection"
XSS (обязательно)

Набор правил AzureManagedRuleSet

Имя Описание Ценность
ruleGroupOverrides Список переопределения управляемого поставщика Azure (необязательно) AzureManagedOverrideRuleGroup[]
тип набора правил RuleSetType — AzureManagedRuleSet или наборы правил OWASP. AzureManagedRuleSet (обязательно)

Пользовательское правило

Имя Описание Ценность
действие Тип действий "Разрешить"
"Блокировать"
Log (обязательно)
matchConditions Список условий соответствия MatchConditionAutoGenerated[] (обязательно)
имя Возвращает имя ресурса, уникального в политике. Это имя можно использовать для доступа к ресурсу. струна

Ограничения целостности:
Максимальная длина = 128
приоритет Описывает приоритет правила. Правила с более низким значением будут оцениваться перед правилами с более высоким значением. int (обязательно)
rateLimitDurationInMinutes Определяет длительность ограничения скорости. Значение по умолчанию — 1 минуту инт
rateLimitThreshold Определяет пороговое значение ограничения скорости инт
Тип правила Описание типа правила MatchRule
RateLimitRule (обязательный)
Преобразует Список преобразований Массив строк, содержащий любой из:
"HtmlEntityDecode"
Нижний регистр
RemoveNulls
"Обрезка"
"Верхний регистр"
UrlDecode
UrlEncode

Пользовательские правила

Имя Описание Ценность
Правила Список правил Пользовательское правило[]

ManagedRuleSet (УправляемыйНабор Правил)

Имя Описание Ценность
приоритет Описание приоритета правила инт
тип набора правил Установите значение "AzureManagedRuleSet" для типа AzureManagedRuleSet. AzureManagedRuleSet (обязательно)
Версия определяет версию набора правил инт

ManagedRuleSets (УправляемыеНаборы Правил)

Имя Описание Ценность
Наборы правил Список правил ManagedRuleSet[]

MatchConditionAutoGenerated

Имя Описание Ценность
matchValue Значение соответствия string[] (обязательно)
matchVariable Совпадать с переменной PostArgs
QueryString
RemoteAddr
"RequestBody"
"RequestHeader"
RequestMethod
RequestUri (обязательный)
negateCondition Описывает, является ли это неуготным условием или нет булевая переменная (bool)
оператор Описание соответствующего оператора "Любой"
BeginsWith
"Содержит"
"EndsWith"
"Равно"
"GeoMatch"
«Больше, чем»
«Больше, чем Или Равно»
"IPMatch"
"LessThan"
LessThanOrEqual (обязательный)
селектор Имя селектора в RequestHeader или RequestBody для сопоставления струна

PolicySettings (PolicySettings)

Имя Описание Ценность
enabledState описывает, включена ли политика в состоянии или отключенном состоянии. "Отключено"
"Включено"
режим Описание того, находится ли он в режиме обнаружения или режиме предотвращения на уровне политики "Обнаружение"
"Предотвращение"

Теги ресурса

Имя Описание Ценность

WebApplicationFirewallPolicyPropertiesFormat

Имя Описание Ценность
customRules Описание настраиваемых правил внутри политики Пользовательские правила
managedRules Описание управляемых правил внутри политики ManagedRuleSets (УправляемыеНаборы Правил)
настройки политики Описание policySettings для политики PolicySettings (PolicySettings)

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
политика брандмауэра веб-приложений Front Door (WAF) Модуль ресурсов AVM для политики брандмауэра веб-приложений Front Door (WAF)