Microsoft.Network ApplicationGatewayWebApplicationFirewallPolicies 2021-02-01
Определение ресурса Bicep
Тип ресурса ApplicationGatewayWebApplicationFirewallPolicies можно развернуть с помощью операций, предназначенных для:
- Группы ресурсов — см. команды развертывания групп ресурсов.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2021-02-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
customRules: [
{
action: 'string'
matchConditions: [
{
matchValues: [
'string'
]
matchVariables: [
{
selector: 'string'
variableName: 'string'
}
]
negationConditon: bool
operator: 'string'
transforms: [
'string'
]
}
]
name: 'string'
priority: int
ruleType: 'string'
}
]
managedRules: {
exclusions: [
{
matchVariable: 'string'
selector: 'string'
selectorMatchOperator: 'string'
}
]
managedRuleSets: [
{
ruleGroupOverrides: [
{
ruleGroupName: 'string'
rules: [
{
ruleId: 'string'
state: 'Disabled'
}
]
}
]
ruleSetType: 'string'
ruleSetVersion: 'string'
}
]
}
policySettings: {
fileUploadLimitInMb: int
maxRequestBodySizeInKb: int
mode: 'string'
requestBodyCheck: bool
state: 'string'
}
}
}
Значения свойств
ApplicationGatewayWebApplicationFirewallPolicies
Имя | Описание | Значение |
---|---|---|
name | имя ресурса. | string (обязательно) |
location | Расположение ресурса. | строка |
tags | Теги ресурсов. | Словарь имен и значений тегов. См . раздел Теги в шаблонах |
properties | Свойства политики брандмауэра веб-приложения. | WebApplicationFirewallPolicyPropertiesFormat |
WebApplicationFirewallPolicyPropertiesFormat
Имя | Описание | Значение |
---|---|---|
customRules | Настраиваемые правила внутри политики. | WebApplicationFirewallCustomRule[] |
managedRules | Описывает структуру managedRules. | ManagedRulesDefinition (обязательно) |
policySettings | PolicySettings для политики. | PolicySettings |
WebApplicationFirewallCustomRule
Имя | Описание | Значение |
---|---|---|
action | Типы действий. | "Разрешить" "Block" Log (обязательно) |
matchConditions | Список условий соответствия. | MatchCondition[] (обязательно) |
name | Имя ресурса, уникального в рамках политики. Это имя можно использовать для доступа к ресурсу. | строка Ограничения: Максимальная длина = 128 |
priority | Приоритет правила. Правила с меньшим значением будут оцениваться перед правилами с более высоким значением. | int (обязательно) |
ruleType | Тип правила. | "Недопустимый" MatchRule (обязательно) |
MatchCondition
Имя | Описание | Значение |
---|---|---|
matchValues | Сопоставление значения. | string[] (обязательно) |
matchVariables | Список переменных соответствия. | MatchVariable[] (обязательно) |
negationConditon | Является ли это условием отмены или нет. | bool |
оператор | Оператор для сопоставления. | BeginsWith "Contains" 'EndsWith' "Equal" "GeoMatch" 'GreaterThan' 'GreaterThanOrEqual' 'IPMatch' 'LessThan' "LessThanOrEqual" "Регулярное выражение" (обязательно) |
преобразования | Список преобразований. | Массив строк, содержащий любой из: HtmlEntityDecode "Нижний регистр" RemoveNulls "Обрезка" 'UrlDecode' 'UrlEncode' |
MatchVariable
Имя | Описание | Значение |
---|---|---|
selector | Селектор переменной соответствия. | строка |
variableName | Сопоставление переменной. | 'PostArgs' QueryString RemoteAddr "RequestBody" 'RequestCookies' 'RequestHeaders' RequestMethod RequestUri (обязательный) |
ManagedRulesDefinition
Имя | Описание | Значение |
---|---|---|
исключения | Исключения, применяемые к политике. | OwaspCrsExclusionEntry[] |
managedRuleSets | Наборы управляемых правил, связанные с политикой. | ManagedRuleSet[] (обязательно) |
OwaspCrsExclusionEntry
Имя | Описание | Значение |
---|---|---|
matchVariable | Исключаемая переменная. | RequestArgNames RequestCookieNames RequestHeaderNames (обязательно) |
selector | Если matchVariable является коллекцией, оператор используется для указания элементов в коллекции, к которым применяется это исключение. | string (обязательно) |
selectorMatchOperator | Если matchVariable является коллекцией, с помощью селектора укажите, к каким элементам в коллекции применяется это исключение. | "Contains" 'EndsWith' "Equals" "EqualsAny" StartsWith (обязательно) |
ManagedRuleSet
Имя | Описание | Значение |
---|---|---|
ruleGroupOverrides | Определяет переопределения группы правил для применения к набору правил. | ManagedRuleGroupOverride[] |
ruleSetType | Определяет используемый тип набора правил. | string (обязательно) |
ruleSetVersion | Определяет версию набора правил для использования. | string (обязательно) |
ManagedRuleGroupOverride
Имя | Описание | Значение |
---|---|---|
ruleGroupName | Управляемая группа правил для переопределения. | string (обязательно) |
правила | Список правил, которые будут отключены. Если ни один из них не указан, все правила в группе будут отключены. | ManagedRuleOverride[] |
ManagedRuleOverride
Имя | Описание | Значение |
---|---|---|
ruleId | Идентификатор управляемого правила. | string (обязательно) |
Состояние | Состояние управляемого правила. По умолчанию используется значение Отключено, если не указано. | "Отключено" |
PolicySettings
Имя | Описание | Значение |
---|---|---|
fileUploadLimitInMb | Максимальный размер отправляемого файла в Мб для WAF. | INT Ограничения: Минимальное значение = 0 |
maxRequestBodySizeInKb | Максимальный размер текста запроса в КБ для WAF. | INT Ограничения: Минимальное значение = 8 |
mode | Режим политики. | "Обнаружение" "Предотвращение" |
requestBodyCheck | Указывает, следует ли разрешить WAF проверка текст запроса. | bool |
Состояние | Состояние политики. | "Отключено" "Включено" |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
Шаблон | Описание |
---|---|
Create Azure WAF версии 2 на Шлюз приложений Azure |
Этот шаблон создает azure Брандмауэр веб-приложений версии 2 на Шлюз приложений Azure с двумя серверами Windows Server 2016 во внутреннем пуле. |
Кластер AKS со шлюзом NAT и Шлюз приложений |
В этом примере показано, как развернуть кластер AKS со шлюзом NAT для исходящих подключений и Шлюз приложений для входящих подключений. |
Front Door уровня "Стандартный" или "Премиум" с источником Шлюз приложений |
Этот шаблон создает Front Door уровня "Стандартный" или "Премиум" и экземпляр Шлюз приложений, а также использует политику NSG и WAF для проверки того, что трафик проходит через источник Front Door. |
Front Door с Экземпляры контейнеров и Шлюз приложений |
Этот шаблон создает Front Door уровня "Стандартный" или "Премиум" с группой контейнеров и Шлюз приложений. |
Кластер AKS с контроллером входящего трафика Шлюз приложений |
В этом примере показано, как развернуть кластер AKS с помощью Шлюз приложений, контроллера Шлюз приложений входящего трафика, Реестр контейнеров Azure, Log Analytics и Key Vault |
Шлюз приложений с WAF и политикой брандмауэра |
Этот шаблон создает Шлюз приложений с настроенным WAF и политикой брандмауэра. |
Определение ресурса шаблона ARM
Тип ресурса ApplicationGatewayWebApplicationFirewallPolicies можно развернуть с помощью операций, предназначенных для:
- Группы ресурсов — см. команды развертывания групп ресурсов.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies",
"apiVersion": "2021-02-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"customRules": [
{
"action": "string",
"matchConditions": [
{
"matchValues": [ "string" ],
"matchVariables": [
{
"selector": "string",
"variableName": "string"
}
],
"negationConditon": "bool",
"operator": "string",
"transforms": [ "string" ]
}
],
"name": "string",
"priority": "int",
"ruleType": "string"
}
],
"managedRules": {
"exclusions": [
{
"matchVariable": "string",
"selector": "string",
"selectorMatchOperator": "string"
}
],
"managedRuleSets": [
{
"ruleGroupOverrides": [
{
"ruleGroupName": "string",
"rules": [
{
"ruleId": "string",
"state": "Disabled"
}
]
}
],
"ruleSetType": "string",
"ruleSetVersion": "string"
}
]
},
"policySettings": {
"fileUploadLimitInMb": "int",
"maxRequestBodySizeInKb": "int",
"mode": "string",
"requestBodyCheck": "bool",
"state": "string"
}
}
}
Значения свойств
ApplicationGatewayWebApplicationFirewallPolicies
Имя | Описание | Значение |
---|---|---|
тип | Тип ресурса | Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies |
версия_API | Версия API ресурсов | '2021-02-01' |
name | имя ресурса. | string (обязательно) |
location | Расположение ресурса. | строка |
tags | Теги ресурсов. | Словарь имен и значений тегов. См . раздел Теги в шаблонах |
properties | Свойства политики брандмауэра веб-приложения. | WebApplicationFirewallPolicyPropertiesFormat |
WebApplicationFirewallPolicyPropertiesFormat
Имя | Описание | Значение |
---|---|---|
customRules | Настраиваемые правила внутри политики. | WebApplicationFirewallCustomRule[] |
managedRules | Описывает структуру managedRules. | ManagedRulesDefinition (обязательно) |
policySettings | PolicySettings для политики. | PolicySettings |
WebApplicationFirewallCustomRule
Имя | Описание | Значение |
---|---|---|
action | Типы действий. | "Разрешить" "Block" Log (обязательно) |
matchConditions | Список условий соответствия. | MatchCondition[] (обязательно) |
name | Имя ресурса, уникального в политике. Это имя можно использовать для доступа к ресурсу. | строка Ограничения: Максимальная длина = 128 |
priority | Приоритет правила. Правила с меньшим значением будут оцениваться перед правилами с более высоким значением. | int (обязательно) |
ruleType | Тип правила. | "Недопустимый" MatchRule (обязательно) |
MatchCondition
Имя | Описание | Значение |
---|---|---|
matchValues | Сопоставление значения. | string[] (обязательно) |
matchVariables | Список переменных соответствия. | MatchVariable[] (обязательно) |
negationConditon | Независимо от того, является ли это условие неуявным или нет. | bool |
оператор | Оператор для сопоставления. | BeginsWith "Contains" EndsWith "Равно" "GeoMatch" 'GreaterThan' 'GreaterThanOrEqual' IPMatch "LessThan" LessThanOrEqual Regex (обязательно) |
преобразования | Список преобразований. | Массив строк, содержащий любой из: HtmlEntityDecode Строчная буква RemoveNulls "Обрезка" UrlDecode UrlEncode |
MatchVariable
Имя | Описание | Значение |
---|---|---|
selector | Селектор переменной соответствия. | строка |
variableName | Сопоставление переменной. | "PostArgs" QueryString RemoteAddr RequestBody RequestCookies RequestHeaders RequestMethod RequestUri (обязательный) |
ManagedRulesDefinition
Имя | Описание | Значение |
---|---|---|
исключения | Исключения, применяемые к политике. | OwaspCrsExclusionEntry[] |
managedRuleSets | Наборы управляемых правил, связанные с политикой. | ManagedRuleSet[] (обязательно) |
OwaspCrsExclusionEntry
Имя | Описание | Значение |
---|---|---|
matchVariable | Исключаемая переменная. | RequestArgNames RequestCookieNames RequestHeaderNames (обязательно) |
selector | Если matchVariable является коллекцией, оператор используется для указания элементов в коллекции, к которым применяется это исключение. | строка (обязательно) |
selectorMatchOperator | Если matchVariable является коллекцией, с помощью селектора укажите, к каким элементам в коллекции применяется это исключение. | "Contains" EndsWith "Равно" "EqualsAny" StartsWith (обязательно) |
ManagedRuleSet
Имя | Описание | Значение |
---|---|---|
ruleGroupOverrides | Определяет переопределения группы правил для применения к набору правил. | ManagedRuleGroupOverride[] |
ruleSetType | Определяет используемый тип набора правил. | строка (обязательно) |
ruleSetVersion | Определяет версию набора правил для использования. | строка (обязательно) |
ManagedRuleGroupOverride
Имя | Описание | Значение |
---|---|---|
ruleGroupName | Управляемая группа правил для переопределения. | строка (обязательно) |
правила | Список правил, которые будут отключены. Если этот параметр не указан, все правила в группе будут отключены. | ManagedRuleOverride[] |
ManagedRuleOverride
Имя | Описание | Значение |
---|---|---|
ruleId | Идентификатор управляемого правила. | строка (обязательно) |
Состояние | Состояние управляемого правила. По умолчанию — Отключено, если не указано. | "Отключено" |
PolicySettings
Имя | Описание | Значение |
---|---|---|
fileUploadLimitInMb | Максимальный размер отправляемого файла в МБ для WAF. | INT Ограничения: Минимальное значение = 0 |
maxRequestBodySizeInKb | Максимальный размер текста запроса в КБ для WAF. | INT Ограничения: Минимальное значение = 8 |
mode | Режим политики. | "Обнаружение" "Предотвращение" |
requestBodyCheck | Следует ли разрешить WAF проверка текст запроса. | bool |
Состояние | Состояние политики. | "Отключено" "Включено" |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
Шаблон | Описание |
---|---|
Create Azure WAF версии 2 в Шлюз приложений Azure |
Этот шаблон создает azure Брандмауэр веб-приложений версии 2 на Шлюз приложений Azure с двумя Windows Server 2016 серверами во внутреннем пуле. |
Кластер AKS со шлюзом NAT и Шлюз приложений |
В этом примере показано, как развернуть кластер AKS со шлюзом NAT для исходящих подключений и Шлюз приложений для входящих подключений. |
Front Door уровня "Стандартный" или "Премиум" с источником Шлюз приложений |
Этот шаблон создает экземпляр Front Door уровня "Стандартный" или "Премиум" и экземпляр Шлюз приложений, а также использует политику NSG и WAF для проверки того, что трафик проходит через источник Front Door. |
Front Door с Экземпляры контейнеров и Шлюз приложений |
Этот шаблон создает Front Door уровня "Стандартный" или "Премиум" с группой контейнеров и Шлюз приложений. |
Кластер AKS с контроллером входящего трафика Шлюз приложений |
В этом примере показано, как развернуть кластер AKS с Шлюз приложений, контроллером Шлюз приложений входящего трафика, Реестр контейнеров Azure, Log Analytics и Key Vault |
Шлюз приложений с WAF и политикой брандмауэра |
Этот шаблон создает Шлюз приложений с настроенным WAF и политикой брандмауэра. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса ApplicationGatewayWebApplicationFirewallPolicies можно развернуть с помощью следующих операций:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies, добавьте в шаблон следующую terraform.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2021-02-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
customRules = [
{
action = "string"
matchConditions = [
{
matchValues = [
"string"
]
matchVariables = [
{
selector = "string"
variableName = "string"
}
]
negationConditon = bool
operator = "string"
transforms = [
"string"
]
}
]
name = "string"
priority = int
ruleType = "string"
}
]
managedRules = {
exclusions = [
{
matchVariable = "string"
selector = "string"
selectorMatchOperator = "string"
}
]
managedRuleSets = [
{
ruleGroupOverrides = [
{
ruleGroupName = "string"
rules = [
{
ruleId = "string"
state = "Disabled"
}
]
}
]
ruleSetType = "string"
ruleSetVersion = "string"
}
]
}
policySettings = {
fileUploadLimitInMb = int
maxRequestBodySizeInKb = int
mode = "string"
requestBodyCheck = bool
state = "string"
}
}
})
}
Значения свойств
ApplicationGatewayWebApplicationFirewallPolicies
Имя | Описание | Значение |
---|---|---|
тип | Тип ресурса | "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2021-02-01" |
name | имя ресурса. | строка (обязательно) |
location | Расположение ресурса. | строка |
parent_id | Чтобы выполнить развертывание в группе ресурсов, используйте идентификатор этой группы ресурсов. | строка (обязательно) |
tags | Теги ресурсов. | Словарь имен и значений тегов. |
properties | Свойства политики брандмауэра веб-приложения. | WebApplicationFirewallPolicyPropertiesFormat |
WebApplicationFirewallPolicyPropertiesFormat
Имя | Описание | Значение |
---|---|---|
customRules | Настраиваемые правила в политике. | WebApplicationFirewallCustomRule[] |
managedRules | Описывает структуру managedRules. | ManagedRulesDefinition (обязательно) |
PolicySettings | PolicySettings для политики. | PolicySettings |
WebApplicationFirewallCustomRule
Имя | Описание | Значение |
---|---|---|
action | Типы действий. | "Разрешить" "Блокировать" "Log" (обязательно) |
matchConditions | Список условий соответствия. | MatchCondition[] (обязательно) |
name | Имя ресурса, уникального в политике. Это имя можно использовать для доступа к ресурсу. | строка Ограничения: Максимальная длина = 128 |
priority | Приоритет правила. Правила с меньшим значением будут оцениваться перед правилами с более высоким значением. | int (обязательно) |
ruleType | Тип правила. | "Недопустимый" MatchRule (обязательно) |
MatchCondition
Имя | Описание | Значение |
---|---|---|
matchValues | Сопоставление значения. | string[] (обязательно) |
matchVariables | Список переменных соответствия. | MatchVariable[] (обязательно) |
negationConditon | Независимо от того, является ли это условие неуявным или нет. | bool |
оператор | Оператор для сопоставления. | BeginsWith "Содержит" "EndsWith" "Равно" "GeoMatch" "GreaterThan" "GreaterThanOrEqual" "IPMatch" "LessThan" "LessThanOrEqual" Regex (обязательно) |
преобразования | Список преобразований. | Массив строк, содержащий любой из: "HtmlEntityDecode" "Строчная" RemoveNulls "Обрезать" "UrlDecode" "UrlEncode" |
MatchVariable
Имя | Описание | Значение |
---|---|---|
selector | Селектор переменной соответствия. | строка |
variableName | Сопоставление переменной. | "PostArgs" QueryString "RemoteAddr" RequestBody "RequestCookies" "RequestHeaders" "RequestMethod" RequestUri (обязательный) |
ManagedRulesDefinition
Имя | Описание | Значение |
---|---|---|
исключения | Исключения, применяемые к политике. | OwaspCrsExclusionEntry[] |
managedRuleSets | Наборы управляемых правил, связанные с политикой. | ManagedRuleSet[] (обязательно) |
OwaspCrsExclusionEntry
Имя | Описание | Значение |
---|---|---|
matchVariable | Исключаемая переменная. | RequestArgNames RequestCookieNames RequestHeaderNames (обязательно) |
selector | Если matchVariable является коллекцией, оператор используется для указания элементов в коллекции, к которым применяется это исключение. | строка (обязательно) |
selectorMatchOperator | Если matchVariable является коллекцией, с помощью селектора укажите, к каким элементам в коллекции применяется это исключение. | "Содержит" "EndsWith" "Равно" "EqualsAny" "StartsWith" (обязательно) |
ManagedRuleSet
Имя | Описание | Значение |
---|---|---|
ruleGroupOverrides | Определяет переопределения группы правил для применения к набору правил. | ManagedRuleGroupOverride[] |
ruleSetType | Определяет используемый тип набора правил. | строка (обязательно) |
ruleSetVersion | Определяет версию набора правил для использования. | строка (обязательно) |
ManagedRuleGroupOverride
Имя | Описание | Значение |
---|---|---|
ruleGroupName | Управляемая группа правил для переопределения. | строка (обязательно) |
правила | Список правил, которые будут отключены. Если этот параметр не указан, все правила в группе будут отключены. | ManagedRuleOverride[] |
ManagedRuleOverride
Имя | Описание | Значение |
---|---|---|
ruleId | Идентификатор управляемого правила. | строка (обязательно) |
Состояние | Состояние управляемого правила. По умолчанию — Отключено, если не указано. | "Отключено" |
PolicySettings
Имя | Описание | Значение |
---|---|---|
fileUploadLimitInMb | Максимальный размер отправляемого файла в МБ для WAF. | INT Ограничения: Минимальное значение = 0 |
maxRequestBodySizeInKb | Максимальный размер текста запроса в КБ для WAF. | INT Ограничения: Минимальное значение = 8 |
mode | Режим политики. | "Обнаружение" "Предотвращение" |
requestBodyCheck | Следует ли разрешить WAF проверка текст запроса. | bool |
Состояние | Состояние политики. | "Отключено" "Включено" |