Integração dos Dados Cato com o Exabeam

Prev Next

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

Visão Geral

Utilize a integração Exabeam para analisar dados de rede e segurança Cato junto com dados de outras fontes na Plataforma de Operações de Segurança New-Scale da Exabeam. A integração nativa envia dados diretamente a um Webhook JSON Coletor de Nuvem, para que seu SOC possa pesquisar registros Cato e usá-los em seus fluxos de trabalho de monitoramento e investigação.

Você configura a integração na Aplicação de Gerenciamento da Cato (CMA). Cato envia solicitações HTTPS POST contendo arrays JSON e se autentica com o token de porta do coletor. A análise de campos Cato no Exabeam pode exigir configurações adicionais.

Fontes de Dados Exabeam

Você pode enviar Eventos, Fluxos, ou ambos:

  • Eventos: Registros de atividade de rede e segurança, como correspondência de políticas, ameaças, mudanças de conectividade e atividades 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. Dados de fluxo podem gerar volume significativamente maior do que dados de eventos, dependendo do seu tráfego.

Prerequisites

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

Investigue uma conta suspeita comprometida revisando seus eventos de ameaça Cato junto com logins de provedores de identidade em uma linha do tempo de Pesquisa Exabeam. Use informações de usuário correspondentes e marcas de tempo para construir uma sequência de atividade.

Fluxos

Adicione os registros de fluxo Cato da conta à investigação para avaliar destinos contatados, duração de conexão e volume de transferência.

Criando a Integração Exabeam

Crie um Webhook JSON Coletor de Nuvem no Exabeam, então utilize seu URL de destino e token de autenticação para configurar a integração no CMA.

Passo 1: Crie o Webhook Coletor de Nuvem no Exabeam

Para criar o coletor:

  1. Iniciar Sessão no Exabeam e ir para Coletas > Coletas na Nuvem.

  2. Clique em Novo Coletor e selecione Webhook.

  3. Insira um nome descritivo, como Cato Networks.

  4. Para Formato, selecione JSON. Este formato permite ao Exabeam extrair registros individuais das matrizes JSON enviadas pela Cato.

  5. (Opcionalmente) Selecione um Site e Fuso Horário.

  6. Clique em Instalar. O Exabeam exibe o token de autenticação e o URL de destino. Copie ambos os valores e armazene o token de forma segura.

  7. Clique em Ir para Visão Geral e confirme que o coletor aparece.

Use o URL completo gerado para o seu coletor, incluindo o hostname regional e o caminho /logs/json.

Passo 2: Teste o Endpoint usando curl

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

Para testar o endpoint:

  1. Substitua <api-fqdn> pelo nome do host da API para seu ponto de teste. Insira o token coletor na solicitação oculta. Este exemplo usa sintaxe Bash para JSON delimitado por nova linha.

  2. Atualize os timestamps de exemplo para o horário UTC atual, depois execute o seguinte comando:

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

    (
      set +axv
      set -euo pipefail
      unset CATO_TEST_TOKEN
      IFS= read -r -s -p 'Token do coletor Exabeam: ' CATO_TEST_TOKEN
      builtin printf '\n' >&2
      case "$CATO_TEST_TOKEN" in
        ''|*$'\r'*) builtin printf 'Digite uma credencial não vazia sem retornos de carro.\n' >&2; exit 1 ;;
      esac
    
      builtin printf '%s\n' "Authorization: Bearer ${CATO_TEST_TOKEN}" | \
        curl -q --fail --show-error --include --max-time 30 -X POST 'https://<api-fqdn>/ingest/api/v1/third_party_log/hec' \
      --header @- \
      -H "Content-Type: text/plain" \
      --data-binary $'{"timestamp": "2026-10-20T10:00:03Z", "msg": "ndjson log line 1"}\n{"timestamp": "2026-10-20T10:00:05Z", "msg": "ndjson log line 2"}\n'
    )
  3. Verifique a resposta HTTP para erros. Uma solicitação bem-sucedida retorna um status HTTP 2xx.

  4. No Exabeam, pesquise por ndjson log line 1 e ndjson log line 2, e confirme que eles aparecem como registros separados.

Este teste verifica se o destino aceita a solicitação de amostra. Verifique os dados da Cato e análise após configurar a integração abaixo.

Passo 3: Criar a Integração no CMA

Para criar a integração Exabeam:

  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 Exabeam e a capacidade de Exportação de Dados.

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

  5. Para URL de Ingestão, cole o URL de destino completo gerado por Exabeam.

  6. Para Token de Autenticação, cole o token de autenticação do coletor. Insira apenas o token; Cato adiciona o prefixo Bearer.

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

  8. (Opcionalmente) Configure filtros de eventos e fluxos para controlar quais registros são enviados. Veja Filtros.

  9. Clique em Salvar.

Cato armazena o token criptografado e não o exibe novamente. Atualize a integração ao rotacionar o token do coletor.

Etapa 4: Verificar Ingestão e Análise

Para verificar que os dados do Cato chegam ao Exabeam:

  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 Exabeam, vá para Coletores > Coletores de Nuvem > Visão geral, abra o coletor Cato e confirme que está recebendo dados.

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

  4. Use Exabeam Search para encontrar registros Cato recentes por um valor distinto ou pelo campo data_source. Quando ambas as fontes estiverem selecionadas, verifique os registros com os valores de eventos e fluxos.

  5. Verifique se os campos Cato foram analisados. Se os registros permanecerem não analisados, use o Exabeam's Auto Parser Generator ou o workflow Log Stream para configurar a análise, seguindo as diretrizes do Exabeam.

Filtros

Use filtros de evento e fluxo para limitar os dados Cato exportados para o Exabeam. Isso ajuda a controlar o volume de ingestão e a focar as investigações em atividades relevantes.

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

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

  • Filtros de Fluxos – Disponível quando Fluxos está selecionado. Usa a mesma lógica de agrupamento que o filtro de eventos.

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

Limitações de Serviços

  • O coletor genérico Webhook Cloud do Exabeam não inclui suporte a conteúdo pré-configurado. Pode ser necessário desenvolver um analisador para registros Cato.

  • O Exabeam limita os pedidos de lote sem compressão a 32 MB e uma duração de pedido de dois minutos.

  • Mudanças na meta de site Exabeam podem levar até cinco minutos para aparecer nos logs do webhook.

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

Troubleshooting

Problema

Solução

Falhas de autenticação com HTTP 401 ou 403

Confirme que o token pertence ao coletor de destino e não expirou ou foi revogado. Copie ou regenere o token do coletor e atualize o Token de Autenticação no CMA.

O destino está inacessível ou retorna HTTP 404

Copie a URL completa do destino do Exabeam. Verifique o nome do host regional e o caminho /logs/json.

O destino retorna HTTP 400 ou rejeita os registros

Confirme que o coletor usa o formato JSON e que a Cato usa o URL de destino JSON do coletor.

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

Verifique a seleção da fonte de dados e os filtros, gere atividades correspondentes da Cato e revise a Visão geral do coletor no Exabeam. Permita alguns minutos para a ingestão.

Somente eventos ou apenas fluxos chegam

Confirme que as fontes necessárias estão selecionadas e revise os grupos de filtro para cada fonte.

Os registros chegam, mas os campos não são analisados

Inspecione os registros brutos e configure a análise com o Auto Parser Generator ou o fluxo de trabalho Log Stream do Exabeam.

Requisições falham em alto volume

Verifique erros do coletor para os limites de tamanho de lote e duração de solicitação. Contate o Suporte da Cato com o intervalo de tempo afetado e a resposta do destino, excluindo tokens de autenticação.

Recursos Adicionais