Integração dos Dados Cato com o Stellar Cyber

Prev Next

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.

  • Uma implantação Stellar Cyber com XDR Connect disponível. Para mais informações, consulte Stellar Cyber: Configurando Conector XDR.

  • 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, 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 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.

  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.

  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.