テック技報最新号へ →
インフラ

Cloudflare API Shield: スキーマ学習を週次待ちせずオンデマンドで走らせる

API Shield のスキーマ学習を、週次スケジュールを待たずダッシュボードから手動実行できる。代表トラフィックを流した直後の検証向き。しきい値(2xx 件数など)は従来どおり。

@CFchangelog · 投稿 2026-10-12
#infra#cloudflare#api-shield#waf#security

どんなときに使う?

  • ステージングで代表リクエストを流したあと、すぐ学習結果を見たい
  • 週次ランまで最大 7 日待つと検証サイクルが遅い
  • エンドポイント追加直後に Schema Profile を早めに作りたい

やり方

  1. 対象オペレーションをプロファイル学習対象にしておく
  2. ダッシュボードで Web Assets → Operations
  3. オペレーション表の More options → Ad-hoc learn schema
  4. ダイアログで Run learning
  • 実行は ゾーン全体(1 オペレーション単位ではない)
  • 観測済みトラフィックを使う(Cloudflare がトラフィックを生成するわけではない)
  • ダイアログにゾーンの学習ステータスと最終完了時刻が出る
  • ゾーン全体が終わる前でも、オペレーション単位の Learned schema を見られる

学習に使うのは直近の 2xx トラフィック。フィールド学習はおおよそ 1,000 リクエスト、境界(数値範囲・文字列長など)はおおよそ 10,000 リクエストが目安(ドキュメントのしきい値)。

注意点

  • しきい値未達のオペレーションは結果が出ない
  • 学習結果をすぐ強制適用しない。レビューしてから検出・検証に進む
  • 固定スキーマが欲しい場合は、学習結果を OpenAPI としてエクスポートしアップロードする選択肢もある

出典

X の元の投稿を開く