使用偵測工程代理
本指南適用於資安工程師和資安營運中心 (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.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
必要的規則管理和剖析器權限
必須具備下列權限,才能管理規則和剖析器:
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.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.toolUserroles/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 專業人員尋求解答。