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:
Inicie sessão no Google SecOps e vá para Configurações > Feeds.
Clique em Adicionar novo e insira um Nome do Feed, como
Cato Networks.Para Tipo de Fonte, selecione Webhook.
Selecione o Tipo de Log para os registros Cato.
Clique em Próximo.
Defina Delimitador de Divisão como
\npara que o Google SecOps digira cada registro JSON delimitado por nova linha como uma entrada de log separada.(Opcionalmente) Configure um Namespace de Ativo e Rótulos de Ingestão.
Clique em Próximo, revise a configuração do feed e clique em Enviar.
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.
Na aba Detalhes, copie o URL do endpoint do feed de Informações do Endpoint. Use o URL completo, incluindo o sufixo
:importPushLogs.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:
No console do Google Cloud, selecione o projeto vinculado à sua instância do Google SecOps.
Vá para APIs & Serviços > Credenciais.
Clique em Criar credenciais > Chave API.
Restrinja a chave à API Chronicle e salve a restrição.
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:
Substitua
ENDPOINT_URLpela 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.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
bashprimeiro, 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"}' )Verifique a resposta HTTP em busca de erro. Uma solicitação bem-sucedida retorna um status HTTP 2xx.
No Google SecOps, pesquise nos logs brutos recentes por
evento de teste do Cato 1eevento 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:
No menu de navegação do CMA, vá para Recursos > Integrações.
Abra a aba Integrações Configuradas e clique em Novo.
Selecione Google SecOps e a capacidade de Exportação de Dados.
Insira um Nome e uma Descrição opcional.
Para URL do Webhook, cole a URL completa do endpoint de feed do Passo 1.
Para Chave API do Google Cloud, cole a chave API restrita à API do Chronicle.
Para Chave de Acesso do Webhook, cole a chave secreta do feed.
Em Fontes de Dados, selecione Eventos, Fluxos ou ambos.
(Opcionalmente) Configure filtros de evento e fluxo para controlar quais registros são enviados. Veja Filtros.
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:
No CMA, reveja o status da integração. Atualize a página se necessário e verifique erros de autenticação ou destino.
No Google SecOps, acesse Configurações > Feeds, abra o feed do Cato e revise seu status e tempo de última ingestão.
Gere um evento recente do Cato ou tráfego de rede para cada fonte de dados selecionada.
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_sourcecom os valoreseventsouflows. Permita alguns minutos para a ingestão.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 |
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. |