← Cloudflare Ruleset Engine / ruleset-engine / managed-rulesets / override-examples

Развёртывание управляемого набора правил с переопределениями на уровне набора правил, тега и правила

Настраивайте выполнение управляемых наборов правил, комбинируя переопределения наборов правил, тегов и правил в наборе правил, который служит точкой входа фазы.

Добавьте правило к входному набору правил фазы, чтобы выполнить управляемый набор правил.
Настройка переопределения набора правил которое отключает все правила в управляемом наборе правил.
Настройка переопределения тега которое задаёт действие для правил с заданным тегом.
Настройка переопределения правила которое задаёт действие для правил, которые нужно выполнить.

Пример на уровне зоны

В этом примере используется Обновление набора правил точки входа зоны операцию, чтобы выполнить следующее в одном PUT запрос:

Добавление правила в http_request_firewall_managed входной набор правил фазы, который выполняет управляемый набор правил.
Используйте переопределения категорий, чтобы включить правила с wordpress и drupal теги и задать для них действие log.
Добавить переопределение правила, которое включает одно правило.

В этом примере:

"id": "<MANAGED_RULESET_ID>" задаёт управляемый набор правил, который выполняется для запросов, адресованных зоне ($ZONE_ID).
"enabled": false задаёт переопределение на уровне набора правил для отключения всех правил в управляемом наборе правил.
"categories": [{"category": "wordpress", "action": "log", "enabled": true}, {"category": "drupal", "action": "log", "enabled": true}] задаёт переопределение на уровне тега для включения правил с тегом wordpress или drupal и задает для них действие log.
"rules": [{"id": "<RULE_ID>", "action": "block", "enabled": true}] задаёт переопределение на уровне правила, которое включает одно отдельное правило и устанавливает действие block.

Необходимые разрешения 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",
						"expression": "true",
						"action_parameters": {
								"id": "<MANAGED_RULESET_ID>",
								"overrides": {
										"enabled": false,
										"categories": [
												{
														"category": "wordpress",
														"action": "log",
														"enabled": true
												},
												{
														"category": "drupal",
														"action": "log",
														"enabled": true
												}
										],
										"rules": [
												{
														"id": "<RULE_ID>",
														"action": "block",
														"enabled": true
												}
										]
								}
						}
				}
		]
	}'

Пример на уровне аккаунта

В этом примере используется Обновление входного набора правил аккаунта операцию, чтобы выполнить следующее в одном PUT запрос:

Добавление правила в http_request_firewall_managed входной набор правил фазы, который выполняет управляемый набор правил для зоны example.com.
Используйте переопределения категорий, чтобы включить правила с wordpress и drupal теги и задать для них действие log.
Добавить переопределение правила, которое включает одно правило.

В этом примере:

"id": "<MANAGED_RULESET_ID>" задаёт управляемый набор правил, который выполняется для запросов, адресованных example.com.
"enabled": false задаёт переопределение на уровне набора правил для отключения всех правил в управляемом наборе правил.
"categories": [{"category": "wordpress", "action": "log", "enabled": true}, {"category": "drupal", "action": "log", "enabled": true}] задаёт переопределение на уровне тега для включения правил с тегом wordpress или drupal и задает для них действие log.
"rules": [{"id": "<RULE_ID>", "action": "block", "enabled": true}] задаёт переопределение на уровне правила, которое включает одно отдельное правило и устанавливает действие block.

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

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

Mass URL Redirects Write
Magic Firewall Write
L4 DDoS Managed Ruleset Write
Transform Rules Write
Select Configuration Write
Account WAF Write
Account Rulesets Write
Logs Write

Обновление входного набора правил аккаунта

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets/phases/http_request_firewall_managed/entrypoint" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"rules": [
				{
						"action": "execute",
						"expression": "cf.zone.name eq \"example.com\" and cf.zone.plan eq \"ENT\"",
						"action_parameters": {
								"id": "<MANAGED_RULESET_ID>",
								"overrides": {
										"enabled": false,
										"categories": [
												{
														"category": "wordpress",
														"action": "log",
														"enabled": true
												},
												{
														"category": "drupal",
														"action": "log",
														"enabled": true
												}
										],
										"rules": [
												{
														"id": "<RULE_ID>",
														"action": "block",
														"enabled": true
												}
										]
								}
						}
				}
		]
	}'