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

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 papel roles/mcp.toolUser)
  • serviceusage.services.use (concedida pelo papel roles/serviceusage.serviceUsageConsumer)

Os papéis predefinidos a seguir fornecem as permissões necessárias para usuários humanos e contas de serviço:

  • roles/chronicle.admin (ou roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/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 usar curl para 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-evaluation pede que você aprove ou rejeite cada regra para rascunho. Para cada regra que você aprovar, o cliente de IA vai chamar a ferramenta create_rule no 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.