ワークスペースの Webhook を使うと、自分で管理するサービスにスキャンイベントを送信できます。たとえば、スキャンが終了したときにセキュリティダッシュボードを更新したり、スキャン結果が変わったときにチケットに変更を反映したりできます。各送信先には、ChatGPT ワークスペース全体で発生したイベントのうち、その送信先で受け取るように選択した種類のイベントが届きます。
ワークスペースの Webhook の追加
-
Daybreak で 設定 > 通知 を開き、追加 を選択します。
-
名前 と エンドポイント URL を入力します。インターネットからアクセスでき、ポート 443 で
POSTリクエストを受け付ける HTTPS エンドポイントを指定してください。 -
受け取るイベントを選択します。
- スキャン終了(
scan.finished)は、スキャンの完了、失敗、キャンセルを通知します。 - スキャン更新(
scan.updated)は、検証結果や重大度の更新など、スキャン結果に後から加わった変更を通知します。
- スキャン終了(
-
追加 を選択します。署名用シークレットをコピーし、安全な場所に保管してください。Daybreak がシークレットの全体を表示するのはこのときの 1 回だけです。
-
送信先のメニューで テスト通知を送信 を選択し、次に テストを送信 を選択します。Daybreak は
is_test: trueを含むscan.finishedイベントのサンプルを送信します。エンドポイントが2xxレスポンスを返すと、Daybreak に配信成功と表示されます。
配信されたイベントの検証と処理
Daybreak は HMAC-SHA256 で署名した JSON 形式の POST リクエストを送信します。署名の対象は webhook-id、webhook-timestamp、元のリクエスト本文です。イベントを処理する前に、webhook-signature ヘッダーを使ってリクエストを検証してください。空白や JSON の書式が変わると署名の検証に失敗するため、リクエスト本文は受信したバイト列のまま検証処理に渡してください。詳しくは、Standard Webhooks の仕様を参照してください。各言語で使える検証ライブラリは、Standard Webhooks のリファレンス実装を参照してください。
本番のワークフローを起動する前に、is_test を確認してください。ペイロードの id で同じイベントの再配信を識別でき、data.scan_id で同じスキャンのイベントをまとめることができます。テスト配信を含め、Daybreak の配信 1 回あたりの応答期限は 10 秒です。サービスがイベントを受け付けたら、この時間内に 2xx レスポンスを返してください。処理に時間がかかる場合は、イベントをキューに保存し、レスポンスを返してから処理してください。
送信先の管理とシークレットのローテーション
送信先のメニューで 編集 を選択します。URL や受け取るイベントを変更できます。配信を一時停止するには、有効 をオフにします。署名用シークレットを変更するには、シークレットをローテーション を選択します。新しいシークレットをコピーし、受信側の設定を更新してください。受信側の切り替えに時間が必要な場合は、ローテーション時に 現在のシークレットを 24 時間有効にする を選択します。この間、Daybreak は両方のシークレットで署名するため、受信側はどちらのシークレットでも配信を検証できます。シークレットを即時に切り替える場合は、次のテスト通知を送信する前に受信側の設定を更新してください。