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

Přepsání spravované sady pravidel

Chcete-li přizpůsobit chování spravované sady pravidel prostřednictvím API, přepište sadu pravidel při nasazení. Při přepsání sady pravidel určujete změny, které se mají provést nad rámec výchozí konfigurace. Tyto změny mají přednost před výchozím chováním sady pravidel.

Pokud chcete spravovanou sadu pravidel například otestovat před jejím vynucením, zvažte její spuštění se všemi pravidly nastavenými na log místo jejich výchozích akcí. Za tímto účelem přepište nakonfigurované chování spravované sady pravidel na úrovni sady pravidel tak, aby každé pravidlo používalo log jako akci.

Pokud používáte Terraform, přečtěte si následující stránky:

• Konfigurace WAF Managed Rules pomocí Terraformu
• Konfigurace spravovaných sad pravidel DDoS pomocí Terraformu

Chcete-li definovat přepisy v Cloudflare dashboardu, přečtěte si následující zdroje:

• Konfigurace spravované sady pravidel WAF v dashboardu
• Nastavení HTTP DDoS Attack Protection v dashboardu
• Nastavení Network-layer DDoS Attack Protection v dashboardu

Sadu pravidel můžete přepsat na třech úrovních:

• Přepisy sady pravidel platí pro všechna pravidla ve spuštěné sadě pravidel.
• Přepsání štítků platí pro všechna pravidla s určitým štítkem. Pokud chcete například přizpůsobit Cloudflare Managed Ruleset, použijte přepsání štítku, aby všechna pravidla se štítkem wordpress jsou nastavena na Block. Pokud má více značek přepsání a dané pravidlo má více než jednu z těchto značek, chování určuje pořadí přepsání značek. U pravidel označených více přepsanými značkami platí přepsání poslední značky.
• Přepsání pravidel platí pro konkrétní pravidla ve spravované sadě pravidel, na která se odkazuje pomocí jejich ID pravidla.

Konkrétnější přepsání mají přednost před obecnějšími, přičemž přepsání pravidel má přednost před přepsáním štítků a to má přednost před přepsáním sady pravidel.

Chcete-li použít přepis pro spravovanou sadu pravidel:

1. Použijte jeden z operace k aktualizaci sady pravidel k aktualizaci sady pravidel vstupního bodu fáze.
2. Zadejte overrides v action_parameters pravidla, které spouští vaši spravovanou sadu pravidel.

"action_parameters": {
  "id": "<RULESET_ID>",
  "overrides": {
    // ruleset overrides
    "property-to-modify": "value",
    "property-to-modify": "value",
    // tag overrides
    "categories": [
      {
        "category": "<TAG_NAME>",
        "property-to-modify": "value",
        "property-to-modify": "value"
      }
    ],
    // rule overrides
    "rules": [
      {
        "id": "<RULE_ID>",
        "property-to-modify": "value",
        "property-to-modify": "value"
      }
    ]
  }
}

Můžete přepsat následující vlastnosti pravidla:

• "action"
• "enabled"

Některé spravované sady pravidel mohou mít další požadavky na přepsání nebo mohou umožňovat přepsání dalších vlastností pravidel. Podrobnosti najdete v dokumentaci příslušného produktu Cloudflare.

Následující PUT přidá pravidlo, které spouští spravovanou sadu pravidel ve http_request_firewall_managed fázi na úrovni zóny a definuje přepsání pravidla, které povoluje pravidlo <RULE_ID> a nastavit jeho akci na log.

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 '{
		"description": "Deploy managed ruleset, enabling a specific rule with log action",
		"rules": [
				{
						"action": "execute",
						"expression": "true",
						"action_parameters": {
								"id": "<MANAGED_RULESET_ID>",
								"overrides": {
										"rules": [
												{
														"id": "<RULE_ID>",
														"enabled": true,
														"action": "log"
												}
										]
								}
						}
				}
		]
	}'

Následující PUT přidá pravidlo, které spouští spravovanou sadu pravidel ve http_request_firewall_managed fázi na úrovni účtu a definuje přepsání sady pravidel, které nastavuje akci na log pro všechna (povolená) pravidla.

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 '{
		"description": "Deploy managed ruleset for example.com, overriding the rules action to log",
		"rules": [
				{
						"action": "execute",
						"expression": "(cf.zone.name eq \"example.com\") and cf.zone.plan eq \"ENT\"",
						"action_parameters": {
								"id": "<MANAGED_RULESET_ID>",
								"overrides": {
										"action": "log"
								}
						}
				}
		]
	}'

Další příklady konfigurace přepsání přes API najdete v Příklady přepisů.