從 CrowdStrike Detects API 遷移至 Alerts API

本節說明如何遷移設定,改用 Alerts API,並避免資料擷取作業中斷。

誰會受到影響?

如果您符合下列兩項條件,這項變更就會對您造成影響:

  • 您已使用 CrowdStrike Detection Cloud Monitoring API 連接器啟用資料動態饋給,並對應至 CS_DETECTS 記錄類型。
  • 您為這個動態饋給設定的 CrowdStrike API 用戶端沒有警報的讀取權限。

為避免服務中斷,請在 2025 年 9 月 30 日前完成下列任一程序。

選項 1:更新現有 CrowdStrike API 用戶端的權限 (建議)

這個方法只需要在 CrowdStrike Falcon 控制台中變更設定,對參照 CS_DETECTS 記錄類型的現有偵測規則影響最小。

開始之前,請先使用 Detects API 識別 API 用戶端。CrowdStrike 提供資訊主頁,協助您找出使用已淘汰端點的 API 用戶端。Google SecOps 偵測監控動態消息使用的 API 用戶端,其使用者代理程式字串會以 Google-Chronicle-Security 開頭。

如要設定及使用資訊主頁,請按照下列步驟操作:

  1. 前往 CrowdStrike 支援文章,然後下載頁面底部的 YAML 檔案,標題為「Planned Decommission of the detects API(September 30, 2025)」
  2. 在 Falcon 控制台中,依序前往「Next-Gen SIEM」 >「Log management」>「Dashboards」
  3. 在「建立資訊主頁」清單中,選取「建立新資訊主頁」新建
  4. 按一下「匯入資訊主頁」
  5. 匯入下載的 YAML 檔案。 YAML 檔案
  6. 在資訊主頁中,前往「呼叫已淘汰的 '/detects' API 端點」表格。這個表格會列出呼叫已淘汰端點的所有 API 用戶端 ID。
  7. 針對上一步驟中識別出的每個 API 用戶端 ID,授予警報的讀取權限,如圖片所示。 讀取權限
  8. 在 Falcon 控制台中,前往「OAuth2 API clients」(OAuth2 API 用戶端) 分頁標籤。您可能需要瀏覽多個頁面,才能找到特定用戶端 ID。
  9. 選取要修改的 API 用戶端,然後按一下「編輯 API 用戶端」
  10. 在「編輯 API 用戶端」表單的表格中,選取「快訊」的「讀取」核取方塊。 編輯 API 用戶端表單
  11. 按一下「更新客戶詳細資料」
  12. 確認變更,確保遷移作業順利完成。

    • 確認 Google SecOps 中的 CrowdStrike 動態饋給持續接收資料。
    • 30 分鐘後,再次查看 Falcon 管理中心的資訊主頁。資訊主頁應不會再記錄任何來自更新後用戶端 ID 的 Detects API 呼叫。

選項 2:建立及使用新的 CrowdStrike API 用戶端

如果您無法找出現有的 API 用戶端 ID,請使用這個選項。 CS_DETECTS 記錄類型的 Google SecOps 連接器會先自動嘗試使用 Alerts API。如果缺少必要權限,系統會使用 Detects API。建立具有正確權限的新用戶端,即可確保連接器使用新版警報 API。

  1. 在 CrowdStrike Falcon 控制台中,前往「OAuth2 API clients」(OAuth2 API 用戶端) 部分。
  2. 按一下「建立 API 用戶端」
  3. 在「建立 API 用戶端」表單的表格中,選取快訊的「讀取」核取方塊。
  4. 在「建立的 API 用戶端」表單中,複製「用戶端 ID」、「密碼」和「基本網址」欄位中的資訊。
  5. 在 Google SecOps 中,依序前往「SIEM 設定」>「動態消息」。
  6. 找出 CrowdStrike 偵測監控 (CS_DETECTS) 動態消息,然後按一下「編輯動態消息」
  7. 將現有憑證替換為您從 Falcon 控制台複製的用戶端 ID 和用戶端密鑰。
  8. 檢查動態饋給設定,然後按一下「提交」
  9. 針對所有 Google SecOps 執行個體中的每個 CS_DETECTS 資訊提供重複執行這些步驟。

確認變更

更新動態饋給後,請確認遷移作業是否成功:

  • 確認 Google SecOps 中的 CrowdStrike 動態饋給持續接收資料。
  • 按照建議方法所述,檢查 Falcon 控制台中的資訊主頁。 資訊主頁應不再註冊任何對偵測 API 的呼叫。

詳情請參閱官方 CrowdStrike 停用通知

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求答案。