ログモードと本番モード

AI Security for Apps は、2 つの異なるモードで動作できます。それぞれのトレードオフを理解すると、導入段階に合った方法を選べます。

本番モードは標準の運用モードです。AI Security for Apps を有効にし、検出結果が入る検出フィールド を使ってカスタムルール を作成します。次の点を完全に制御できます。

• どの検出でアクションを実行するか。 たとえば、検出があればすべてブロックするのではなく、cf.llm.prompt.injection_score が 30 未満のときだけブロックします。
• どの PII カテゴリを対象にするか。 たとえば、CREDIT_CARD はブロックし、EMAIL_ADDRESS はログのみにします。
• シグナルの組み合わせ。 たとえば、PII が検出され、かつボットスコアが低いときにブロックします。
• カスタムレスポンス。 デフォルトの WAF ブロックページではなく、アプリケーションへ JSON のエラーメッセージを返します。

本番ルールの式の例:
(cf.llm.prompt.injection_score lt 30 and cf.bot_management.score lt 20)

ログモードは AI Security Log Mode Ruleset を使います。これは、検出結果とあわせてリクエスト本文全体を記録する、事前構築済みのルールセットです。このモードは、本番での強制ではなく、評価と調整向けです。

ログモードでは次のように動作します。

• マネージドルールセットは、広い 3 つの条件で発火します。PII 検出、安全でないトピック検出、プロンプトインジェクション検出です。
• リクエスト本文全体は、ペイロードログ で記録されます（暗号化されます。ペイロードを復号するにはキーペアの設定が必要です）。
• 特定のプロンプトと検出スコアを突き合わせ、モデルが自トラフィックをどう分類するかを把握できます。

ログモードを使うタイミング:

• 初回導入時に、アクションを強制する前に、AI Security for Apps が自トラフィックで何を検出するかを把握するとき。
• スコアしきい値を調整するとき — 記録されたプロンプトとスコアを見比べ、適切なしきい値を決めます。
• カスタムトピック の定義が想定どおり動いているかを検証するとき。

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"
				}
		]
	}'