--- title: "Integrando Dados da Cato com Palo Alto Cortex" slug: "integrating-cato-data-with-cortex-xdr" updated: 2026-11-14T00:09:12Z published: 2026-11-14T00:09:12Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-cortex-xdr" --- > ## 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. # Integrando Dados da Cato com Palo Alto Cortex > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## **Visão Geral** Use a integração Palo Alto Cortex para incluir dados de rede e segurança Cato em seus fluxos de trabalho de monitoramento, correlação e investigação existentes. A integração nativa envia dados diretamente do Cato para o seu locatário do Cortex, assim você pode analisar a atividade do Cato junto com dados de outras fontes em uma plataforma centralizada. Isso ajuda seu SOC a correlacionar dados, criar alertas e buscar ameaças sem necessitar de mecanismos adicionais de coleta de dados. ### **Fontes de Dados do Palo Alto Cortex** A integração do Palo Alto Cortex suporta duas fontes de dados: - **Eventos:** Gerados quando uma atividade específica ocorre na rede ou sistema, como quando uma regra de política é correspondida ou uma ameaça é detectada. Esses registros fornecem insights discretos e em tempo real sobre segurança e aplicação de políticas. Os dados são enviados usando o [esquema de eventos](https://api.catonetworks.com/documentation/#definition-EventFieldName) do Cato. - **Fluxos:** Originam-se como fluxos de rede (5-tuplas) e são enriquecidos com informações em nível de aplicação à medida que ficam disponíveis nos motores Cato. Além de contexto de aplicação e usuário, os fluxos incluem dados de sessão agregados como bytes, pacotes e duração, fornecendo uma visão completa da atividade da rede ao longo do tempo. O esquema [appStats](https://api.catonetworks.com/documentation/#definition-AppStatsFieldName) representa o conjunto completo de campos de fluxo. Por padrão, novas integrações exportam apenas **Eventos**. A fonte de dados **Fluxos** pode gerar significativamente mais dados do que a fonte de dados Eventos. O volume exato depende do seu tráfego. Você pode configurar múltiplas integrações no CMA para enviar diferentes fontes de dados conforme necessário. ### **Requisitos** - Para adicionar um conector, você deve ter permissão de editor para **Integrações** (na seção **Recursos**). Para mais informações, veja [Gerenciando Funções de Admin usando RBAC](/v1/docs/managing-admin-roles-using-rbac). - Um locatário Cortex com permissão para adicionar uma fonte de dados **Personalizado - Baseado em HTTP**. - Sua URL de ingestão do Cortex e token de coletor HTTP. - Revise os pré-requisitos para todas as integrações de eventos da Cato em [Introdução às Integrações de Eventos](/v1/docs/getting-started-with-event-integrations). ## **Casos de Uso** ### **Eventos** A Sample Company usa Cortex para monitoramento centralizado de segurança. Como cliente da Cato, ela possui dados da Cato sobre atividade de rede, ameaças, dados de usuários, dispositivos e todos os outros aspectos do tráfego que atravessa a plataforma Cato. O administrador usa esta integração para enviar esses dados diretamente para o Cortex, onde a equipe SOC trabalha com eles junto com suas outras fontes. ### **Fluxos** Um analista de segurança na Sample Company identifica um evento suspeito onde um usuário acessou uma aplicação de alto risco que pode estar associada à exfiltração de dados. Usando apenas os eventos da Cato, o analista pode ver a decisão de política, identidade de usuário e aplicação, mas não quanto de dados foi transferido ou quanto tempo durou a sessão. Com dados de fluxo agregados, o analista pode visualizar o contexto completo da sessão, incluindo total de bytes transferidos, contagem de pacotes e duração da sessão. Isso permite que o analista determine se a atividade envolveu interação mínima ou uma grande transferência de dados que pode indicar exfiltração. ## **Criando a Integração Palo Alto Cortex** Para enviar dados da Cato para Cortex, crie um coletor HTTP no Cortex, confirme que o endpoint aceita dados e então crie a integração na CMA. ### **Etapa 1: Criar o Coletor HTTP no Cortex** O Cortex exibe o valor do token apenas quando é gerado. Copie-o antes de fechar o diálogo. Se você o perder, gere um novo token e use-o em vez disso. Os valores de Fornecedor e Produto determinam o conjunto de dados para dados ingeridos e qual parser se aplica. Recomendamos os valores abaixo para consistência em todas as integrações. **Para criar o coletor:** 1. Faça login no seu locatário Cortex. 2. Vá para **Personalizado - Coletor baseado em HTTP** e clique em **Adicionar Instância**. 3. No diálogo **Habilitar Coleta de Log HTTP**, insira um **Nome**, como `Cato Networks`. 4. Defina **Compressão** como **não comprimido** e **Formato de Log** como **JSON**. 5. **(Opcional)** Defina **Fornecedor** para `Cato Networks` e **Produto** para `Cato Cloud`. 6. Clique em **Salvar & Gerar Token**. 7. Copie o valor do token e armazene-o com segurança e anote a URL de ingestão para o coletor. ### **Etapa 2: Testar o Endpoint com curl** Antes de configurar a integração na CMA, confirme que sua chave API, endpoint e índice funcionam. Isso ajuda a isolar problemas do lado do Cortex de problemas com a integração da CMA. Use o cabeçalho `Content-Type: application/json` para corresponder as solicitações enviadas pela Integração Cato: Execute o exemplo inteiro em um shell **Bash** interativo (execute `bash` primeiro, se necessário). Insira credenciais nos prompts ocultos; não as insira no comando. O exemplo desativa a rastreação do shell e passa cabeçalhos de autenticação através da entrada padrão usando `--header @-`, mantendo 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. ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_TOKEN  IFS= read -r -s -p 'Token do coletor HTTP Cortex: ' 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' "Autorização: ${CATO_TEST_TOKEN}" | \    curl -q -X POST "https://" \  --header @- \  -H "Content-Type: application/json" \  --data-binary $'{"mensagem":"evento de teste do curl","tipo_evento":"teste"}\n' ) ``` 1. Substitua `<your-collector-url>` pela URL do seu coletor. 2. Insira o token do coletor HTTP da Etapa 1 no prompt oculto. Uma solicitação bem-sucedida retorna um status HTTP 2xx. 3. No Cortex, pesquise por `teste de evento do curl` para confirmar que o documento chegou. ### **Passo 3: Criar a Integração no CMA** **Para criar a integração do Palo Alto Cortex:** 1. No menu de navegação do CMA, vá para **Recursos** > **Integrações**. 2. Abra a aba **Integrações Configuradas** e clique em **Novo** O painel **Nova Integração** será aberto. 3. Selecionar **Palo Alto Cortex**. A **Capacidade** é definida automaticamente como **Exportação de Dados**. 4. No menu suspenso de **Autenticação**, selecione **Autenticação por Token de coletor HTTP para Palo Alto Cortex**. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(252).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A49%3A30Z&se=2026-11-19T06%3A49%3A30Z&sr=b&sp=r&sig=%2Fe7sJYj6cSEnUf4vha85%2FkeE659hJxNacbHwgmCl8Nc%3D) 5. Insira um **Nome** para esta integração e uma **Descrição** opcional. 6. Digite a **URL de Ingestão** que você testou no Passo 2, por exemplo `https://api-tenant.xdr.us.paloaltonetworks.com/logs/v1/event`. 7. Digite o **Token de Coletor HTTP** que você gerou no Cortex. 8. Em **Fontes de Dados**, selecione **Eventos**, **Fluxos** ou ambos. 9. **(Opcional)** Adicione filtros para controlar quais dados são enviados para o Cortex, [como descrevemos abaixo](/docs/pt-br/integrating-cato-data-with-cortex-xdr#filters). 10. Clique em **Salvar**. Atualize a página de **Integrações**. A integração aparece na tabela **Integrações Configuradas** com o status **Conectado**. ## **Filtros** Use filtros para controlar quais dados do Cato são exportados para o Cortex. Isso ajuda a reduzir custos de ingestão, minimizar ruído e focar investigações nos dados mais relevantes para locais, usuários ou regiões específicos. Você também pode usar filtros para direcionar diferentes subconjuntos de dados para diferentes ambientes SIEM. Use grupos de filtros para definir filtros com base em qualquer [Campo de Evento](/v1/docs/cato-event-schema) ou combinação de campos. As condições dentro de cada grupo usam lógica E. A lógica OU é aplicável entre grupos. - **Filtro de Eventos** - Clique em **Adicionar Filtro** para definir uma condição ou **Adicionar Grupo** para adicionar um grupo de filtros. - **Filtro de Fluxos** - Disponível quando **Fluxos** é selecionado como uma fonte de dados. Segue a mesma lógica do Filtro de Eventos. Filtros que são muito restritos podem excluir tudo sem mostrar qualquer erro. Se nenhum dado chegar ao Cortex após salvar a integração, verifique primeiro a configuração do filtro. ## **Troubleshooting** | **Problemas** | **Solução** | | --- | --- | | A integração mostra um **Erro de Conectividade** | Verifique se a URL de Ingestão e o Token de Coletor HTTP estão corretamente inseridos e se correspondem ao que você testou no Passo 2. Confirme que o token não foi revogado no Cortex. | | Os eventos chegam mas aparecem como texto bruto em vez de campos analisados | Confirme que o coletor está definido para o formato de log **JSON** e para **não comprimido**, conforme descrito na Etapa 1. | | Nenhum evento chega no Cortex | Verifique o Filtro de Eventos. Um filtro que é muito restrito pode excluir todos os dados sem relatar um erro. | | Nenhum fluxo chega no Cortex | Confirme que **Fluxos** está selecionado em **Fontes de Dados**, e verifique o Filtro de Fluxos por condições que são muito restritivas. | | A integração não exibe um status **Conectado** após você salvá-la | Atualize a página de **Integrações**. Se o status não mudar, verifique o token do coletor HTTP e a URL de ingestão no Cortex. |