--- title: "Integração dos Dados Cato com o Exabeam" slug: "integrating-cato-data-with-exabeam" updated: 2026-10-23T23:15:56Z published: 2026-10-23T23:15:56Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-exabeam" --- > ## 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 Exabeam > [!TIP] > **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 - Permissão de Editor para **Integrações** na seção **Recursos** da CMA. Para mais informações, veja [Gerenciando Funções de Admin usando RBAC](/v1/docs/managing-admin-roles-using-rbac). - Uma implementação New-Scale da Exabeam com permissão para administrar **Cloud Collectors**. - As 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 necessária. ## 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. ```bash (  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:///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](/docs/pt-br/integrating-cato-data-with-exabeam#filters). 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 - [Exabeam: Coletor de Nuvem Webhook](https://docs.exabeam.com/en/collectors/all/cloud-collectors-administration-guide/onboard-cloud-collectors/webhook-cloud-collectors/webhook-cloud-collector.html)