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.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.operations.get

Erforderliche Berechtigungen für die Regelverwaltung und den Parser

Die folgenden Berechtigungen sind zum Verwalten von Regeln und Parsern erforderlich:

  • 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

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 Rolle roles/mcp.toolUser)
  • serviceusage.services.use (gewährt durch die Rolle roles/serviceusage.serviceUsageConsumer)

Die folgenden vordefinierten Rollen bieten die erforderlichen Berechtigungen für menschliche Nutzer und Dienstkonten:

  • roles/chronicle.admin (oder roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/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, curl zum 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 Tool create_rule auf 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