通过 API 部署 WAF 托管规则集（zone）

使用 Rulesets API 在域级部署托管规则集。

将 WAF 托管规则集部署到 http_request_firewall_managed 阶段。其他托管规则集（如 DDoS Attack Protection 托管规则集）必须部署到其它阶段。详情请参见对应托管规则集的文档。

WAF 托管规则集页面中包含各托管规则集的 ID，在通过 API 部署时请先确认该信息。

若您使用 Terraform，请参阅通过 Terraform 配置 WAF 托管规则集。

示例

以下示例通过创建一个执行托管规则集的规则，将 Cloudflare Managed Ruleset 部署到给定区域（$ZONE_ID）的 http_request_firewall_managed 阶段。

调用获取区域入口点规则集操作，以获取 http_request_firewall_managed 阶段的入口点规则集定义。您需要有区域 ID才能完成此任务。

Get a zone entry point rulesetbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_firewall_managed/entrypoint" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
	"result": {
		"description": "Zone-level phase entry point",
		"id": "<RULESET_ID>",
		"kind": "zone",
		"last_updated": "2024-03-16T15:40:08.202335Z",
		"name": "zone",
		"phase": "http_request_firewall_managed",
		"rules": [
			// ...
		],
		"source": "firewall_managed",
		"version": "10"
	},
	"success": true,
	"errors": [],
	"messages": []
}

如果入口点规则集已存在（即，如果您收到 200 OK 状态代码和规则集定义），请记下响应中的规则集 ID。然后，调用创建区域规则集规则操作，向现有规则集中添加一条 execute 规则，以部署 Cloudflare Managed Ruleset（ID 为 efb7b8c949ac4650a09736fc376e9aee）。默认情况下，该规则将添加到规则集中已有规则列表的末尾。

Create a zone ruleset rulebash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/$RULESET_ID/rules" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"action": "execute",
		"action_parameters": {
				"id": "efb7b8c949ac4650a09736fc376e9aee"
		},
		"expression": "true",
		"description": "Execute the Cloudflare Managed Ruleset"
	}'

{
	"result": {
		"id": "<RULESET_ID>",
		"name": "Zone-level phase entry point",
		"description": "",
		"kind": "zone",
		"version": "11",
		"rules": [
			// ... any existing rules
			{
				"id": "<RULE_ID>",
				"version": "1",
				"action": "execute",
				"action_parameters": {
					"id": "efb7b8c949ac4650a09736fc376e9aee",
					"version": "latest"
				},
				"expression": "true",
				"description": "Execute the Cloudflare Managed Ruleset",
				"last_updated": "2024-03-18T18:08:14.003361Z",
				"ref": "<RULE_REF>",
				"enabled": true
			}
		],
		"last_updated": "2024-03-18T18:08:14.003361Z",
		"phase": "http_request_firewall_managed"
	},
	"success": true,
	"errors": [],
	"messages": []
}

如果入口点规则集不存在（也就是说，如果您在步骤 1 中收到了 404 Not Found 状态码），请使用创建区域规则集操作来创建它。在 rules 数组中包含单个规则，该规则针对区域中的所有传入请求执行 Cloudflare Managed Ruleset（ID 为 efb7b8c949ac4650a09736fc376e9aee）。

Create a zone rulesetbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "My ruleset",
		"description": "Entry point ruleset for WAF managed rulesets",
		"kind": "zone",
		"phase": "http_request_firewall_managed",
		"rules": [
				{
						"action": "execute",
						"action_parameters": {
								"id": "efb7b8c949ac4650a09736fc376e9aee"
						},
						"expression": "true",
						"description": "Execute the Cloudflare Managed Ruleset"
				}
		]
	}'

后续步骤

要自定义托管规则集中的规则行为，请执行创建覆盖（override）。

如需跳过 WAF 托管规则集或其部分规则的执行，请创建例外（也称 skip 规则）。

例外优先于覆盖。

通过 API 部署 WAF 托管规则集（zone）

示例

后续步骤

更多资源