Webhookを使用したワークロードセキュリティ通知
変更を提案
PDF
Webhook を使用すると、ユーザーはカスタマイズされた Webhook チャネルを使用して、さまざまなアプリケーションに重大なアラート通知や警告アラート通知を送信できます。
多くの商用アプリケーションは、Slack、PagerDuty、Teams、Discord など、標準の入力インターフェースとして Webhook をサポートしています。汎用的でカスタマイズ可能な Webhook チャネルをサポートすることで、Workload Security はこれらの配信チャネルの多くをサポートできます。 Webhook の設定に関する情報は、それぞれのアプリケーションの Web サイトで確認できます。例えば、Slackは"この便利なガイド"。
複数の Webhook チャネルを作成し、各チャネルを異なる目的、個別のアプリケーション、異なる受信者などを対象にすることができます。
Webhookチャネルインスタンスは次の要素で構成されています
| Name | 説明 |
|---|---|
URL |
Webhook ターゲット URL（URL パラメータとともに http:// または https:// プレフィックスを含む） |
方法 |
GET/POST - デフォルトはPOST |
カスタムヘッダー |
ここでカスタムヘッダーを指定します |
メッセージ本文 |
メッセージの本文をここに入力してください |
デフォルトのアラートパラメータ |
Webhookのデフォルトパラメータを一覧表示します |
カスタムパラメータとシークレット |
カスタムパラメータとシークレットを使用すると、固有のパラメータやパスワードなどの安全な要素を追加できます。 |
Webhookの作成
Workload Security Webhook を作成するには、「管理」>「通知」に移動し、「Workload Security Webhooks」タブを選択します。次の画像は、Slack Webhook 作成画面のサンプルを示しています。
注意: Workload Security Webhook を作成および管理するには、ユーザーは Workload Security Admin である必要があります。
-
各フィールドに適切な情報を入力し、「保存」をクリックします。
-
「Webhook のテスト」ボタンをクリックして接続をテストすることもできます。これにより、選択したメソッドに従って、定義された URL に「メッセージ本文」（置換なし）が送信されることに注意してください。
-
SWS Webhook は、いくつかのデフォルト パラメータで構成されています。さらに、独自のカスタム パラメータまたはシークレットを作成することもできます。
パラメーター: パラメーターとは何か、どのように使用するのか?
アラート パラメータは、アラートごとに設定される動的な値です。たとえば、%%severity%% パラメータは、アラートの重大度タイプに置き換えられます。
「Test Webhook」ボタンをクリックしたときには置換は実行されないことに注意してください。テストでは、パラメータのプレースホルダー (%%<param-name>%%) を表示するペイロードが送信されますが、データに置き換えられることはありません。
カスタムパラメータとシークレット
このセクションでは、必要なカスタム パラメータやシークレットを追加できます。カスタム パラメータまたはシークレットは、URL またはメッセージ本文に含めることができます。シークレットを使用すると、ユーザーはパスワード、apiKey などの安全なカスタム パラメータを設定できます。
次のサンプル画像は、Webhook の作成時にカスタム パラメータがどのように使用されるかを示しています。
ワークロード セキュリティ Webhook リスト ページ
Webhook リスト ページには、名前、作成者、作成日、ステータス、セキュリティ、最終報告のフィールドが表示されます。注: 「ステータス」列の値は、最後の Webhook トリガーの結果に基づいて変化し続けます。以下はステータス結果の例です。
ステータス |
説明 |
OK |
通知を正常に送信しました。 |
403 |
禁止されています。 |
404 |
URLが見つかりません。 |
400 |
要求の形式が正しくありません。メッセージ本文にエラーがある場合、このステータスが表示されることがあります。例:
|
410 |
リソースは利用できなくなりました |
「最終報告」列には、Webhook が最後にトリガーされた時刻が示されます。
ウェブフック一覧ページから、ユーザーはウェブフックを編集/複製/削除することもできます。
アラートポリシーでWebhook通知を構成する
アラート ポリシーに Webhook 通知を追加するには、「ワークロード セキュリティ」>「ポリシー」に移動し、既存のポリシーを選択するか、新しいポリシーを追加します。 アクション セクション > Webhook 通知 ドロップダウンで、必要な Webhook を選択します。
Webhook 通知はポリシーに関連付けられています。攻撃 (RW/DD/WARN) が発生すると、設定されたアクション (スナップショットの取得/ユーザーのブロック) が実行され、関連する Webhook 通知がトリガーされます。
注: 電子メール通知はポリシーとは無関係であり、通常どおりトリガーされます。
-
ポリシーが一時停止されている場合、Webhook 通知はトリガーされません。
-
複数の Webhook を 1 つのポリシーにアタッチできますが、ポリシーにアタッチする Webhook は 5 つ以下にすることをお勧めします。