← Cloudflare Ruleset Engine / ruleset-engine / custom-rulesets

Vytvořte vlastní sadu pravidel

Použijte Vytvořte sadu pravidel na úrovni účtu nebo zóny operaci a vytvořte vlastní sadu pravidel, přičemž dbejte na to, abyste:

Nastavte kind pole na custom.
Zadejte název fáze kde chcete vytvořit vlastní sadu pravidel v phase .

Seznam pravidel, která se mají zahrnout do vlastní sady pravidel, můžete také zadat v rules pole. Pokud chcete přidat pravidla po vytvoření vlastní sady pravidel, viz Přidání pravidel do vlastní sady pravidel.

Pokud používáte Terraform, přečtěte si Konfigurace vlastních pravidel WAF pomocí Terraformu najdete příklady vytváření a nasazování vlastních sad pravidel.

Pokud používáte Cloudflare dashboard, přečtěte si Práce s vlastními sadami pravidel v dashboardu.

Příklad A - Vlastní sada pravidel na úrovni účtu

Následující požadavek vytvoří novou vlastní sadu pravidel na úrovni účtu. Odpověď bude obsahovat ID nové vlastní sady pravidel v id .

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

Vytvořte account ruleset

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (account)",
		"kind": "custom",
		"phase": "http_request_firewall_custom"
	}'

{
	"result": {
		"id": "f82ccda3d21f4a02825d3fe45b5e1c10",
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (account)",
		"kind": "custom",
		"version": "1",
		"last_updated": "2025-08-09T10:27:30.636197Z",
		"phase": "http_request_firewall_custom"
	},
	"success": true,
	"errors": [],
	"messages": []
}

Do požadavku na vytvoření vlastní sady pravidel můžete zahrnout seznam pravidel. Pokud jste žádná pravidla nepřidali, přečtěte si Přidání pravidel do vlastní sady pravidel s dalšími informacemi.

Příklad B - Vlastní sada pravidel na úrovni zóny

Následující požadavek vytvoří novou vlastní sadu pravidel na úrovni zóny. Odpověď bude obsahovat ID nové vlastní sady pravidel v id .

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

Vytvoření rulesetu zóny

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (zone)",
		"kind": "custom",
		"phase": "http_request_firewall_custom"
	}'

{
	"result": {
		"id": "f82ccda3d21f4a02825d3fe45b5e1c10",
		"name": "Custom Ruleset 1",
		"description": "My First Custom Ruleset (zone)",
		"kind": "custom",
		"version": "1",
		"last_updated": "2025-08-09T10:27:30.636197Z",
		"phase": "http_request_firewall_custom"
	},
	"success": true,
	"errors": [],
	"messages": []
}