Web Assets は、Cloudflare でプロキシされる Web アプリケーション内のオペレーションを自動で検出します。オペレーションのコンテキストを使うと、アプリケーション固有の機能に対するセキュリティ保護を定義できます。
たとえば、LLM プロンプトを受け取るオペレーションを検出し、AI Security for Apps でプロンプトインジェクションを抑止するなどの、対象を絞った保護を定義できます。
Cloudflare ダッシュボードで Web Assets にアクセスするには、Web Assets ページを開きます。
Web assets を開く ↗オペレーションは、アプリケーション内で同じ目的を果たす HTTP リクエストのグループです。各オペレーションは次で定義されます。
- HTTP メソッド
- ホスト名パターン
- パスパターン
たとえば、Web Assets は商品詳細ページへのリクエストを 1 つのオペレーションにまとめられます。
GET example.com/products/{var1}このオペレーションは、次のようなリクエストに一致します。
GET https://example.com/products/shoes
GET https://example.com/products/hats
GET https://example.com/products/jacketsこれにより、Cloudflare はアプリケーション内で同じ目的を果たすリクエストを識別できます。
オペレーションの取得元はいくつかあります。
- 検出(Discovery): Web Assets はプロキシされた HTTP トラフィックを継続的に確認し、機械学習(API Discovery 向け)とヒューリスティックで、似たリクエストをオペレーションにグループ化します。
- 手動追加(Manual entry): メソッド、ホスト名パターン、パスパターンでオペレーションを追加できます。
- スキーマのアップロード(Schema upload): OpenAPI スキーマをアップロード し、既存の API 定義からオペレーションを作成できます。
これらの方法は、同じオペレーションインベントリに反映されます。セキュリティ検出がオペレーションコンテキストを使う前に、検出されたすべてのオペレーションを確認する必要はありません。
オペレーションは candidate、shadow、full のいずれかの状態になります。これらの状態は、オペレーションのマッチングと利用できる機能を制御します。
オペレーションの状態だけでは、プロファイル学習は始まりません。Schema Profile を学習するには、オペレーションのオーバーフローメニューから Learn profile を選びます。
プロファイルのライフサイクルは Application Profiles を参照してください。アップロードした OpenAPI スキーマについては Schema Validation を参照してください。
ラベル は、オペレーションが何をするかを記述します。ログインフロー、サインアップフロー、AI を使うオペレーション、その他のユースケースなどです。
Cloudflare はマネージドラベルを定義します。一部のマネージドラベルは自動検出できますが、現在はすべてのマネージドラベルが自動検出されるわけではありません。
カスタムラベルは、独自のワークフロー向けにオペレーションを整理できます。Cloudflare のセキュリティ検出向けのマネージドラベルの代わりにはなりません。
セキュリティ検出は Web Assets を使い、シグナルが意味を持つオペレーションに焦点を当てられます。たとえば AI Security for Apps は、cf-llm マネージドラベルを使い、AI を使うオペレーションへのリクエストをスキャンします。詳細は セキュリティ保護を定義する を参照してください。
関連する API Shield の機能
Web Assets は HTTP リクエストのオペレーションに焦点を当てます。スキーマ検証、スキーマ学習、相互 TLS、JWT 検証などの API 固有の保護については API Shield を参照してください。