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

Nasazení spravované sady pravidel s přepisy na úrovni sady pravidel, značek a pravidel

Provádění spravovaných sad pravidel přizpůsobte kombinací přepisů sady pravidel, přepisů podle štítků a přepisů pravidel ve své sadě pravidel vstupního bodu fáze.

Přidejte pravidlo do sady pravidel vstupního bodu fáze, abyste spustili spravovanou sadu pravidel.
Nastavte přepis sady pravidel , které deaktivuje všechna pravidla ve spravované sadě pravidel.
Nastavte přepis podle štítku , které nastaví akci pro pravidla s daným štítkem.
Nastavte přepis pravidla , které nastaví akci pro pravidla, jež chcete spustit.

Příklad na úrovni zóny

Tento příklad používá Aktualizace vstupní sady pravidel zóny operaci a proveďte následující v rámci jediného PUT požadavek:

Přidejte pravidlo do http_request_firewall_managed vstupní sadu pravidel fáze, která spouští spravovanou sadu pravidel.
Pomocí přepsání kategorií povolte pravidla s wordpress a drupal štítky a nastavte jejich akce na log.
Přidejte přepis pravidla, který povolí jediné pravidlo.

V tomto příkladu:

"id": "<MANAGED_RULESET_ID>" definuje spravovanou sadu pravidel, která se spustí pro požadavky určené na zónu ($ZONE_ID).
"enabled": false definuje přepis na úrovni sady pravidel, jehož účelem je zakázat všechna pravidla ve spravované sadě pravidel.
"categories": [{"category": "wordpress", "action": "log", "enabled": true}, {"category": "drupal", "action": "log", "enabled": true}] definuje přepis na úrovni tagu, jehož účelem je povolit pravidla označená tagem wordpress nebo drupal a nastaví jejich akci na log.
"rules": [{"id": "<RULE_ID>", "action": "block", "enabled": true}] definuje přepis na úrovni pravidla, který povoluje jedno konkrétní pravidlo a nastavuje akci na block.

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:

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

Aktualizace vstupní sady pravidel zóny

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
												}
										]
								}
						}
				}
		]
	}'

Příklad na úrovni účtu

Tento příklad používá Aktualizace rulesetu vstupního bodu účtu operaci a proveďte následující v rámci jediného PUT požadavek:

Přidejte pravidlo do http_request_firewall_managed vstupní sadu pravidel fáze, která spouští spravovanou sadu pravidel pro zónu example.com.
Pomocí přepsání kategorií povolte pravidla s wordpress a drupal štítky a nastavte jejich akce na log.
Přidejte přepis pravidla, který povolí jediné pravidlo.

V tomto příkladu:

"id": "<MANAGED_RULESET_ID>" definuje spravovanou sadu pravidel, která se spustí pro požadavky určené na example.com.
"enabled": false definuje přepis na úrovni sady pravidel, jehož účelem je zakázat všechna pravidla ve spravované sadě pravidel.
"categories": [{"category": "wordpress", "action": "log", "enabled": true}, {"category": "drupal", "action": "log", "enabled": true}] definuje přepis na úrovni tagu, jehož účelem je povolit pravidla označená tagem wordpress nebo drupal a nastaví jejich akci na log.
"rules": [{"id": "<RULE_ID>", "action": "block", "enabled": true}] definuje přepis na úrovni pravidla, který povoluje jedno konkrétní pravidlo a nastavuje akci na block.

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:

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

Aktualizace rulesetu vstupního bodu účtu

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
												}
										]
								}
						}
				}
		]
	}'