← Dokumentace WAF / detections / ai-security-for-apps

Režim logování versus produkční režim

AI Security for Apps může fungovat ve dvou odlišných režimech. Pochopení jejich kompromisů vám pomůže zvolit správný přístup pro vaši fázi nasazení.

Produkční režim je standardní provozní režim. Zapnete AI Security for Apps a vytvoříte vlastní pravidla pomocí pole detekce která naplňuje. Získáváte tak plnou kontrolu nad:

• Které detekce spouštějí akci. Například blokujte pouze tehdy, když cf.llm.prompt.injection_score je pod 30, místo blokování jakékoli detekce.
• Které kategorie PII jsou důležité. Například blokujte CREDIT_CARD ale pouze logovat EMAIL_ADDRESS.
• Kombinování signálů. Například blokujte, když je detekováno PII a zároveň je nízké bot score.
• Vlastní odpovědi. Vraťte své aplikaci JSON chybovou zprávu namísto výchozí blokovací stránky WAF.

Příklad výrazu produkčního pravidla:
(cf.llm.prompt.injection_score lt 30 and cf.bot_management.score lt 20)

Režim logování používá AI Security Log Mode Ruleset — předpřipravený ruleset, který loguje celé tělo požadavku spolu s výsledky detekce. Tento režim je určen pro vyhodnocování a ladění, nikoli pro produkční vynucování.

V režimu log:

• Spravovaná sada pravidel se spouští na tři obecné podmínky: detekováno PII, detekováno nebezpečné téma a detekována prompt injection.
• Celé tělo požadavku je logováno pomocí logování payloadu (šifrováno — pro dešifrování payloadů musíte nakonfigurovat pár klíčů).
• Konkrétní prompty můžete korelovat s jejich detekčními skóre, abyste pochopili, jak model klasifikuje váš provoz.

Kdy použít režim logování:

• Během počátečního nasazení, abyste pochopili, co AI Security for Apps na vašem provozu detekuje, než začnete vynucovat akce.
• Při ladění prahů skóre — kontrolujte logované prompty spolu s jejich skóre, abyste určili vhodné prahy.
• Při ověřování, že vlastní téma definice fungují podle očekávání.

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": "b7cd52df92f74c848cec0c2ed385e336"
						},
						"expression": "true"
				}
		]
	}'