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:
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.
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.
No painel de repositório, abra a aba Coletores e clique em Adicionar coletor.
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.
Digite o nome e a descrição do coletor.
Selecione coleta de eventos HTTP como o método e copie a URL do endpoint
/hecgerada para o coletor.Clique Adicionar.
Na tela Gerar token JWT, selecione o período de expiração e clique em Gerar token.
Copie o token, armazene-o de forma segura, e clique em Fechar.
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:
Use a URL completa do endpoint
/hecgerado no Passo 1 no lugar do URL de exemplo. Digite o token JWT do coletor no prompt oculto.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
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 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"}]' )Verifique a resposta HTTP para um erro. Uma requisição bem-sucedida retorna um status HTTP 2xx.
No TrendAI, pesquise por
linha de log json 1elinha de log json 2no 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:
No menu de navegação do CMA, vá para Recursos > Integrações.
Abra a aba Integrações Ativas e clique em Novo.
Selecione TrendAI e a capacidade de Exportação de Dados.
Insira um Nome e uma Descrição opcional.
Para URL de Ingestão, cole a URL completa do endpoint
/hecgerada pelo coletor TrendAI.Para Token de Autenticação, cole o token JWT do coletor. Insira apenas o token; a Cato adiciona o prefixo
Bearer.Em Fontes de Dados, selecione Eventos, Fluxos ou ambos.
(Opcionalmente) Configure filtros de eventos e fluxos para controlar quais registros são enviados. Veja Filtros.
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:
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.
No TrendAI, abra o repositório e revise o status do coletor e as informações de ingestão.
Gere um evento Cato recente ou tráfego de rede para cada fonte de dados selecionada.
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.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
eventosoufluxos.
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 |
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. |