如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Daybreak 通知

將 Daybreak 掃描事件傳送至工作區 webhook。

你可以透過工作區 webhook,將掃描事件傳送到你管理的服務。例如,你可以在掃描結束時更新資安儀表板,或在掃描結果變更時更新工單。每個目的地都會接收整個 ChatGPT 工作區中符合你為該目的地所選類型的事件。

新增工作區 webhook

  1. 在 Daybreak 中,前往 設定 > 通知,然後選取 新增。

  2. 輸入 名稱 和 端點 URL。請使用可從公用網際網路存取的 HTTPS 端點,且該端點必須能在連接埠 443 接收 POST 請求。

  3. 選擇要接收的事件類型。

    • 掃描已結束(scan.finished)會在掃描完成、失敗或取消時發出通知。
    • 掃描已更新(scan.updated)會在掃描結果後續有變更時發出通知,例如驗證結果或嚴重程度有所變更。
  4. 選取 新增。複製簽署密鑰並妥善保存。Daybreak 只會顯示一次完整密鑰。

  5. 在目的地的選單中,選取 傳送測試通知,再選取 傳送測試。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 會同時使用新舊兩把密鑰簽署請求,因此接收端可以使用任一把密鑰驗證請求。如果選擇立即輪替,請先更新接收端,再傳送新的測試通知。