Integrando Dados Cato com Google SecOps

Prev Next

Important: This integration is a preview and subject to change. The certification process is underway.

Visão geral

Use a integração Google SecOps para analisar dados de rede e segurança Cato junto com outros dados de telemetria de segurança nas Operações de Segurança do Google (Google SecOps, anteriormente Chronicle). A integração nativa envia dados diretamente para um feed de webhook HTTPS do Google SecOps para monitoramento e investigação.

Você configura a integração na Aplicação de Gerenciamento da Cato (CMA). Cato envia JSON delimitado por linhas, com um registro por linha, e autentica com uma chave API do Google Cloud e a chave secreta do webhook do feed.

Esta integração é separada da integração Google Chronicle que recupera dados através da API eventsFeed da Cato.

Fontes de Dados Google SecOps

Você pode selecionar Eventos, Fluxos, ou ambos:

  • Eventos: Registros de atividade de rede e segurança, como correspondências de política de implantação, ameaças, mudanças na conectividade e atividade de auditoria.

  • Fluxos: Registros de fluxo de rede que adicionam contexto de aplicação e usuário e detalhes agregados de sessão, como bytes, pacotes e duração.

Cada registro inclui um campo data_source com o valor events ou flows. Os dados de fluxo podem gerar um volume significativamente maior do que os dados de eventos, dependendo de seu tráfego.

Prerequisites

  • Permissão de Editor para Integrações na seção Recursos da CMA. Para mais informações, veja Gerenciando Funções de Admin usando RBAC.

  • Uma instância Google SecOps vinculada a um projeto do Google Cloud, com a API Chronicle ativada.

  • Permissão para criar um feed de webhook no Google SecOps e uma chave API no projeto Google Cloud vinculado.

  • Os pré-requisitos descritos em Começando com Integrações de Eventos, incluindo qualquer lista de permissões de IP necessária.

Casos de Uso

Esses exemplos assumem que as fontes de dados relevantes são ingeridas e os campos usados para correlacionar registros são analisados consistentemente.

Eventos

Após validar mapeamentos UDM, crie uma regra YARA-L que correlacione um sign-in suspeito com um evento de ameaça Cato para o mesmo usuário dentro de uma janela de tempo definida.

Fluxos

Use buscas estatísticas para identificar transferências de saída incomumente grandes, então examine eventos Cato associados para política ou contexto de ameaça.

Criando a Integração Google SecOps

Crie um webhook feed e uma chave API do Google Cloud, teste o endpoint com curl, depois insira o URL do feed e as credenciais no CMA.

Passo 1: Crie o Feed Webhook HTTPS no Google SecOps

Para criar o webhook feed:

  1. Inicie sessão no Google SecOps e vá para Configurações > Feeds.

  2. Clique em Adicionar novo e insira um Nome do Feed, como Cato Networks.

  3. Para Tipo de Fonte, selecione Webhook.

  4. Selecione o Tipo de Log para os registros Cato.

  5. Clique em Próximo.

  6. Defina Delimitador de Divisão como \n para que o Google SecOps digira cada registro JSON delimitado por nova linha como uma entrada de log separada.

  7. (Opcionalmente) Configure um Namespace de Ativo e Rótulos de Ingestão.

  8. Clique em Próximo, revise a configuração do feed e clique em Enviar.

  9. Clique em Gerar Chave Secreta. Copie a chave e armazene-a com segurança antes de sair da tela. O Google não a exibe novamente.

  10. Na aba Detalhes, copie o URL do endpoint do feed de Informações do Endpoint. Use o URL completo, incluindo o sufixo :importPushLogs.

  11. Confirme se o feed está ativado.

Gerar outra chave secreta invalida a chave anterior. Se você girar o segredo após configurar o Cato, atualize a Chave de Acesso Webhook no CMA imediatamente para evitar uma lacuna na entrega.

Passo 2: Crie a Chave API do Google Cloud

Para criar a chave API:

  1. No console do Google Cloud, selecione o projeto vinculado à sua instância do Google SecOps.

  2. Vá para APIs & Serviços > Credenciais.

  3. Clique em Criar credenciais > Chave API.

  4. Restrinja a chave à API Chronicle e salve a restrição.

  5. Copie a chave API e armazene-a com segurança.

Você também pode usar uma chave API existente restrita à API Chronicle para o projeto vinculado.

Passo 3: Teste o Endpoint com curl

Antes de configurar a integração no CMA, envie uma solicitação de teste diretamente para o Google SecOps. Isso ajuda a isolar problemas de endpoint e autenticação da integração Cato.

Para testar o endpoint:

  1. Substitua ENDPOINT_URL pela URL completa do feed de endpoint do Passo 1. Quando solicitado, insira a chave de API do Google Cloud do Passo 2 e a chave secreta do feed do Passo 1.

  2. Atualize os carimbos de data/hora de amostra para o horário UTC atual e execute o seguinte comando. Mantenha cada objeto JSON em sua própria linha; o comando envia ambos os registros em uma solicitação:

    Execute o exemplo completo em um shell interativo Bash (execute bash primeiro, se necessário). Insira as credenciais nos prompts ocultos; não as insira no comando. O exemplo desativa a rastreamento de shell e passa os cabeçalhos de autenticação através da entrada padrão usando --header @-, mantendo as credenciais fora do histórico de comandos shell e argumentos da linha de comando curl. As variáveis de credenciais temporárias são descartadas quando o exemplo termina.

    (
      set +axv
      set -euo pipefail
      unset CATO_TEST_API_KEY CATO_TEST_WEBHOOK_SECRET
      IFS= read -r -s -p 'Chave de API do Google Cloud: ' CATO_TEST_API_KEY
      builtin printf '\n' >&2
      case "$CATO_TEST_API_KEY" in
        ''|*$'\r'*) builtin printf 'Insira uma credencial não vazia sem retornos de carro.\n' >&2; exit 1 ;;
      esac
      IFS= read -r -s -p 'Chave secreta do Webhook: ' CATO_TEST_WEBHOOK_SECRET
      builtin printf '\n' >&2
      case "$CATO_TEST_WEBHOOK_SECRET" in
        ''|*$'\r'*) builtin printf 'Insira uma credencial não vazia sem retornos de carro.\n' >&2; exit 1 ;;
      esac
    
      builtin printf '%s\n' "X-goog-api-key: ${CATO_TEST_API_KEY}" "X-Webhook-Access-Key: ${CATO_TEST_WEBHOOK_SECRET}" | \
        curl -q --fail --show-error --include --max-time 30 -X POST "ENDPOINT_URL" \
      --header @- \
      -H "Content-Type: application/json" \
      --data-binary '{"message":"evento de teste do Cato 1","timestamp":"2026-07-14T12:00:00Z"}
    {"message":"evento de teste do Cato 2","timestamp":"2026-07-14T12:00:01Z"}'
    )
  3. Verifique a resposta HTTP em busca de erro. Uma solicitação bem-sucedida retorna um status HTTP 2xx.

  4. No Google SecOps, pesquise nos logs brutos recentes por evento de teste do Cato 1 e evento de teste do Cato 2. Permita alguns minutos para a ingestão, e confirme que eles aparecem como dois registros de log separados. Se ambos os registros aparecerem em uma entrada de log, verifique se o Delimitador de Divisão do feed está definido como \n. Este exemplo verifica a conectividade e a divisão de registros; ele não valida todos os mapeamentos de parser para Eventos e Fluxos do Cato.

Este teste verifica se o destino aceita a solicitação de amostra e a divide em entradas de log individuais. Verifique os dados e o parsing do Cato após configurar a integração abaixo.

Etapa 4: Criar a Integração no CMA

Para criar a integração do Google SecOps:

  1. No menu de navegação do CMA, vá para Recursos > Integrações.

  2. Abra a aba Integrações Configuradas e clique em Novo.

  3. Selecione Google SecOps e a capacidade de Exportação de Dados.

  4. Insira um Nome e uma Descrição opcional.

  5. Para URL do Webhook, cole a URL completa do endpoint de feed do Passo 1.

  6. Para Chave API do Google Cloud, cole a chave API restrita à API do Chronicle.

  7. Para Chave de Acesso do Webhook, cole a chave secreta do feed.

  8. Em Fontes de Dados, selecione Eventos, Fluxos ou ambos.

  9. (Opcionalmente) Configure filtros de evento e fluxo para controlar quais registros são enviados. Veja Filtros.

  10. Clique em Salvar.

Cato armazena ambas as chaves criptografadas e não as exibe novamente. Ao editar a integração, deixe uma chave inalterada para manter seu valor armazenado ou insira uma substituição.

Cato configura os cabeçalhos X-goog-api-key, X-Webhook-Access-Key e Content-Type: application/json automaticamente. Você não precisa configurar cabeçalhos.

Passo 5: Verificar Ingestão e Análise

Para verificar que os dados do Cato chegam no Google SecOps:

  1. No CMA, reveja o status da integração. Atualize a página se necessário e verifique erros de autenticação ou destino.

  2. No Google SecOps, acesse Configurações > Feeds, abra o feed do Cato e revise seu status e tempo de última ingestão.

  3. Gere um evento recente do Cato ou tráfego de rede para cada fonte de dados selecionada.

  4. Pesquise logs brutos recentes usando um rótulo de ingestão configurado no feed ou um valor de registro distinto do Cato. Você também pode procurar pelo campo data_source com os valores events ou flows. Permita alguns minutos para a ingestão.

  5. Verifique se os registros individuais são analisados e seus timestamps e campos mapeados correspondem à atividade do Cato.

Filtros

Use filtros de eventos e fluxos para limitar os dados do Cato exportados para o Google SecOps. Isso ajuda a controlar o volume de ingestão e focar investigações na atividade relevante.

Condições de filtro dentro de um grupo usam lógica E. Grupos separados usam lógica OU.

  • Filtro de Eventos – Clique em Adicionar Filtro para definir uma condição ou Adicionar Grupo para adicionar outro grupo de filtros.

  • Filtro de Fluxos – Disponível quando Fluxos é selecionado. Segue a mesma lógica do filtro de eventos.

Filtros que são muito restritivos podem excluir todos os registros sem relatar um erro. Se nenhum dado chegar, verifique as fontes de dados selecionadas e as condições do filtro.

Limitações de Serviços

  • Google SecOps suporta um tamanho máximo de solicitação de webhook de 4 MB e uma taxa máxima de 15.000 consultas por segundo (QPS) por instância.

  • Como os registros da Cato se mapeiam no UDM depende do tipo de Log do feed e da configuração do analisador.

  • Regenerar o segredo do feed invalida a chave anterior. Atualize a Chave de Acesso do Webhook no CMA quando girar o segredo.

  • Você não pode personalizar o formato do corpo de solicitação, tipo de conteúdo ou nomes de cabeçalhos da integração Cato.

Troubleshooting

Problemas

Solução

A autenticação falha com HTTP 401 ou 403

Verifique se a chave da API do Google Cloud pertence ao projeto vinculado e permite o uso da API do Chronicle. Confirme que o segredo do feed não foi substituído e atualize as credenciais no CMA se necessário.

O destino é inacessível

Copie a URL completa do endpoint do feed de Detalhes > Informações do Endpoint, incluindo :importPushLogs, e confirme que o feed está ativado.

A integração parece saudável, mas nenhum dado chega

Verifique a seleção da fonte de dados e filtros, gere atividade correspondente da Cato e reveja o status de ingestão do feed e erros do analisador.

Apenas eventos ou apenas fluxos chegam

Confirme que as fontes necessárias estão selecionadas e que seus filtros permitem registros correspondentes. Verifique se cada fonte é enviada para o feed configurado para ela.

Registros brutos chegam, mas campos não são analisados

Revise o Tipo de Log do feed e a configuração do analisador em relação à configuração na Etapa 1.

Solicitações são rejeitadas ou a ingestão é atrasada em alto volume

Revise erros de destino para tamanhos de solicitação ou limites de throughput e contate o Suporte da Cato com o intervalo de tempo afetado e os detalhes do erro, excluindo chaves de API e segredos de webhook.

Recursos Adicionais