Cloudflare API Shield: スキーマ学習を週次待ちせずオンデマンドで走らせる
API Shield のスキーマ学習を、週次スケジュールを待たずダッシュボードから手動実行できる。代表トラフィックを流した直後の検証向き。しきい値(2xx 件数など)は従来どおり。
どんなときに使う?
- ステージングで代表リクエストを流したあと、すぐ学習結果を見たい
- 週次ランまで最大 7 日待つと検証サイクルが遅い
- エンドポイント追加直後に Schema Profile を早めに作りたい
やり方
- 対象オペレーションをプロファイル学習対象にしておく
- ダッシュボードで Web Assets → Operations
- オペレーション表の More options → Ad-hoc learn schema
- ダイアログで Run learning
- 実行は ゾーン全体(1 オペレーション単位ではない)
- 観測済みトラフィックを使う(Cloudflare がトラフィックを生成するわけではない)
- ダイアログにゾーンの学習ステータスと最終完了時刻が出る
- ゾーン全体が終わる前でも、オペレーション単位の Learned schema を見られる
学習に使うのは直近の 2xx トラフィック。フィールド学習はおおよそ 1,000 リクエスト、境界(数値範囲・文字列長など)はおおよそ 10,000 リクエストが目安(ドキュメントのしきい値)。
注意点
- しきい値未達のオペレーションは結果が出ない
- 学習結果をすぐ強制適用しない。レビューしてから検出・検証に進む
- 固定スキーマが欲しい場合は、学習結果を OpenAPI としてエクスポートしアップロードする選択肢もある