Usar o agente de engenharia de detecção
Este guia é destinado a engenheiros de segurança e analistas de SOC que querem avaliar e fortalecer a postura de segurança do Google Security Operations contra ameaças novas e existentes usando o Agente de Engenharia de Detecção com tecnologia de IA no Google SecOps.
É possível acessar o agente usando ferramentas do Protocolo de Contexto de Modelo (MCP) operadas por clientes de IA compatíveis (por exemplo, Google Antigravity ou Claude Code). Com o agente de engenharia de detecção, é possível extrair inteligência contra ameaças e elaborar automaticamente regras YARA-L, o que melhora o tempo de retorno da automação de segurança personalizada e acelera a redução de riscos.
Terminologia importante
- Agente de engenharia de detecção: um assistente de engenharia com tecnologia de IA incorporado ao Google SecOps, operado por clientes de IA (por exemplo, Antigravity ou Claude Code) usando ferramentas do MCP.
- Protocolo de Contexto de Modelo (MCP): um padrão de código aberto para conectar aplicativos de IA a sistemas externos, usado em todos os serviços do Google Cloud para conectar com segurança agentes de IA e aplicativos a várias fontes de dados e ferramentas de infraestrutura.
- Oportunidade de detecção de ameaças (TDO, na sigla em inglês): um modelo de dados formalizado projetado para identificar, rastrear e priorizar possíveis novas regras de detecção ou análises.
- Eventos sintéticos: registros do modelo de dados unificado (UDM) gerados para simular um TDO de entrada.
Antes de começar
Antes de começar, confirme se os seguintes pré-requisitos foram atendidos:
Verificação do ambiente: cliente de IA
Você precisa operar um cliente de IA (como o Antigravity ou o Claude Code) capaz de interagir com as ferramentas do MCP.
Papéis e permissões necessárias
Nesta seção, listamos as permissões necessárias do Identity and Access Management (IAM) e os papéis predefinidos recomendados para usuários humanos e contas de serviço.
Papéis necessários para todos os usuários principais
Cada principal que chama o Agente de Engenharia de Detecção precisa ter os seguintes papéis: Usuário da ferramenta MCP e Leitor da API Chronicle. Verifique se um administrador do sistema atualiza esses papéis para todos os usuários principais.
Para mais informações, consulte Configurar o MCP.
Permissões principais necessárias
As permissões a seguir são necessárias para executar o agente de engenharia de detecção:
chronicle.ade.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
Permissões necessárias para gerenciamento de regras e analisador
As seguintes permissões são necessárias para gerenciar regras e analisadores:
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.logTypes.list
Permissões necessárias para o servidor MCP remoto e o uso do serviço do projeto
As permissões a seguir são necessárias para chamar o servidor MCP remoto e usar os serviços do projeto para ferramentas MCP:
mcp.tools.call(concedida pelo papelroles/mcp.toolUser)serviceusage.services.use(concedida pelo papelroles/serviceusage.serviceUsageConsumer)
Papéis predefinidos obrigatórios e recomendados
Os papéis predefinidos a seguir fornecem as permissões necessárias para usuários humanos e contas de serviço:
roles/chronicle.admin(ouroles/chronicle.editor)roles/mcp.toolUserroles/serviceusage.serviceUsageConsumer
Configurar o servidor MCP
Para criar o arquivo settings.json, consulte
Configurar o MCP. Depois de
coletar os valores necessários, verifique se o conteúdo do
arquivo settings.json é semelhante ao seguinte:
{
"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"
}
}
}
}
Configurar um arquivo de contexto
Para começar, configure um arquivo de contexto para garantir que o Gemini use a instância correta do Google SecOps em cada solicitação.
Para manter tudo leve, o Google recomenda começar com o seguinte
conteúdo no arquivo GEMINI.md e, em seguida, criar a partir daí. Substitua os
valores de marcador pelas informações corretas para sua
instância e ambiente do 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
Configurar a habilidade para interagir com as ferramentas
O Google recomenda o uso da habilidade detection-engineering-coverage-evaluation
para interagir com as ferramentas. Essa habilidade impede que a IA resuma ou
abrevia as saídas de ferramentas críticas.
Essa habilidade é integrada como detection-engineering-coverage-evaluation e
está hospedada publicamente no
repositório do GitHub de habilidades do agente do Google.
Principais recursos
Nesta seção, descrevemos os principais recursos de análise de ameaças e geração de regras que o agente de engenharia de detecção oferece.
Gerar oportunidades de detecção de ameaças
A ferramenta generate_threat_detection_opportunity extrai e enriquece a inteligência contra ameaças
bruta de fontes (por exemplo, blogs de segurança e descobertas
internas) para criar TDOs priorizados para análise. Os
TDOs produzidos nesta etapa informam as etapas subsequentes do agente de engenharia de detecção
para avaliar a cobertura de regras existentes ou gerar novas regras.
- Para usar a ferramenta
generate_threat_detection_opportunity, instrua o Gemini a usarcurlpara extrair o texto ou copie e cole o texto bruto de um relatório de ameaças na ferramenta.
Gerar eventos sintéticos
Para gerar eventos sintéticos para um TDO, sua instância do Google SecOps precisa ter ingerido registros brutos e um analisador ativo para pelo menos um dos tipos de registro compatíveis com esse TDO.
Tipos de registro compatíveis
A geração de eventos sintéticos é compatível com os oito tipos de registro a seguir:
| Categoria | Fornecedor ou produto | Tipo de registro |
|---|---|---|
| Detecção e resposta de endpoints (EDR) | CrowdStrike Falcon | CS_EDR |
| Detecção e resposta de endpoints (EDR) | Microsoft Defender para Ponto de Extremidade | MICROSOFT_DEFENDER_ENDPOINT |
| Detecção e resposta de endpoints (EDR) | EDR do SentinelOne | SENTINEL_EDR |
| Antivírus e endpoint | Windows Defender ATP | WINDOWS_DEFENDER_ATP |
| DNS | DNS do Zscaler | ZSCALER_DNS |
| Google Cloud | Atividades do Google Workspace | WORKSPACE_ACTIVITY |
| Gerenciamento de identidade e acesso | Okta | OKTA |
| Aplicativos SaaS | Microsoft 365 (Office 365) | OFFICE_365 |
Avaliar a cobertura
O agente de engenharia de detecção verifica se as regras atuais na sua instância do Google SecOps são acionadas em eventos simulados ingeridos por meio da simulação de eventos. Se alguma regra corresponder aos eventos simulados, a ferramenta vai retornar os identificadores de regras correspondentes e os metadados do resultado da cobertura. Se nenhuma regra corresponder, um resultado vazio será retornado, sinalizando uma lacuna de cobertura.
Gerar regras para rascunho
O Agente de Engenharia de Detecção codifica a lógica de detecção criando rascunhos de regras YARA-L com base em entradas do usuário ou linguagem natural para resolver lacunas identificadas durante a avaliação de cobertura. Quando você usa a
habilidade detection-engineering-coverage-evaluation,
o agente gera regras para rascunho apenas para TDOs que não correspondem a nenhuma regra atual e
somente depois que a avaliação de cobertura é concluída para todos os TDOs. Isso evita regras duplicadas para ameaças que já são cobertas por regras existentes.
A ferramenta generate_rules não adiciona automaticamente as regras de rascunho à sua
instância do Google SecOps. Depois de analisar as regras para rascunho, é possível
adicioná-las de uma das seguintes maneiras:
- Use seu cliente de IA: a habilidade
detection-engineering-coverage-evaluationpede que você aprove ou rejeite cada regra para rascunho. Para cada regra que você aprovar, o cliente de IA vai chamar a ferramentacreate_ruleno servidor MCP do Google SecOps para criar a regra na sua instância. - Criar a regra manualmente: copie o texto da regra da saída da ferramenta e crie a regra no Editor de regras.
Solução de problemas
Use a tabela a seguir para corrigir problemas comuns durante o processo de avaliação:
| Problema | Descrição | Corrigir |
|---|---|---|
| Falha da ferramenta | A ferramenta generate_synthetic_events falha repetidamente. |
Verifique se o TDO inclui pelo menos um dos tipos de registro compatíveis e se a instância do Google SecOps ingeriu registros brutos e um analisador ativo para esse tipo de registro. Caso contrário, pule a geração de eventos sintéticos para esse TDO e continue com os demais. |
| Erro de resumo | A IA abrevia os tipos de registro ou usa atalhos durante a execução. | Verifique se a habilidade detection-engineering-coverage-evaluation está sendo usada ativamente para interagir com o sistema. |
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.