Integração dos Dados Cato com o TrendAI

Prev Next

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

Visão geral

Use a integração do TrendAI para analisar dados de rede e segurança da Cato junto de outros dados de segurança no TrendAI Vision One Agentic SIEM. A integração nativa envia dados via HTTPS para um coletor de eventos HTTP do TrendAI, permitindo que seu SOC pesquise registros Cato e os utilize em fluxos de monitoramento e investigação.

Você configura a integração na Aplicação de Gerenciamento da Cato (CMA). Cato envia arrays JSON com Content-Type: application/json e autentica usando um token de autenticação gerado no TrendAI.

Fontes de Dados TrendAI

Você pode selecionar Eventos, Fluxos ou ambos:

  • Eventos: Registros de atividades de rede e segurança, como correspondências 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 de sessão agregados, 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 significativamente mais volume do que os dados de eventos, dependendo do seu tráfego.

Prerequisites

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

  • Um tenant Vision One do TrendAI com Agentic SIEM e permissão para configurar repositórios e coletores de eventos HTTP.

  • Créditos suficientes do Agentic SIEM para ingestão de dados de terceiros e a retenção necessária.

  • Os pré-requisitos descritos em Introdução às Integrações de Eventos, incluindo qualquer lista de permissão de IP obrigatória.

Casos de Uso

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

Eventos

A partir de um alerta de endpoint do TrendAI, pesquise eventos Cato no XDR Data Explorer para correspondência de informações de host, endereço IP e tempo para investigar atividades relacionadas à rede.

Fluxos

Revise os fluxos Cato em torno do alerta de endpoint para avaliar quais destinos o host contatou e quanto de dados transferiu.

Criando a Integração TrendAI

Crie um coletor de eventos HTTP em um repositório TrendAI, teste seu endpoint com curl, e utilize a URL do endpoint e o token JWT para configurar a integração no CMA.

Passo 1: Criar o Coletor de Eventos HTTP no TrendAI

Para preparar o destino TrendAI:

  1. Iniciar sessão no TrendAI Vision One e acesse SIEM & XDR Agente > Fonte de Dados e Gerenciamento de Logs > Repositórios de logs de terceiros.

  2. Crie um repositório de log ou abra um existente. Selecione as configurações de ingestão e retenção que correspondam a como você planeja usar os dados.

    Você não pode alterar o tipo de ingestão de um repositório após a criação. Ingestão analítica suporta análise, correlação e caça de ameaças; ingestão arquival destina-se a consultas infrequentes e requisitos de retenção.

  3. No painel de repositório, abra a aba Coletores e clique em Adicionar coletor.

  4. Selecione o fornecedor e o produto para os dados da Cato, escolha JSON como o formato de log, e selecione o fuso horário usado pelos logs.

  5. Digite o nome e a descrição do coletor.

  6. Selecione coleta de eventos HTTP como o método e copie a URL do endpoint /hec gerada para o coletor.

  7. Clique Adicionar.

  8. Na tela Gerar token JWT, selecione o período de expiração e clique em Gerar token.

  9. Copie o token, armazene-o de forma segura, e clique em Fechar.

  10. Na aba Coletores do repositório, verifique os detalhes do coletor e a URL do endpoint.

Passo 2: Teste o Endpoint com curl

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

Para testar o endpoint:

  1. Use a URL completa do endpoint /hec gerado no Passo 1 no lugar do URL de exemplo. Digite o token JWT do coletor no prompt oculto.

  2. Atualize os timestamps de amostra para o horário UTC atual, então execute o seguinte comando:

    Execute todo o exemplo em um shell Bash interativo (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 cabeçalhos de autenticação por entrada padrão usando --header @-, mantendo as credenciais fora do histórico de shell e dos argumentos de 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 JWT do TrendAI: ' CATO_TEST_TOKEN
      builtin printf '\n' >&2
      case "$CATO_TEST_TOKEN" in
        ''|*$'\r'*) builtin printf 'Insira uma credencial não vazia sem retornos de carro.\n' >&2; exit 1 ;;
      esac
    
      builtin printf '%s\n' "Autorização: Portador ${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: application/json" \
      -d '[{"timestamp": "2026-04-07T10:00:03Z", "msg": "linha de log json 1"},{"timestamp": "2026-04-07T10:00:05Z", "msg": "linha de log json 2"}]'
    )
  3. Verifique a resposta HTTP para um erro. Uma requisição bem-sucedida retorna um status HTTP 2xx.

  4. No TrendAI, pesquise por linha de log json 1 e linha de log json 2 no repositório de destino. Confirme que ambos os registros aparecem separadamente.

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

Passo 3: Criar a Integração no CMA

Para criar a integração TrendAI:

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

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

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

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

  5. Para URL de Ingestão, cole a URL completa do endpoint /hec gerada pelo coletor TrendAI.

  6. Para Token de Autenticação, cole o token JWT do coletor. Insira apenas o token; a 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.

A Cato armazena o token criptografado e não o exibe novamente. Atualize a integração quando você rotacionar o token JWT.

A Cato autentica com o JWT usando o cabeçalho Autorização: Portador <token>.

Passo 4: Verificar Ingestão e Análise

Para verificar que os dados da Cato chegam ao TrendAI:

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

  2. No TrendAI, abra o repositório e revise o status do coletor e as informações de ingestão.

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

  4. Abra o Explorador de Dados XDR e pesquise registros recentes da Cato usando um valor distinto ou o campo data_source. Permita alguns minutos para a ingestão.

  5. Verifique se os registros aparecem individualmente e se seus carimbos de tempo e campos analisados correspondem à atividade da Cato. Para cada fonte selecionada, confirme o valor correspondente de eventos ou fluxos.

Filtros

Use filtros de eventos e fluxos para limitar os dados da Cato exportados para o TrendAI. Isso ajuda a controlar o volume de ingestão e a focar investigações em atividades relevantes.

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 está selecionado. Segue a mesma lógica do filtro de eventos.

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

Limitações de Serviços

  • A ingestão de dados de terceiros usa créditos do Agentic SIEM. Retenção além do período padrão requer créditos adicionais.

  • O tipo de ingestão de um repositório não pode ser alterado após a criação. Para usar um tipo de ingestão diferente, crie outro repositório.

  • Se o token JWT expirar ou for revogado, a entrega será interrompida até que você atualize o token no CMA.

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

Troubleshooting

Problemas

Solução

Falha na autenticação com HTTP 401 ou 403

Confirme se o token JWT pertence ao coletor de destino e não expirou ou foi revogado. Gere uma substituição, se necessário, e atualize o Token de Autenticação no CMA.

O destino é inalcançável

Copie a URL completa do endpoint dos detalhes do coletor TrendAI e confirme que o coletor está disponível em seu locatário.

O destino retorna HTTP 400 ou 415

Confirme que o endpoint é a URL /hec gerada para este coletor, o token é válido e não expirado JWT, e o corpo do pedido é uma matriz JSON. Cato envia o corpo com Content-Type: application/json.

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

Revise a seleção e filtros da fonte de dados, gere atividade correspondente da Cato e verifique as informações de ingestão e configurações de repositório do coletor TrendAI.

Apenas eventos ou apenas fluxos chegam

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

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

Revise as seleções de fornecedor, produto e formato de log do coletor em relação à configuração usada na Etapa 1.

Recursos Adicionais