你可以透過工作區 webhook,將掃描事件傳送到你管理的服務。例如,你可以在掃描結束時更新資安儀表板,或在掃描結果變更時更新工單。每個目的地都會接收整個 ChatGPT 工作區中符合你為該目的地所選類型的事件。
新增工作區 webhook
-
在 Daybreak 中,前往 設定 > 通知,然後選取 新增。
-
輸入 名稱 和 端點 URL。請使用可從公用網際網路存取的 HTTPS 端點,且該端點必須能在連接埠 443 接收
POST請求。 -
選擇要接收的事件類型。
- 掃描已結束(
scan.finished)會在掃描完成、失敗或取消時發出通知。 - 掃描已更新(
scan.updated)會在掃描結果後續有變更時發出通知,例如驗證結果或嚴重程度有所變更。
- 掃描已結束(
-
選取 新增。複製簽署密鑰並妥善保存。Daybreak 只會顯示一次完整密鑰。
-
在目的地的選單中,選取 傳送測試通知,再選取 傳送測試。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 每次嘗試傳送事件時,最多會等待 10 秒,測試通知也適用此時限。服務接受事件後,請在時限內回傳 2xx 回應。如果處理時間較長,請先將事件存入佇列,回應後再處理。
管理目的地與輪替密鑰
在目的地的選單中選取 編輯。你可以變更 URL、選擇其他事件類型,或關閉 已啟用 以暫停傳送。若要更換簽署密鑰,請選取 輪替密鑰。複製新密鑰,並更新接收端的設定。如果接收端需要時間切換密鑰,請在輪替時選取 讓目前的密鑰保持有效 24 小時。在這段期間,Daybreak 會同時使用新舊兩把密鑰簽署請求,因此接收端可以使用任一把密鑰驗證請求。如果選擇立即輪替,請先更新接收端,再傳送新的測試通知。