Detection Engineering Agent verwenden
Dieser Leitfaden richtet sich an Sicherheitstechniker und SOC-Analysten, die ihren Google Security Operations-Sicherheitsstatus gegenüber neuen und bestehenden Bedrohungen mithilfe des KI-gestützten Detection Engineering Agent in Google SecOps bewerten und verbessern möchten.
Sie können auf den Agenten über MCP-Tools (Model Context Protocol) zugreifen, die von kompatiblen KI-Clients (z. B. Google Antigravity oder Claude Code) ausgeführt werden. Mit dem Detection Engineering Agent können Sie Threat Intelligence extrahieren und automatisch YARA-L-Regeln erstellen. Dadurch wird die Time-to-Value für benutzerdefinierte Sicherheitsautomatisierung verbessert und die Risikominderung beschleunigt.
Schlüsselterminologie
- Detection Engineering Agent: Ein KI-basierter Engineering-Assistent, der in Google SecOps eingebettet ist und von KI-Clients (z. B. Antigravity oder Claude Code) über MCP-Tools bedient wird.
- Model Context Protocol (MCP): Ein Open-Source-Standard zum Verbinden von KI-Anwendungen mit externen Systemen, der in allen Google Cloud -Diensten verwendet wird, um KI-Agenten und ‑Anwendungen sicher mit verschiedenen Datenquellen und Infrastrukturtools zu verbinden.
- Threat Detection Opportunity (TDO): Ein formalisiertes Datenmodell, das entwickelt wurde, um potenzielle neue Erkennungsregeln oder Analysen zu identifizieren, zu verfolgen und zu priorisieren.
- Synthetische Ereignisse: UDM-Logs (Unified Data Model), die generiert werden, um ein Eingabe-TDO zu simulieren.
Hinweis
Bevor Sie beginnen, sollten Sie prüfen, ob die folgenden Voraussetzungen erfüllt sind:
Umgebungsprüfung – KI-Client
Sie müssen einen KI-Client (z. B. Antigravity oder Claude Code) betreiben, der mit MCP-Tools interagieren kann.
Erforderliche Rollen und Berechtigungen
In diesem Abschnitt werden die erforderlichen IAM-Berechtigungen (Identity and Access Management) und die empfohlenen vordefinierten Rollen für menschliche Nutzer und Dienstkonten aufgeführt.
Erforderliche Rollen für alle Hauptnutzer
Jedes Hauptkonto, das den Detection Engineering-Agent aufruft, muss die folgenden Rollen haben: MCP Tool User und Chronicle API Viewer. Sorgen Sie dafür, dass ein Systemadministrator diese Rollen für alle Hauptkonten aktualisiert.
Weitere Informationen finden Sie unter MCP konfigurieren.
Erforderliche Hauptberechtigungen
Die folgenden Berechtigungen sind erforderlich, um den Detection Engineering Agent auszuführen:
chronicle.ade.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
Erforderliche Berechtigungen für die Regelverwaltung und den Parser
Die folgenden Berechtigungen sind zum Verwalten von Regeln und Parsern erforderlich:
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.logTypes.list
Erforderliche Berechtigungen für die Nutzung des Remote-MCP-Servers und des Projektdienstes
Die folgenden Berechtigungen sind erforderlich, um den Remote-MCP-Server aufzurufen und Projektdienste für MCP-Tools zu verwenden:
mcp.tools.call(gewährt durch die Rolleroles/mcp.toolUser)serviceusage.services.use(gewährt durch die Rolleroles/serviceusage.serviceUsageConsumer)
Erforderliche und empfohlene vordefinierte Rollen
Die folgenden vordefinierten Rollen bieten die erforderlichen Berechtigungen für menschliche Nutzer und Dienstkonten:
roles/chronicle.admin(oderroles/chronicle.editor)roles/mcp.toolUserroles/serviceusage.serviceUsageConsumer
MCP-Server einrichten
Informationen zum Erstellen der Datei settings.json finden Sie unter MCP konfigurieren. Nachdem Sie die erforderlichen Werte erfasst haben, sollte der Inhalt Ihrer settings.json-Datei so aussehen:
{
"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"
}
}
}
}
Kontextdatei einrichten
Richten Sie zuerst eine Kontextdatei ein, damit Gemini für jede Anfrage die richtige Google SecOps-Instanz verwendet.
Damit alles übersichtlich bleibt, empfiehlt Google, mit dem folgenden Inhalt in der GEMINI.md-Datei zu beginnen und dann darauf aufzubauen. Ersetzen Sie die Platzhalterwerte durch die richtigen Informationen für Ihre Google SecOps-Instanz und -Umgebung:
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
Skill für die Interaktion mit den Tools einrichten
Google empfiehlt dringend, den Skill detection-engineering-coverage-evaluation für die Interaktion mit den Tools zu verwenden. Diese Fähigkeit verhindert, dass die KI kritische Toolausgaben zusammenfasst oder abkürzt.
Dieser Skill ist als detection-engineering-coverage-evaluation integriert und wird öffentlich im GitHub-Repository für Google-Agent-Skills gehostet.
Hauptmerkmale
In diesem Abschnitt werden die wichtigsten Funktionen für die Bedrohungsanalyse und Regelgenerierung beschrieben, die der Detection Engineering Agent bietet.
Möglichkeiten zur Bedrohungserkennung generieren
Das generate_threat_detection_opportunity-Tool extrahiert und reichert Rohdaten zu Threat Intelligence aus Quellen wie Sicherheitsblogs und internen Erkenntnissen an, um priorisierte TDOs für die Analyse zu erstellen. Die in diesem Schritt erstellten TDOs dienen als Grundlage für die nachfolgenden Schritte des Detection Engineering-Agenten, um die Abdeckung vorhandener Regeln zu bewerten oder neue Regeln zu generieren.
- Wenn Sie das
generate_threat_detection_opportunity-Tool verwenden möchten, weisen Sie Gemini an,curlzum Extrahieren des Texts zu verwenden, oder kopieren Sie den Rohtext aus einem Bedrohungsbericht und fügen Sie ihn in das Tool ein.
Synthetische Ereignisse generieren
Damit synthetische Ereignisse für ein TDO generiert werden können, muss Ihre Google SecOps-Instanz Rohlogs und einen aktiven Parser für mindestens einen der unterstützten Logtypen in diesem TDO aufgenommen haben.
Unterstützte Logtypen
Die Generierung synthetischer Ereignisse unterstützt die folgenden acht Logtypen:
| Kategorie | Anbieter oder Produkt | Logtyp |
|---|---|---|
| Endpoint Detection and Response (EDR) | CrowdStrike Falcon | CS_EDR |
| Endpoint Detection and Response (EDR) | Microsoft Defender for Endpoint | MICROSOFT_DEFENDER_ENDPOINT |
| Endpoint Detection and Response (EDR) | SentinelOne EDR | SENTINEL_EDR |
| Antivirenprogramm und Endpunkt | Windows Defender ATP | WINDOWS_DEFENDER_ATP |
| DNS | Zscaler DNS | ZSCALER_DNS |
| Google Cloud | Google Workspace-Aktivitäten | WORKSPACE_ACTIVITY |
| Identitäts- und Zugriffsverwaltung | Okta | OKTA |
| SaaS-Anwendungen | Microsoft 365 (Office 365) | OFFICE_365 |
Abdeckung bewerten
Der Detection Engineering Agent prüft, ob vorhandene Regeln in Ihrer Google SecOps-Instanz bei simulierten Ereignissen ausgelöst werden, die über die Ereignissimulation aufgenommen wurden. Wenn Regeln mit den simulierten Ereignissen übereinstimmen, gibt das Tool die übereinstimmenden Regelkennungen und Metadaten zu den Abdeckungsergebnissen zurück. Wenn keine Regeln übereinstimmen, wird ein leeres Ergebnis zurückgegeben, was auf eine Abdeckungslücke hinweist.
Regelentwürfe erstellen
Der Detection Engineering-Agent codiert die Erkennungslogik, indem er aus Nutzereingaben oder natürlicher Sprache YARA-L-Regelentwürfe erstellt, um die bei der Abdeckungsbewertung festgestellten Lücken zu schließen. Wenn Sie den detection-engineering-coverage-evaluation-Skill verwenden, generiert der KI-Agent nur für TDOs Regelentwürfe, für die keine vorhandene Regel passt, und erst, nachdem die Abdeckungsbewertung für alle TDOs abgeschlossen ist. So werden doppelte Regeln für Bedrohungen vermieden, die bereits durch vorhandene Regeln abgedeckt sind.
Das generate_rules-Tool fügt die Regelentwürfe nicht automatisch Ihrer Google SecOps-Instanz hinzu. Nachdem Sie die Regelentwürfe geprüft haben, können Sie sie auf eine der folgenden Arten hinzufügen:
- KI-Client verwenden: Der
detection-engineering-coverage-evaluation-Skill fordert Sie auf, jeden Regelentwurf zu genehmigen oder abzulehnen. Für jede Regel, die Sie genehmigen, ruft der KI-Client das Toolcreate_ruleauf dem Google SecOps-MCP-Server auf, um die Regel in Ihrer Instanz zu erstellen. - Regel manuell erstellen: Kopieren Sie den Regeltext aus der Toolausgabe und erstellen Sie die Regel im Regeleditor.
Fehlerbehebung
In der folgenden Tabelle finden Sie Informationen zur Behebung häufiger Probleme während des Bewertungsprozesses:
| Problem | Beschreibung | Korrigieren |
|---|---|---|
| Toolfehler | Das Tool generate_synthetic_events schlägt wiederholt fehl. |
Prüfen Sie, ob das TDO mindestens einen der unterstützten Logtypen enthält und ob Ihre Google SecOps-Instanz Rohlogs und einen aktiven Parser für diesen Logtyp aufgenommen hat. Andernfalls überspringen Sie die Generierung synthetischer Ereignisse für dieses TDO und fahren Sie mit den verbleibenden TDOs fort. |
| Fehler bei der Zusammenfassung | Die KI kürzt Logtypen ab oder nimmt während der Ausführung Abkürzungen. | Achten Sie darauf, dass der detection-engineering-coverage-evaluation-Skill aktiv für die Interaktion mit dem System verwendet wird. |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten