--- title: "Integração dos Dados Cato com o Stellar Cyber" slug: "integrating-cato-data-with-stellar-cyber" updated: 2026-11-18T00:07:57Z published: 2026-11-18T00:07:57Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-stellar-cyber" --- > ## 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 Stellar Cyber > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## Visão geral Use a integração Stellar Cyber para analisar dados de rede e segurança da Cato na Stellar Cyber Open XDR. A integração nativa envia dados diretamente para um webhook do XDR Connect, onde você configura a normalização e mapeamentos de campo para suas rotinas de pesquisa e caça de ameaças. Você configura a integração na Aplicação de Gerenciamento da Cato (CMA). A Cato envia solicitações HTTPS POST contendo arrays JSON e autentica com um token de API da Stellar Cyber. Esta integração de **Dados Exportados** é separada da integração API do Stellar Cyber. ### Fontes de Dados do Stellar Cyber Cato suporta a exportação das seguintes fontes de dados: - **Eventos:** Registros de atividades de rede e segurança, como coincidências de política, ameaças, alterações de conectividade e atividade 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 tráfego. Selecione a fonte de dados Cato que corresponde à configuração do destino Stellar Cyber. ### Prerequisites - Permissão de Editor para **Integrações** na seção de **Recursos** do CMA. Para mais informações, veja [Gerenciando Funções de Admin usando RBAC](/v1/docs/managing-admin-roles-using-rbac). - Uma implantação Stellar Cyber com XDR Connect disponível. Para mais informações, consulte [Stellar Cyber: Configurando Conector XDR](https://docs.stellarcyber.ai/prod-docs/7.0.x/Configure/Connectors/XDR-Connector-new-UI.htm). - **Adicionar/Editar/Excluir conector XDR** acesso no RBAC do Stellar Cyber para o administrador que cria o destino, e permissão para gerar um token de API com privilégio de **Ingestão de Conector XDR**. - Registros JSON representativos de Cato para as fontes de dados que você planeja exportar, para uso na configuração de normalização. - Os pré-requisitos descritos em [Iniciando com Integrações de Eventos](/v1/docs/getting-started-with-event-integrations), incluindo qualquer necessary IP allowlisting. ## Casos de Uso ### Eventos Envie eventos Cato para o Stellar Cyber para investigar atividades de rede e segurança junto com outros dados. Por exemplo, um analista pode pesquisar um evento recente de ameaça Cato e revisar suas informações de usuário, aplicação e site. Regras automatizadas de Caça a Ameaças podem fornecer detecções adicionais e alertas personalizados. ### Fluxos Use registros de fluxo para adicionar contexto de sessão a uma investigação. Bytes transferidos, contagem de pacotes, e duração da sessão ajudam um analista a avaliar se a atividade suspeita envolveu uma conexão breve ou uma grande transferência que pode exigir uma investigação mais aprofundada. ### Using a Custom TLS Certificate (Optional) If your destination presents a certificate signed by a private Certificate Authority (CA), or a self-signed certificate, you can include the root CA certificate in the configuration. The destination’s server certificate is verified before sending data. **Note:** This is server certificate verification only. It is not client-certificate (mTLS) authentication. For destinations that use a private CA, paste the root CA certificate and any intermediate certificates. For self-signed certificates, paste the server’s own certificate. Enter only public certificates in PEM text format, up to a maximum size of 128 KiB. PFX, P12, and DER files, private keys, and CSRs are not supported. Never paste a private key. If your destination uses a certificate from a publicly trusted CA, leave the option cleared. If your destination is an on-premises SIEM or collector, you may need to allow the Cato Management Application (CMA) IP addresses to receive logs. Add these addresses to the allow list in Cato Remote Port Forwarding and in any firewall between Cato and your destination. See the [CMA IP allow list](/v1/docs/cma-ip-allowlist) for the current addresses. ## Criando a Integração Stellar Cyber Criar um token de API do Stellar Cyber e conector XDR, depois usar o URL do webhook gerado e o token para configurar a integração de Exportação de Dados no CMA. ### Etapa 1: Criar o Token de API do Stellar Cyber O Stellar Cyber recomenda uma função apenas de ingestão com o privilégio **Ingestão de Conector XDR**. As chaves API estão associadas a uma identidade em vez de a um conector individual. **Para criar o token de API:** 1. Faça login no Stellar Cyber usando uma conta com permissão para criar a chave API necessária. 2. Clique no nome da sua conta e selecione **Perfil**. 3. Na aba **Chaves API**, crie um token API para uma identidade com privilégio de **Ingestão de Conector XDR**. 4. Copie o token e armazene-o com segurança. Escolha sua expiração de acordo com a política de rotação da sua organização; Stellar Cyber recomenda uma expiração de 90 dias. ### Etapa 2: Criar o Conector XDR no Stellar Cyber **Para criar o conector de destino:** 1. Acesse **Sistema > Integrações > Conectores**, clique em **Criar** e selecione **Conector XDR**. 2. Digite um nome de conector único, como `cato_events`. 3. Em **Entrada de Log Bruto**, cole um registro JSON representativo da Cato para a fonte que você planeja exportar. Inclua os campos a serem mapeados, incluindo um timestamp e `data_source`. 4. No passo **Geral**, em **Gerar Link do Conector**, clique em **Gerar e copiar Link do Conector**. Salve o URL completo do webhook gerado. 5. Selecione o **Inquilino** de destino. 6. (Opcional) Configure **Mapeamento de Inquilino** para encaminhar registros usando um identificador de inquilino no JSON de entrada. Configure a tabela de mapeamento apropriada se os registros contiverem IDs de fornecedor do inquilino. 7. Na etapa **Normalização**, configure **Fornecedor**, **Fonte**, e **Namespace**. 8. Selecione o **Tipo de Índice** que corresponde à fonte. Stellar Cyber descreve **Syslog** para eventos e **Tráfego** para fluxos de rede. Você não pode alterar esta seleção após criar o conector. 9. Em **Mapeamento de Campo**, ative **Mapeamento de Timestamp** e selecione o campo de origem e o formato de timestamp. Sem este mapeamento, o Stellar Cyber usa o tempo de ingestão como o timestamp do evento. 10. Configure mapeamentos de campos brutos para campos de esquema do Stellar Cyber ou campos de namespace personalizados. Use **Usar Modelo** se você tiver um modelo de mapeamento. 11. Clique em **Mostrar Saída** e verifique a amostra normalizada, os tipos de campos, e o carimbo de data/hora. 12. (Opcionalmente) Configure o enriquecimento na etapa de **Enriquecimento**. 13. Clique em **Concluir & Aplicar**. Use a URL completa gerada para sua implantação. Instâncias hospedadas geralmente usam HTTPS na porta 443. Os destinos do Data Analyzer usam o hostname gerado e a porta 8889. ### Passo 3: Crie a Integração no CMA **Para criar a integração Stellar Cyber:** 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 **Stellar Cyber** e a capacidade de **dados exportados**. 4. Insira um **Nome** e uma **Descrição** opcional. 5. Para **URL de Ingestão**, cole a URL completa do webhook gerada no Passo 2. 6. (Opcional) Para incluir um certificado TLS personalizado, marque a caixa de seleção **Confiar em uma CA privada ou certificado autoassinado** e cole o certificado de CA raiz. Para mais informações, veja [Usando um Certificado TLS Personalizado](/v1/docs/integrating-cato-data-with-stellar-cyber#using-a-custom-tls-certificate). 7. Para **Token de Autenticação**, cole o token da API com privilégio de ingestão. Digite apenas o token; Cato adiciona o prefixo `Bearer`. 8. Sob **Fontes de Dados**, selecione a fonte que corresponda ao índice e a configuração de normalização do destino Stellar Cyber. 9. (Opcionalmente) Configure os filtros para a fonte selecionada. Veja [Filtros](/docs/pt-br/integrating-cato-data-with-stellar-cyber#filters). 10. Clique em **Salvar**. Cato armazena o token da API criptografado e não o exibe novamente. Atualize a integração ao girar o token. ### Passo 4: Verifique a Ingestão e Normalização **Para verificar se os dados Cato chegam ao Stellar Cyber:** 1. No CMA, abra **Integrações Configuradas** e confirme que a integração sai de **Configurando** e não mostra um erro de autenticação ou destino. Atualize a página, se necessário. 2. Gere um evento recente do Cato ou tráfego de rede para cada fonte de dados configurada. 3. No Stellar Cyber, vá para **Sistema > Integrações > Conectores** e localize o conector XDR Connect. 4. Após chegarem os registros, clique em **Ver Eventos**. Confirme que cada registro Cato aparece individualmente. 5. Selecione **Mais Informações** para um registro. Na aba **JSON**, inspecione os campos analisados. Na aba **Detalhes**, verifique os campos normalizados. 6. Verifique o locatário do destino, índice, namespace, e o carimbo de data/hora. Confirme que `data_source` corresponde à fonte Cato configurada. ## Filtros Use filtros de eventos e fluxos para limitar os dados Cato exportados para o Stellar Cyber. Isso ajuda a controlar o volume de ingestão e a focar investigações em atividades relevantes. As 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 em **Adicionar Grupo** para adicionar outro grupo de filtros. - **Filtro de Fluxos** – Disponível quando **Fluxos** está selecionado. Usa a mesma lógica de agrupamento que o filtro de eventos. Filtros que são muito restritivos podem excluir todos os registros sem relatar um erro. Se nenhum dado chegar, verifique a fonte de dados selecionada e as condições do filtro. ## Limitações Conhecidas - Tipo de Índice e Namespace não podem ser alterados após criar um conector Stellar Cyber XDR. Escolha a configuração de destino antes de habilitar a exportação. - Um conector tem um inquilino de destino padrão. O roteamento de registros para outros inquilinos requer Mapeamento de Inquilinos e um identificador apropriado no JSON de entrada. - Stellar Cyber não suporta integração de alertas de terceiros ou detecções baseadas em ML para dados ingeridos através do XDR Connect. Regras automatizadas de Caça a Ameaças podem fornecer detecções adicionais e alertas personalizados. - Chaves de API são baseadas em identidade. Use um token com privilégios apenas de ingestão e rotacione-o conforme sua política. - Não é possível personalizar o formato do corpo do pedido, o tipo de conteúdo ou o cabeçalho de autenticação na integração Cato. ## Troubleshooting | Problemas | Solução | | --- | --- | | Autenticação falha com HTTP 401 ou 403 | Confirme que o token da API é válido e sua identidade tem privilégio de **Ingestão do Conector XDR**. Substitua um token expirado ou revogado e atualize **Token de Autenticação** na CMA. | | O destino está inacessível ou retorna HTTP 404 | Copie o link webhook completo gerado. Verifique o nome do host da instância e, para um destino Analisador de Dados, a porta 8889 e a acessibilidade de rede. | | Solicitações são rejeitadas ou registros individuais não aparecem | Inspecione a resposta do destino e contate o Suporte Cato com o intervalo de tempo afetado e os detalhes do erro, excluindo o token da API. | | Os dados chegam no índice ou namespace errado | Verifique o tipo de índice e namespace do destino. Estes não podem ser editados após a criação; crie um destino com os valores corretos e atualize a integração correspondente da Cato. | | Campos ou carimbos de tempo estão incorretos | Revise o mapeamento de carimbos de tempo e campos na etapa de **Normalização**. Use uma amostra representativa e **Exibir Saída** para verificar o resultado. Sem mapeamento de carimbos de tempo, o carimbo de tempo do evento é o tempo de ingestão. | | A integração parece saudável, mas nenhum dado chega | Revise a seleção da fonte de dados e os filtros, gere atividade correspondente da Cato e verifique o locatário padrão e qualquer configuração de Mapeamento de Locatário. | | Apenas uma fonte esperada chega | Verifique a seleção da fonte de dados de cada integração Cato e os filtros em relação à configuração de destino Stellar. |