Skip to content

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

Web Assets

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

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 はアプリケーション内で同じ目的を果たすリクエストを識別できます。

Cloudflare がオペレーションを識別する方法

オペレーションの取得元はいくつかあります。

  • 検出(Discovery): Web Assets はプロキシされた HTTP トラフィックを継続的に確認し、機械学習(API Discovery 向け)とヒューリスティックで、似たリクエストをオペレーションにグループ化します。
  • 手動追加(Manual entry): メソッド、ホスト名パターン、パスパターンでオペレーションを追加できます。
  • スキーマのアップロード(Schema upload): OpenAPI スキーマをアップロード し、既存の API 定義からオペレーションを作成できます。

これらの方法は、同じオペレーションインベントリに反映されます。セキュリティ検出がオペレーションコンテキストを使う前に、検出されたすべてのオペレーションを確認する必要はありません。

オペレーションの状態とプロファイル学習

オペレーションは candidateshadowfull のいずれかの状態になります。これらの状態は、オペレーションのマッチングと利用できる機能を制御します。

オペレーションの状態だけでは、プロファイル学習は始まりません。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 を参照してください。

役に立ちましたか?