Skip to content

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

オペレーションのラベル

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

ラベルはオペレーションにユースケースの文脈を付けます。セキュリティ検出はラベルを使い、特定のアプリケーション用途のトラフィックに焦点を当てられます。

マネージドラベル

マネージドラベルは Cloudflare が定義します。ログインフロー、サインアップフロー、AI を使ったオペレーションなど、一般的なオペレーション種別を識別します。

一部のマネージドラベルは自動検出できます。自動検出は現在、一部のマネージドラベルと一部のプランにだけ適用されます。

利用できるマネージドラベルは次のとおりです。

ラベル 説明
cf-api-endpoint 機械可読なデータを提供する、またはプログラムからの操作を仲介するオペレーション。
cf-llm Large Language Model(LLM)を使ったサービスへのリクエストを受け取るオペレーション。
cf-mcp AI ツールとデータアクセス向けの Model Context Protocol(MCP) を実装するオペレーション。
cf-contains-ads 広告を含む Web ページを返すオペレーション。
cf-log-in ユーザー認証情報を受け付けるオペレーション。
cf-sign-up ユーザーアカウントを作成するオペレーション。
cf-content 商品詳細、レビュー、価格など、固有のコンテンツを提供するオペレーション。
cf-purchase 購入を完了するオペレーション。
cf-password-reset パスワードリセットフローに関与するオペレーション。
cf-add-cart カートに商品を追加する、または在庫を確認するオペレーション。
cf-add-payment クレジットカードや銀行口座の情報を受け付けるオペレーション。
cf-check-value ポイント、ゲーム内通貨、その他の残高を確認するオペレーション。
cf-add-post メッセージ、レビューなど、ユーザー生成コンテンツを投稿するオペレーション。
cf-account-update ユーザーアカウントまたはプロフィール情報を更新するオペレーション。
cf-rss-feed RSS クライアントからのトラフィックを想定するオペレーション。
cf-web-page HTML ページを返すオペレーション。

利用できる検出

一部の検出は、検査するオペレーションを決めるためにラベルを使います。オペレーションラベルを使える検出は次のとおりです。

ラベル 関連する検出
cf-llm AI Security for Apps
cf-log-in Leaked credentials detectionAccount abuse protection
cf-sign-up Account abuse protection

一部の検出では、製品固有の設定が別途必要な場合があります。一連の手順は セキュリティ保護を定義する を参照してください。

カスタムラベル

カスタムラベルは、オーナー、アプリケーション、環境、業務フローなどでオペレーションを整理するのに役立ちます。

ラベルを適用する

Web Assets からオペレーションにラベルを適用します。

  1. Cloudflare ダッシュボードで、Web Assets ページを開きます。

    Web assets を開く ↗
  2. ラベルを付けたいオペレーションを選択します。

  3. Edit labels を選択します。

  4. 適用するマネージドラベルまたはカスタムラベルを選択します。

  5. Save labels を選択します。

分析とログでラベルを使う

一致したオペレーションとマネージドラベルは Security Analytics で確認できます。このデータはクエリやエクスポートもできます。

GraphQL Analytics API

一致したオペレーションとマネージドラベルのデータは、GraphQL Analytics API でクエリできます。webAssetsOperationIdwebAssetsLabelsManaged フィールドは、httpRequestsAdaptive および httpRequestsAdaptiveGroups データセットで利用できます。

webAssetsLabelsManaged は、リクエストあたり最大 10 個のラベルを返します。

次のクエリは、cf-llm マネージドラベルが付いたトラフィックについて、オペレーション ID とマネージドラベルの組み合わせごとのリクエスト数を返します。

query GetAdaptiveGroups($zoneTag: string, $start: DateTime!, $end: DateTime!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			httpRequestsAdaptiveGroups(
				filter: {
					datetime_geq: $start
					datetime_leq: $end
					requestSource: "eyeball"
					webAssetsLabelsManaged_hasany: ["cf-llm"]
				}
				limit: 25
				orderBy: [count_DESC]
			) {
				count
				dimensions {
					webAssetsOperationId
					webAssetsLabelsManaged
				}
			}
		}
	}
}

cf-llm を別の マネージドラベル に置き換えてください。ディメンションを webAssetsOperationId だけにして、一致したオペレーションごとにトラフィックを集計することもできます。

Logpush

リクエスト単位の Web Assets データは、Logpush でストレージまたは SIEM システム にエクスポートできます。WebAssetsOperationIDWebAssetsLabelsManaged フィールドは HTTP requests データセット で利用できます。

役に立ちましたか?