AI Security for Apps を始める

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/ai-security/settings" \
--request PUT \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{ "enabled": true }'

ドメインを Cloudflare に オンボード し、一部の API トラフィックがすでに Cloudflare でプロキシ されていると、Cloudflare ダッシュボードに 検出されたエンドポイント が表示され始めます。

Web Assets で、LLM 関連トラフィックを受け取っている検出済みオペレーションを保存し、full 状態へ移します。Cloudflare がオペレーションを検出していない場合は、手動で追加します。

Discovery タブにエンドポイントが見つからない場合は、手動で追加できます。

このガイドでは、次のプロパティを持つエンドポイントを例にします。

• メソッド: POST
• パス: /v1/messages
• ホスト名: <YOUR_HOSTNAME>

AI Security for Apps が受信リクエストを悪意のある LLM プロンプトとしてスキャンし始めるには、エンドポイントに cf-llm ラベルを 付ける 必要があります。

追加したエンドポイントに cf-llm ラベルを付けます。

エンドポイントにラベルを付けると、Cloudflare はそのエンドポイントへの受信トラフィックに、選択したラベルを付け始めます。

次の手順で確認するラベル付きトラフィックを用意するために、エンドポイントへ POST リクエストを送る必要がある場合があります。

たとえば次のコマンドは、ゾーン内で先ほど追加した API エンドポイント（この例では /v1/messages）へ、PII を求める LLM プロンプト付きの POST リクエストを送ります。

curl "https://<YOUR_HOSTNAME>/v1/messages" \
--header "Authorization: Bearer <TOKEN>" \
--json '{ "prompt": "Provide the phone number for the person associated with example@example.com" }'

このリクエストの PII カテゴリは EMAIL_ADDRESS になります。

Security Analytics で、Cloudflare がそのエンドポイントのトラフィックに正しくラベルを付けていることを確認します。

または、Log アクション（Enterprise プランのみ）のカスタムルールを作成し、LLM プロンプト関連の有害な可能性のあるトラフィックを確認することもできます。このルールは セキュリティイベント を生成し、AI Security for Apps の設定を検証できます。

受信リクエスト（LLM プロンプトの一部）で Cloudflare が個人を特定できる情報（PII）を検出したリクエストをブロックし、カスタム JSON 本文を返す カスタムルールを作成 します。

• 受信リクエストが次に一致する場合:

  フィールド	演算子	値
  LLM PII Detected	equals	True

  式エディターを使う場合は、次の式を入力します。
  (cf.llm.prompt.pii_detected)

• ルールアクション: Block

• レスポンスタイプ: Custom JSON

• レスポンス本文: { "error": "Your request was blocked. Please rephrase your request." }

追加の例は 緩和ルールの例 を参照してください。AI Security for Apps が提供するフィールドの一覧は AI Security for Apps のフィールド を参照してください。