← Cloudflare Ruleset Engine / ruleset-engine / basic-operations

Развёртывание наборов правил

Используйте Rulesets API чтобы развернуть набор правил. Чтобы развернуть набор правил, добавьте правило с "action": "execute" к входной набор правил фазы, указав ID набора правил для выполнения в качестве параметра действия. Используйте отдельное правило для каждого набора правил, который требуется развернуть.

Правило, которое выполняет набор правил, состоит из:

Идентификатор набора правил, который требуется выполнить, включается в action_parameters.id.
Выражение.
execute действие.

Правила набора правил выполняются, когда запрос соответствует выражению.

Пример

Следующий пример развёртывает Cloudflare Managed Ruleset (с ID ) к http_request_firewall_managed фаза заданной зоны ($ZONE_ID), добавив правило, которое выполняет управляемый набор правил.

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Response Compression Write
Config Settings Write
Dynamic URL Redirects Write
Cache Settings Write
Custom Errors Write
Origin Write
Managed headers Write
Zone Transform Rules Write
Mass URL Redirects Write
Magic Firewall Write
L4 DDoS Managed Ruleset Write
HTTP DDoS Managed Ruleset Write
Sanitize Write
Transform Rules Write
Select Configuration Write
Bot Management Write
Zone WAF Write
Account WAF Write
Account Rulesets Write
Logs Write
Logs Write

Обновление набора правил точки входа зоны

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_firewall_managed/entrypoint" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"rules": [
				{
						"action": "execute",
						"action_parameters": {
								"id": "efb7b8c949ac4650a09736fc376e9aee"
						},
						"expression": "true",
						"description": "Execute Cloudflare Managed Ruleset on my zone ruleset"
				}
		]
	}'

{
	"result": {
		"id": "<ZONE_PHASE_RULESET_ID>",
		"name": "Zone-level Ruleset 1",
		"description": "",
		"kind": "zone",
		"version": "latest",
		"rules": [
			{
				"id": "<RULE_ID>",
				"version": "1",
				"action": "execute",
				"action_parameters": {
					"id": "efb7b8c949ac4650a09736fc376e9aee",
					"version": "3"
				},
				"expression": "true",
				"description": "Execute Cloudflare Managed Ruleset on my zone ruleset",
				"last_updated": "2021-03-18T18:08:14.003361Z",
				"ref": "<RULE_REF>",
				"enabled": true
			}
		],
		"last_updated": "2021-03-18T18:08:14.003361Z",
		"phase": "http_request_firewall_managed"
	},
	"success": true,
	"errors": [],
	"messages": []
}

Дополнительные примеры развёртывания наборов правил см. на следующих страницах:

См. Работа с управляемыми наборами правил и Работа с пользовательскими наборами правил, где это описано подробнее.

Дополнительные сведения о доступных конечных точках API для редактирования и развёртывания наборов правил см. в Обновление или развертывание набора правил.

Развёртывание наборов правил

Пример

Дополнительные материалы