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

Создание пользовательского набора правил

Используйте Создание набора правил уровня аккаунта или зоны операцию, чтобы создать пользовательский набор правил, убедившись, что вы:

Задайте kind поле в custom.
Укажите имя фаза где вы хотите создать пользовательский набор правил в phase поле.

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

Если вы используете Terraform, см. Настройка пользовательских правил WAF с помощью Terraform для примеров создания и развёртывания пользовательских наборов правил.

Если вы используете панель управления Cloudflare, обратитесь к Работа с пользовательскими наборами правил в дашборде.

Пример A: пользовательский набор правил на уровне аккаунта

Следующий запрос создаёт новый пользовательский набор правил на уровне аккаунта. Ответ будет включать ID нового пользовательского набора правил в id поле.

Необходимые разрешения 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

Создайте 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": []
}

Вы можете включить список правил в запрос на создание пользовательского набора правил. Если вы не добавили ни одного правила, обратитесь к Добавление правил в пользовательский набор правил, где это описано подробнее.

Пример B: пользовательский набор правил на уровне зоны

Следующий запрос создаёт новый пользовательский набор правил на уровне зоны. Ответ будет включать ID нового пользовательского набора правил в 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" \
	--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": []
}