使用偵測工程代理

本指南適用於資安工程師和資安營運中心 (SOC) 分析師,說明如何使用 Google SecOps 中採用 AI 輔助技術的偵測工程代理,評估及強化 Google Security Operations 資安態勢,防範新興和現有威脅。

您可以使用相容 AI 用戶端 (例如 Google Antigravity 或 Claude Code) 運作的 Model Context Protocol (MCP) 工具,存取代理。使用偵測工程代理,您可以擷取威脅情報並自動草擬 YARA-L 規則,進而縮短自訂安全性自動化作業的價值實現時間,並加速風險控管。

重要術語

  • 偵測工程代理:嵌入 Google SecOps 的 AI 輔助工程助理,由 AI 用戶端 (例如 Antigravity 或 Claude Code) 使用 MCP 工具操作。
  • Model Context Protocol (MCP):這項開放原始碼標準用於將 AI 應用程式連結至外部系統, Google Cloud 服務會使用這項標準,安全地將 AI 代理和應用程式連結至各種資料來源和基礎架構工具。
  • 威脅偵測機會 (TDO):正式的資料模型,用於識別、追蹤及排定潛在新偵測規則或分析的優先順序。
  • 合成事件:為模擬輸入 TDO 而產生的統合式資料模型 (UDM) 記錄。

事前準備

開始之前,請確認已滿足下列先決條件:

環境檢查 - AI 用戶端

您必須操作能與 MCP 工具互動的 AI 用戶端 (例如 Antigravity 或 Claude Code)。

必要角色和權限

本節列出人類使用者和服務帳戶所需的 Identity and Access Management (IAM) 權限,以及建議的預先定義角色。

所有主體使用者必要角色

呼叫偵測工程代理的主體必須具備下列角色:MCP 工具使用者和 Chronicle API 檢視者。請確保系統管理員為所有主體使用者更新這些角色。

詳情請參閱「設定 MCP」。

必要核心權限

必須具備下列權限,才能執行 Detection Engineering Agent:

  • chronicle.ade.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.operations.get

必要的規則管理和剖析器權限

必須具備下列權限,才能管理規則和剖析器:

  • chronicle.rules.list
  • chronicle.rules.get
  • chronicle.rules.verify
  • chronicle.rules.create
  • chronicle.rules.update
  • chronicle.ruleDeployments.get
  • chronicle.ruleDeployments.update
  • chronicle.parsers.list
  • chronicle.parsers.get
  • chronicle.logTypes.list

必要的遠端 MCP 伺服器和專案服務使用權限

如要呼叫遠端 MCP 伺服器,並使用 MCP 工具的專案服務,必須具備下列權限:

  • mcp.tools.call (由roles/mcp.toolUser角色授予)
  • serviceusage.services.use (由 roles/serviceusage.serviceUsageConsumer 角色授予)

下列預先定義的角色可為人類使用者和服務帳戶提供必要權限:

  • roles/chronicle.admin (或 roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/serviceusage.serviceUsageConsumer

設定 MCP 伺服器

如要建立 settings.json 檔案,請參閱「設定 MCP」。收集必要的值後,請確認 settings.json 檔案的內容如下所示:

{
  "name": "my_extension_name",
  "version": "1.0.0",
  "mcpServers": {
    "GoogleSecOps": {
      "httpUrl": "https://us-chronicle.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform",
          "https://www.googleapis.com/auth/chronicle"
        ]
      },
      "timeout": 300000,
      "headers": {
        "x-goog-user-project": "my-cloud-project-name"
      }
    }
  }
}

設定脈絡檔案

首先,請設定情境檔案,確保 Gemini 針對每項要求指定正確的 Google SecOps 執行個體。

為保持輕量,Google 建議您先在 GEMINI.md 檔案中加入下列內容,然後再開始建構。將預留位置值替換為 Google SecOps 執行個體和環境的正確資訊:

When using the Google SecOps MCP server, use these parameters for EVERY request: Customer ID: aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa Region: us Project ID: my-cloud-project-name

設定技能,與工具互動

Google 強烈建議使用 detection-engineering-coverage-evaluation 技能與工具互動。這項技能可防止 AI 摘要或縮寫重要的工具輸出內容。

這項技能內建為 detection-engineering-coverage-evaluation,並公開託管於 Google Agent Skills GitHub 存放區。

主要功能

本節說明 Detection Engineering Agent 提供的威脅分析和規則生成重要功能。

產生威脅偵測機會

generate_threat_detection_opportunity 工具會從來源 (例如資安網誌和內部發現項目) 擷取並充實原始威脅情報,建立優先處理的 TDO 供分析。這個步驟產生的 TDO 會提供給後續的偵測工程代理步驟,用於評估現有規則涵蓋範圍或生成新規則。

  • 如要使用 generate_threat_detection_opportunity 工具,請指示 Gemini 使用 curl 擷取文字,或將威脅報告中的原始文字複製並貼到工具中。

生成合成事件

如要為 TDO 產生合成事件,Google SecOps 執行個體必須已擷取原始記錄,且至少有一個支援的記錄類型有作用中的剖析器。

支援的記錄類型

合成事件生成功能支援下列八種記錄類型:

類別 供應商或產品 記錄類型
端點偵測和應變 (EDR) CrowdStrike Falcon CS_EDR
端點偵測和應變 (EDR) Microsoft Defender for Endpoint MICROSOFT_DEFENDER_ENDPOINT
端點偵測和應變 (EDR) SentinelOne EDR SENTINEL_EDR
防毒軟體和端點 Windows Defender ATP WINDOWS_DEFENDER_ATP
DNS Zscaler DNS ZSCALER_DNS
Google Cloud Google Workspace 活動 WORKSPACE_ACTIVITY
身分與存取權管理 Okta OKTA
軟體式服務 (SaaS) 應用程式 Microsoft 365 (Office 365) OFFICE_365

評估涵蓋率

偵測工程代理會檢查 Google SecOps 執行個體中的現有規則,是否會觸發透過事件模擬擷取的模擬事件。如果有任何規則與模擬事件相符,工具會傳回相符的規則 ID 和涵蓋範圍結果中繼資料。如果沒有相符的規則,系統會傳回空白結果,表示涵蓋範圍有缺口。

生成規則草稿

偵測工程代理會根據使用者輸入內容或自然語言,建立 YARA-L 規則草稿,將偵測邏輯編碼,解決涵蓋率評估期間發現的缺口。使用 detection-engineering-coverage-evaluation 技能時,代理只會為沒有相符規則的 TDO 生成規則草稿,且只會在所有 TDO 的涵蓋範圍評估完成後才生成。避免針對現有規則已涵蓋的威脅建立重複規則。

generate_rules 工具不會自動將規則草稿新增至 Google SecOps 執行個體。查看規則草稿後,您可以透過下列任一方式新增規則:

  • 使用 AI 用戶端:detection-engineering-coverage-evaluation 技能會提示您核准或拒絕每項規則草稿。對於您核准的每項規則,AI 用戶端會呼叫 Google SecOps MCP 伺服器上的 create_rule 工具,在執行個體中建立規則。
  • 手動建立規則:從工具輸出內容複製規則文字,然後在規則編輯器中建立規則。

疑難排解

請參考下表,自行修正評估程序中的常見問題:

問題 說明 修正
工具故障 generate_synthetic_events 工具一再失敗。 確認 TDO 至少包含一種支援的記錄類型,且 Google SecOps 執行個體已擷取原始記錄,並具備該記錄類型的有效剖析器。否則,請略過該 TDO 的合成事件生成作業,並繼續處理其餘 TDO。
摘要錯誤 AI 會在執行期間縮寫記錄類型或採取捷徑。 確認 detection-engineering-coverage-evaluation 技能正在與系統互動。

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