--- title: "Integração dos Dados Cato com o TrendAI" slug: "integrating-cato-data-with-trendai" updated: 2026-10-23T23:15:57Z published: 2026-10-23T23:15:57Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-trendai" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Integração dos Dados Cato com o TrendAI > [!TIP] > **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](/v1/docs/managing-admin-roles-using-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](/v1/docs/getting-started-with-event-integrations), 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. ```bash (  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:///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](/docs/pt-br/integrating-cato-data-with-trendai#filters). 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 - [TrendAI: Coleta de Evento HTTP](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-dslm-tlc-api) - [TrendAI: Repositórios](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-log-repositories)