你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az network application-gateway waf-config

配置 Web 应用程序防火墙的设置。

这些命令仅适用于 SKU 类型为 WAF 的应用程序网关。 有关详细信息,请访问https://learn.microsoft.com/en-us/azure/web-application-firewall/ag/tutorial-restrict-web-traffic-cli

命令

名称 说明 类型 Status
az network application-gateway waf-config list-dynamic-rule-sets

列出区域应用程序网关 waf 清单。

核心 GA
az network application-gateway waf-config list-rule-sets

获取有关可用 WAF 规则集、规则组和规则 ID 的信息。

核心 GA
az network application-gateway waf-config set

更新 Web 应用程序的防火墙配置。

核心 GA
az network application-gateway waf-config show

获取 Web 应用程序的防火墙配置。

核心 GA

az network application-gateway waf-config list-dynamic-rule-sets

列出区域应用程序网关 waf 清单。

az network application-gateway waf-config list-dynamic-rule-sets --location
                                                                 [--max-items]
                                                                 [--next-token]

示例

列出区域中的应用程序网关 waf 清单。

az network application-gateway waf-config list-dynamic-rule-sets -l  westus

必需参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az network application-gateway waf-config list-rule-sets

获取有关可用 WAF 规则集、规则组和规则 ID 的信息。

az network application-gateway waf-config list-rule-sets [--group]
                                                         [--type]
                                                         [--version]

示例

列出 OWASP 类型规则集中的可用规则组。

az network application-gateway waf-config list-rule-sets --type OWASP

列出 OWASP 3.0 规则集中的可用规则。

az network application-gateway waf-config list-rule-sets --group '*' --type OWASP --version 3.0

列出“crs_35_bad_robots”规则组中的可用规则。

az network application-gateway waf-config list-rule-sets --group crs_35_bad_robots

以表格式列出可用规则。

az network application-gateway waf-config list-rule-sets -o table

可选参数

--group

列出指定规则组的规则。 用于 * 列出所有组的规则。 省略以禁止列出单个规则。

--type

要列出的规则集类型。 省略以列出所有类型。

--version

要列出的规则集版本。 省略以列出所有版本。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az network application-gateway waf-config set

更新 Web 应用程序的防火墙配置。

此命令仅适用于 SKU 类型为 WAF 的应用程序网关。 有关详细信息,请访问https://learn.microsoft.com/en-us/azure/web-application-firewall/ag/tutorial-restrict-web-traffic-cli

az network application-gateway waf-config set --enabled {false, true}
                                              [--disabled-rule-groups]
                                              [--disabled-rules]
                                              [--exclusion]
                                              [--file-upload-limit]
                                              [--firewall-mode {detection, prevention}]
                                              [--gateway-name]
                                              [--ids]
                                              [--max-request-body-size]
                                              [--no-wait]
                                              [--request-body-check {false, true}]
                                              [--resource-group]
                                              [--rule-set-type]
                                              [--rule-set-version]
                                              [--subscription]

示例

在检测模式下使用默认值在应用程序网关上配置 WAF

az network application-gateway waf-config set -g MyResourceGroup --gateway-name MyAppGateway --enabled true --firewall-mode Detection --rule-set-version 3.0

禁用用于验证请求正文分析和 SQL 注入的规则。

az network application-gateway waf-config set -g MyResourceGroup --gateway-name MyAppGateway --enabled true --rule-set-type OWASP --rule-set-version 3.0 --disabled-rule-groups REQUEST-942-APPLICATION-ATTACK-SQLI --disabled-rules 920130 920140

在包含排除项的应用程序网关上配置 WAF。

az network application-gateway waf-config set -g MyResourceGroup --gateway-name MyAppGateway --enabled true --firewall-mode Detection --rule-set-version 3.0 --exclusion "RequestHeaderNames StartsWith x-header" --exclusion "RequestArgNames Equals IgnoreThis"

必需参数

--enabled

指定是否启用应用程序防火墙。

接受的值: false, true

可选参数

--disabled-rule-groups

要禁用的规则组的空间分隔列表。 若要禁用单个规则,请使用 --disabled-rules

值来源: az network application-gateway waf-config list-rule-sets
--disabled-rules

要禁用的规则 ID 的空间分隔列表。

值来源: az network application-gateway waf-config list-rule-sets
--exclusion

将排除表达式添加到 WAF 检查。

用法:--exclusion VARIABLE 运算符值

可以使用多个 --exclusion 参数来指定多个排除项。

--file-upload-limit

文件上传大小限制(以 MB 为单位)。

--firewall-mode

Web 应用程序防火墙模式。

接受的值: detection, prevention
默认值: detection
--gateway-name

应用程序网关的名称。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--max-request-body-size

知识库(KB) 的最大请求正文大小。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--request-body-check

允许 WAF 检查请求正文。

接受的值: false, true
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--rule-set-type

规则集类型。

默认值: OWASP
值来源: az network application-gateway waf-config list-rule-sets
--rule-set-version

规则集版本。

值来源: az network application-gateway waf-config list-rule-sets
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az network application-gateway waf-config show

获取 Web 应用程序的防火墙配置。

az network application-gateway waf-config show [--gateway-name]
                                               [--ids]
                                               [--resource-group]
                                               [--subscription]

示例

获取 Web 应用程序的防火墙配置。

az network application-gateway waf-config show -g MyResourceGroup --gateway-name MyAppGateway

可选参数

--gateway-name

应用程序网关的名称。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。