Skip to content

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

エンドポイント管理

最終更新 Markdown で表示Agent セットアップ
すべてのプランで利用できます

エンドポイント管理の内容は、現行の Web Assets ダッシュボードを使います。API エンドポイント を管理するには、Web Assets > Operations に移動します。

オペレーションは、HTTP メソッド、ホスト名パターン、パスパターンで識別されるエンドポイントを指す Cloudflare の用語です。Web Assets はオペレーションを継続的に検出します。手動で追加することもできます。

Cloudflare が検出したオペレーションは、インベントリに追加されるだけです。プロファイル学習を始めるには、対象のオペレーションで Learn profile を選択します。

アクセス

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

    Web assets を開く ↗

  2. Operations タブに移動します。

検出されたオペレーションを確認する

Web Assets は、検出したオペレーションを継続的にインベントリへ追加します。検出だけではプロファイル学習は始まりません。

候補オペレーションは、マッチング、エッジでのセキュリティ検出、Sequence Analytics のコンテキストになります。検出されたオペレーションをすべて変更する必要はありません。

スキーマ検証からオペレーションを追加する

  1. Web Assets > Operations で、Add operation を選択します。
  2. Upload schema を選択します。
  3. スキーマファイルをアップロードします。
  4. Add schema and endpoints を選択します。

API Shield は、同じホスト名、メソッド、パスを持つ重複オペレーションを探します。重複オペレーションは追加されません。

オペレーションを手動で追加する

  1. Web Assets > Operations で、Add operation を選択します。
  2. Manually add を選択します。
  3. メソッドを選択し、ホスト名パターンとパスパターンを入力します。
  4. Add operation を選択します。

オペレーションを手動で追加するときは、パスまたはホスト名に変数フィールドを指定できます。変数は中かっこで囲みます。例: /api/user/{var1}/details または {hostVar1}.example.com。

Cloudflare は、次の形式のホスト名変数に対応しています。


{hostVar1}.example.com

foo.{hostVar1}.example.com

{hostVar2}.{hostVar1}.example.com

ホスト名変数はドメインフィールド全体を占める必要があり、同じフィールド内のほかのテキストと併用できません。

次の形式はサポートしていません。


foo-{hostVar1}.example.com

API Shield での変数の使いかたの詳細は、API Discovery の例を参照してください。

オペレーションを編集する

オペレーションの識別情報を編集できます。

  1. Web Assets > Operations で、対象オペレーションの行アクションを開きます。
  2. Edit operation を選択します。
  3. HTTP メソッド、ホスト名パターン、またはパスパターンを更新します。
  4. Save を選択します。

プロファイル学習を開始する

オペレーションの識別情報を確認してから、プロファイル学習を開始します。

  1. Web Assets > Operations で、オペレーションのオーバーフローメニューを開きます。
  2. Learn profile を選択します。
  3. プロファイルが利用可能になったら、もう一度オーバーフローメニューを開きます。
  4. View details を選択し、Security overview を確認します。

学習の要件、アナリティクス、適用については、Application Profiles を参照してください。

オペレーションを手動で削除する

エンドポイントは 1 件ずつ、または一括で削除できます。

  1. Web Assets > Operations で、削除するオペレーションを選択します。
  2. Delete operations を選択します。

オペレーション分析

full 状態の各オペレーションでは、次の項目を確認できます。

  • リクエスト数: そのオペレーションへのリクエスト総数の推移です。
  • レート制限の推奨値: 10 分あたり。リクエスト数を目安に算出します。
  • レイテンシ: オリジンの平均応答時間（ミリ秒）。訪問者がリクエストしてから、オリジンからの応答を受け取るまでの時間です。
  • エラー率 と全体トラフィックの比較: 4xx、5xx、およびその合計でグループ化します。
  • レスポンスサイズ: リクエストに返すレスポンスの平均サイズ（バイト）です。
  • ラベル: そのオペレーションに現在割り当てられている ラベル です。
  • 認証状態: このオペレーションへの成功リクエストで観測されたセッション識別子です。
  • シーケンス: そのオペレーションを含む Sequence Analytics のシーケンス数です。

Cloudflare API を使う

Cloudflare API でオペレーションを管理できます。詳細は、operations API のドキュメント を参照してください。

Sensitive Data Detection

機密データには、さまざまな個人を特定できる情報や金融データが含まれます。Cloudflare はこのルールセットを、よくあるデータ漏洩の脅威に対処するために作成しました。WAF は、オリジンからの HTTP レスポンスボディ内でこのデータを検索できます。

API Shield は、full 状態のオペレーションのレスポンスに機密データがあると通知します。ゾーンに Sensitive Data Detection マネージドルールセット も必要です。

Sensitive Data Detection は、Advanced application security プランの Enterprise のお客様が利用できます。

Sensitive Data Detection を有効にすると、API Shield は過去 7 日間の WAF イベントを照会します。Web Assets は、機密レスポンスに一致したオペレーションに印を付けます。

オペレーションの詳細を開き、検出された機密データの種類を確認します。一致したイベントを Security Events で見るには、Explore Events を選択します。

ゾーンで Sensitive Data Detection を有効にしたあと、Sensitive Data Detection ルールセットを閲覧 ↗ できます。Sensitive Data Detection が有効でない場合、このリンクは機能しません。

制限事項

レイテンシなどの一部のパフォーマンスメトリクスは、Cloudflare のサービスがリクエストをオリジンサーバーへ直接渡せない形で処理した場合、サポートされません。

この制限は、特に次の場合に発生します。

  • その URL パスで Cloudflare Worker が動作している。
  • Workers の上に構築されたほかの製品（Waiting Room など）がアプリケーションで有効になっている。

これらの状況では、オリジンの応答時間を正確に計測できないため、ダッシュボードにメトリクスは表示されません。

役に立ちましたか？