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

Nasazení sad pravidel

Použijte Rulesets API k nasazení sady pravidel. Chcete-li nasadit sadu pravidel, přidejte pravidlo s "action": "execute" na vstupní sada pravidel fáze, přičemž ID rulesetu, který se má spustit, uvedete jako parametr akce. Pro každý ruleset, který chcete nasadit, použijte samostatné pravidlo.

Pravidlo, které spouští ruleset, se skládá z:

ID sady pravidel, kterou chcete spustit, uvedené action_parameters.id.
Výraz.
execute jako akci.

Pravidla v sadě pravidel se spustí, když požadavek splní daný výraz.

Příklad

Následující příklad nasadí Cloudflare Managed Ruleset (s ID ) k http_request_firewall_managed fáze dané zóny ($ZONE_ID) přidáním pravidla, které spustí spravovanou sadu pravidel.

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",
						"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": []
}

Další příklady nasazení sad pravidel najdete na následujících stránkách:

Viz Práce se spravovanými sadami pravidel a Práce s vlastními sadami pravidel s dalšími informacemi.

Další informace o dostupných koncových bodech API pro úpravu a nasazování sad pravidel najdete v Aktualizace nebo nasazení rulesetu.

Nasazení sad pravidel

Příklad

Související zdroje