Utilizza l'agente di Detection Engineering

Questa guida è rivolta ai security engineer e agli analisti SOC che vogliono valutare e rafforzare la propria security posture di Google Security Operations contro le minacce nuove ed esistenti, utilizzando l'agente di Detection Engineering basato sull'AI in Google SecOps.

Puoi accedere all'agente utilizzando gli strumenti Model Context Protocol (MCP) gestiti da client AI compatibili (ad esempio Google Antigravity o Claude Code). Utilizzando l'agente di Detection Engineering, puoi estrarre threat intelligence e creare automaticamente bozze di regole YARA-L, migliorando il time-to-value per l'automazione della sicurezza personalizzata e accelerando la mitigazione del rischio.

Terminologia chiave

  • Detection Engineering Agent: un assistente di ingegneria basato sull'AI integrato in Google SecOps, gestito da client AI (ad esempio Antigravity o Claude Code) che utilizzano strumenti MCP.
  • Model Context Protocol (MCP): uno standard open source per la connessione di applicazioni AI a sistemi esterni, utilizzato nei servizi Google Cloud per connettere in modo sicuro agenti AI e applicazioni a varie origini dati e strumenti di infrastruttura.
  • Threat Detection Opportunity (TDO): un modello dei dati formalizzato progettato per identificare, monitorare e dare priorità a potenziali nuove regole o analisi di rilevamento.
  • Eventi sintetici: log Unified Data Model (UDM) generati per simulare un TDO di input.

Prima di iniziare

Prima di iniziare, verifica che siano soddisfatti i seguenti prerequisiti:

Controllo dell'ambiente - Client AI

Devi utilizzare un client AI (come Antigravity o Claude Code) in grado di interfacciarsi con gli strumenti MCP.

Ruoli e autorizzazioni richiesti

Questa sezione elenca le autorizzazioni di Identity and Access Management (IAM) richieste e i ruoli predefiniti consigliati sia per gli utenti umani sia per i service account.

Ruoli obbligatori per tutti gli utenti principali

Ogni entità che chiama l'agente di Detection Engineering deve avere i seguenti ruoli: MCP Tool User e Chronicle API Viewer. Assicurati che un amministratore di sistema aggiorni questi ruoli per tutti gli utenti principali.

Per saperne di più, consulta Configura MCP.

Autorizzazioni di base richieste

Per eseguire Detection Engineering Agent sono necessarie le seguenti autorizzazioni:

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

Autorizzazioni di gestione delle regole e del parser richieste

Per gestire regole e parser sono necessarie le seguenti autorizzazioni:

  • 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

Autorizzazioni di utilizzo del servizio del progetto e del server MCP remoto richieste

Per chiamare il server MCP remoto e utilizzare i servizi del progetto per gli strumenti MCP sono necessarie le seguenti autorizzazioni:

  • mcp.tools.call (concessa dal ruolo roles/mcp.toolUser)
  • serviceusage.services.use (concesso dal ruolo roles/serviceusage.serviceUsageConsumer)

I seguenti ruoli predefiniti forniscono le autorizzazioni necessarie sia per gli utenti umani sia per i service account:

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

Configura il server MCP

Per creare il file settings.json, consulta Configura MCP. Dopo aver raccolto i valori richiesti, assicurati che i contenuti del file settings.json siano simili ai seguenti:

{
  "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"
      }
    }
  }
}

Configura un file di contesto

Per iniziare, configura un file di contesto per assicurarti che Gemini abbia come target l'istanza Google SecOps corretta per ogni richiesta.

Per mantenere tutto leggero, Google consiglia di iniziare con i seguenti contenuti nel file GEMINI.md e poi di procedere da lì. Sostituisci i valori segnaposto con le informazioni corrette per l'istanza e l'ambiente 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

Configura la skill per interagire con gli strumenti

Google consiglia vivamente di utilizzare la skill detection-engineering-coverage-evaluation per interagire con gli strumenti. Questa skill impedisce all'AI di riassumere o abbreviare gli output critici degli strumenti.

Questa skill è integrata come detection-engineering-coverage-evaluation ed è ospitata pubblicamente nel repository GitHub di Google Agent Skills.

Funzionalità chiave

Questa sezione descrive le funzionalità chiave per l'analisi delle minacce e la generazione di regole fornite dall'agente di Detection Engineering.

Genera opportunità di rilevamento delle minacce

Lo strumento generate_threat_detection_opportunity estrae e arricchisce la threat intelligence non elaborata proveniente da fonti (ad esempio, blog sulla sicurezza e risultati interni) per creare TDO con priorità per l'analisi. I TDO prodotti in questo passaggio informano i passaggi successivi dell'agente di detection engineering per valutare la copertura delle regole esistenti o generare nuove regole.

  • Per utilizzare lo strumento generate_threat_detection_opportunity, chiedi a Gemini di utilizzare curl per estrarre il testo o copia e incolla il testo non elaborato da un report sulle minacce nello strumento.

Genera eventi sintetici

Per generare eventi sintetici per un TDO, l'istanza di Google SecOps deve aver importato log non elaborati e un parser attivo per almeno uno dei tipi di log supportati in quel TDO.

Tipi di log supportati

La generazione di eventi sintetici supporta i seguenti otto tipi di log:

Categoria Fornitore o prodotto Tipo di log
Rilevamento e risposta degli endpoint (EDR) CrowdStrike Falcon CS_EDR
Rilevamento e risposta degli endpoint (EDR) Microsoft Defender for Endpoint MICROSOFT_DEFENDER_ENDPOINT
Rilevamento e risposta degli endpoint (EDR) SentinelOne EDR SENTINEL_EDR
Antivirus ed endpoint Windows Defender ATP WINDOWS_DEFENDER_ATP
DNS Zscaler DNS ZSCALER_DNS
Google Cloud Attività di Google Workspace WORKSPACE_ACTIVITY
Gestione di identità e accessi Okta OKTA
Applicazioni SaaS Microsoft 365 (Office 365) OFFICE_365

Valuta la copertura

L'agente di Detection Engineering verifica se le regole esistenti nella tua istanza di Google SecOps vengono attivate in base agli eventi simulati importati tramite la simulazione di eventi. Se una regola corrisponde agli eventi simulati, lo strumento restituisce gli identificatori delle regole corrispondenti e i metadati dei risultati della copertura. Se non viene trovata una corrispondenza con nessuna regola, viene restituito un risultato vuoto, che indica un gap di copertura.

Genera regole in modalità bozza

L'agente di detection engineering codifica la logica di rilevamento creando bozze di regole YARA-L dall'input utente o dal linguaggio naturale per colmare le lacune identificate durante la valutazione della copertura. Quando utilizzi la skill detection-engineering-coverage-evaluation, l'agente genera regole in modalità bozza solo per i TDO per i quali non esiste una regola corrispondente e solo dopo il completamento della valutazione della copertura per tutti i TDO. In questo modo si evita di creare regole duplicate per minacce già coperte da regole esistenti.

Lo strumento generate_rules non aggiunge automaticamente le regole in modalità bozza alla tua istanza di Google SecOps. Dopo aver esaminato le regole in modalità bozza, puoi aggiungerle in uno dei seguenti modi:

  • Utilizza il tuo client AI: la skill detection-engineering-coverage-evaluation ti chiede di approvare o rifiutare ogni regola in modalità bozza. Per ogni regola che approvi, il client AI chiama lo strumento create_rule sul server MCP di Google SecOps per creare la regola nella tua istanza.
  • Crea la regola manualmente: copia il testo della regola dall'output dello strumento e crea la regola nell'Editor regole.

Risoluzione dei problemi

Utilizza la tabella seguente per risolvere autonomamente i problemi comuni durante il processo di valutazione:

Problema Descrizione Correggi
Errore dello strumento Lo strumento generate_synthetic_events non funziona ripetutamente. Verifica che il TDO includa almeno uno dei tipi di log supportati e che l'istanza di Google SecOps abbia importato i log non elaborati e un parser attivo per quel tipo di log. In caso contrario, salta la generazione di eventi sintetici per quel TDO e continua con i TDO rimanenti.
Errore di riassunto L'AI abbrevia i tipi di log o utilizza scorciatoie durante l'esecuzione. Assicurati che la skill detection-engineering-coverage-evaluation venga utilizzata attivamente per interfacciarsi con il sistema.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.