Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

プロファイル検出を分析する

最終更新 Markdown で表示Agent セットアップ

Security AnalyticsProfile Analysis を使い、プロファイル検出を調べます。

リクエストステータスを理解する

Profile Analysis はリクエストを次のステータスに分類します。

  • Conforms: 評価したリクエストが、適用されるプロファイルに一致しました。
  • Violates: 評価したリクエストが、適用されるプロファイルに一致しませんでした。
  • Not evaluated: 適用できるプロファイルがないか、プロファイルが対象ではありません。

違反の詳細を理解する

サンプリングされた違反には、最初に検出された検証失敗の構造化詳細が含まれます。

詳細 意味
Location 違反を含むリクエストの構成要素です。 body
Error class 似た違反をまとめるための、安定した大分類です。 constraint_violation
Error detail エラークラス内の、省略可能な具体的な理由です。 number_not_in_range
Target 違反に関連する、省略可能なパラメーター、ヘッダー、Cookie、または JSON ボディのパスです。 $.items[0].quantity

他のフィールドだけで違反を説明できる場合、Error detail または Target は空になります。たとえば、リクエストボディが欠けている場合は、ターゲットなしの missing_required エラークラスになります。

可能なエラークラスと詳細は、Fields を参照してください。

検出を確認する

  1. Cloudflare ダッシュボードで Security > Analytics を開きます。

    Analytics を開く ↗
  2. Profile Analysis を開き、プロファイルを選択します。

  3. 選択した期間の準拠トレンドを確認します。

  4. サンプリングされた違反について、リクエストの構成要素と影響を受けたフィールドを調べます。

  5. 緩和を設定する前に、サンプリングされた各違反の理由を確認します。

  6. cf.schema_validation.learned.violated または cf.schema_validation.uploaded.violated で絞り込み、対応するソースを調べます。

違反を解釈する

準拠していないリクエストが、必ずしも悪意あるものではありません。リリース、新しいクライアント、正当なエッジケースでも違反が出ます。

プロファイルが利用可能になると、Cloudflare は 常時オンの検出 を実行します。検出自体はリクエストをブロックしません。

代表的なトラフィックを確認したら、Custom Rules でプロファイルを適用する を参照してください。

役に立ちましたか?