Webhooks

CASB Webhook を使うと、Cloudflare One のポスチャ検出インスタンスを、チャットプラットフォーム、チケットシステム、SIEM、SOAR ツール、独自の自動化サービスなど、外部システムへ送れます。

Webhook の送信先を設定したあと、Webhooks ページから配信テストを実行できます。検出詳細のワークフローから、ポスチャ検出インスタンスを直接送ることもできます。

前提条件

Cloudflare が受け付ける送信先 URL は、https:// を使い、かつ公開到達できるものだけです。localhost、ループバック、プライベート、その他予約済みアドレスに解決される URL は拒否されます。

CASB Webhook は、次の認証方式に対応します。

新しい Webhook を保存する前、または既存の Webhook を更新したあと、Test delivery で設定した送信先へテストリクエストを送れます。

テストが成功すると、Cloudflare が送信先 URL に到達し、送信先がレスポンスを返したことを示します。

配信テストでは、ご利用環境のライブ検出インスタンスは送りません。

既存の Webhook を更新する手順は次のとおりです。

Webhook のオン／オフは、Webhooks ページのステータストグルで切り替えます。

Webhook を削除するには、Webhook のメニューを開き、Delete を選びます。

既存の Webhook を編集するとき、Cloudflare は保存済みのヘッダー値や署名用シークレットを表示しません。保存済みの値を置き換えるには、新しい値を入力して、もう一度 Webhook を保存します。

Webhook の送信先を 1 つ以上設定したあと、検出ワークフローからポスチャ検出インスタンスを直接送れます。

Cloudflare は Webhook 送信をバックグラウンドでキューに入れます。成功メッセージは、Cloudflare が配信リクエストを受け付けたことを意味します。

検出ワークフローの詳細は、検出を管理するを参照してください。

該当する検出に対して、1 件ずつ手動で送らずに Webhook を自動送信するには、修復ポリシーを参照してください。

CASB は、ポスチャ検出インスタンスを表す JSON ペイロードを送ります。

Webhook ペイロードには、イベントのメタデータ、検出の詳細、アセットの詳細、検出インスタンスに紐づく追加メタデータが含まれます。正確な内容は連携と検出タイプによって異なります。

Webhook ペイロードには、トップレベルの id、type、metadata、data オブジェクトがあります。

検出によっては、metadata オブジェクトにアクター、送信先、送信時刻、ペイロードバージョンなどのイベント詳細が含まれます。

data オブジェクトには、検出の詳細、アセットの詳細、検出インスタンスに紐づく追加メタデータが含まれます。

ダウンストリームのシステムが独自スキーマを期待する場合は、最終送信先へ転送する前にペイロードを変換する中間サービスまたはワークフローエンジンへ Webhook を送ってください。

Webhook のテストまたは配信が失敗した場合は、次を確認します。