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.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
Autorizzazioni di gestione delle regole e del parser richieste
Per gestire regole e parser sono necessarie le seguenti autorizzazioni:
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.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 ruoloroles/mcp.toolUser)serviceusage.services.use(concesso dal ruoloroles/serviceusage.serviceUsageConsumer)
Ruoli predefiniti obbligatori e consigliati
I seguenti ruoli predefiniti forniscono le autorizzazioni necessarie sia per gli utenti umani sia per i service account:
roles/chronicle.admin(oroles/chronicle.editor)roles/mcp.toolUserroles/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 utilizzarecurlper 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-evaluationti chiede di approvare o rifiutare ogni regola in modalità bozza. Per ogni regola che approvi, il client AI chiama lo strumentocreate_rulesul 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.