Intégration des Données Cato avec Stellar Cyber

Prev Next

Important: This integration is a preview and subject to change. The certification process is underway.

Aperçu

Utilisez l'intégration Stellar Cyber pour analyser les données de réseau et de sécurité Cato dans Stellar Cyber Open XDR. L'intégration native envoie directement les données à un webhook XDR Connect, où vous configurez la normalisation et les mappings de champs pour vos flux de travail de recherche et de chasse aux menaces.

Vous configurez l'intégration dans l'application de gestion Cato (CMA). Cato envoie des requêtes HTTPS POST contenant des tableaux JSON et s'authentifie avec un token API Stellar Cyber.

Cette intégration de données exportées est distincte de l'intégration API Stellar Cyber.

Sources de données Stellar Cyber

Cato prend en charge l'exportation des sources de données suivantes :

  • Événements : Enregistrements d'activité réseau et de sécurité, tels que correspondances de politiques, menaces, changements de connectivité et activité d'audit.

  • Flux : Enregistrements de flux réseau ajoutant contexte d'application et utilisateur et détails de session agrégés, comme octets, paquets et durée.

Chaque enregistrement inclut un champ data_source avec la valeur events ou flows. Les données de flux peuvent générer un volume considérablement supérieur aux données d'événements, selon votre trafic.

Sélectionnez la source de données Cato qui correspond à la configuration de la destination Stellar Cyber.

Pré-requis

  • Permission d'éditeur pour les Intégrations dans la section Ressources du CMA. Pour plus d'informations, voir Gestion des rôles d'administration à l'aide de RBAC.

  • Un déploiement Stellar Cyber avec XDR Connect disponible. Pour plus d'informations, consultez Stellar Cyber : Configuration du Connecteur XDR.

  • Ajouter/Modifier/Supprimer le connecteur XDR d'accès dans le RBAC de Stellar Cyber pour l'administrateur créant la destination, et la permission de générer un jeton API avec le privilège Ingestion de connecteur XDR.

  • Représentations JSON Cato des sources de données que vous prévoyez d'exporter, à utiliser lors de la configuration de la normalisation.

  • Les conditions préalables décrites dans Commencer avec l'intégration d'événements, y compris toute autorisation d'IP nécessaire.

Cas d'utilisation

Événements

Envoyez les événements Cato à Stellar Cyber pour enquêter sur l'activité réseau et de sécurité aux côtés d'autres données. Par exemple, un analyste peut rechercher un événement de menace Cato récent et examiner ses informations utilisateur, application et site. Les règles de chasse aux menaces automatisées peuvent fournir des détections supplémentaires et des alertes personnalisées.

Flux

Utilisez les enregistrements de flux pour ajouter un contexte de session à une investigation. Les octets transférés, les compteurs de paquets et la durée des sessions aident un analyste à évaluer si une activité suspecte implique une connexion brève ou un transfert important pouvant nécessiter une enquête plus approfondie.

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.

Créer l'intégration Stellar Cyber

Créez un token API Stellar Cyber et un connecteur XDR, puis utilisez l'URL de webhook générée et le token pour configurer l'intégration de l'exportation de données dans la CMA.

Étape 1: Créez le Token API de Stellar Cyber

Stellar Cyber recommande un rôle uniquement d'ingestion avec le privilège Ingestion du Connecteur XDR. Les clés API sont associées à une identité plutôt qu'à un connecteur individuel.

Pour créer le jeton API :

  1. Connectez-vous à Stellar Cyber en utilisant un compte ayant la permission de créer la clé API requise.

  2. Cliquez sur le nom de votre compte et sélectionnez Profil.

  3. Dans l'onglet Clés API, créez un token API pour une identité avec le privilège Ingestion du Connecteur XDR.

  4. Copiez le token et stockez-le de manière sécurisée. Choisissez son expiration selon la politique de rotation de votre organisation; Stellar Cyber recommande une expiration de 90 jours.

Étape 2: Créez le Connecteur XDR dans Stellar Cyber

Pour créer le connecteur de destination:

  1. Allez dans Système > Intégrations > Connecteurs, cliquez sur Créer, et sélectionnez Connecteur XDR.

  2. Entrez un nom de connecteur unique, tel que cato_events.

  3. Dans Entrée brute du journal, collez un enregistrement JSON Cato représentatif pour la source que vous prévoyez d'exporter. Incluez les champs à mapper, y compris un horodatage et source_données.

  4. À l'étape Général, sous Générer le lien du connecteur, cliquez sur Générer et copier le lien du connecteur. Enregistrez l'URL complète du webhook générée.

  5. Sélectionnez le Locataire de destination.

  6. (Optionnellement) Configurez Mapping du Locataire pour router les enregistrements à l'aide d'un identifiant de locataire dans le JSON entrant. Configurez le tableau de mappage approprié si les enregistrements contiennent les ID des locataires fournisseurs.

  7. À l'étape Normalisation, configurez Fournisseur, Source, et Espace de noms.

  8. Sélectionnez le Type d'Index correspondant à la source. Stellar Cyber décrit Syslog pour les événements et Trafic pour les flux réseau. Vous ne pouvez pas modifier cette sélection après la création du connecteur.

  9. Dans Mapping des champs, activez le Mapping des horodatages et sélectionnez le champ source et le format de l'horodatage. Sans ce mappage, Stellar Cyber utilise l'heure d'ingestion comme horodatage de l'événement.

  10. Configurez des mappages des champs bruts vers les champs du schéma Stellar Cyber ou les champs d'espace de noms personnalisés. Utilisez Use Template si vous avez un modèle de mappage.

  11. Cliquez sur Afficher le résultat et vérifiez l'échantillon normalisé, les types de champs, et le timestamp.

  12. (Optionnellement) Configurez l'enrichissement à l'étape Enrichissement.

  13. Cliquez sur Terminer & Appliquer.

Utilisez l'URL complète générée pour votre déploiement. Les instances hébergées utilisent généralement HTTPS sur le port 443. Les destinations des analyseurs de données utilisent le nom d'hôte généré et le port 8889.

Étape 3 : Créer l'intégration dans le CMA

Pour créer l'intégration Stellar Cyber :

  1. Dans le menu de navigation du CMA, allez à Ressources > Intégrations.

  2. Ouvrez l'onglet Intégrations configurées et cliquez sur Nouveau.

  3. Sélectionnez Stellar Cyber et la capacité Exportation de données.

  4. Entrez un Nom et une Description facultative.

  5. Pour URL d'ingestion, collez l'URL complète du webhook générée à l'étape 2.

  6. (Optionnel) Pour inclure un certificat TLS personnalisé, cochez la case Faire confiance à une CA privée ou à un certificat auto-signé et collez le certificat CA racine. Pour plus d'information, consultez Utilisation d'un Certificat TLS Personnalisé.

  7. Pour Jeton Porteur, collez le token API avec privilège d'ingestion. Entrez uniquement le token ; Cato ajoute le préfixe Bearer.

  8. Sous Sources de données, sélectionnez la source qui correspond au type d'index et à la configuration de normalisation de la destination Stellar Cyber.

  9. (Optionnellement) Configurez les filtres pour la source sélectionnée. Voir Filtres.

  10. Cliquez sur Sauvegarder.

Cato stocke le token API crypté et ne l'affiche pas à nouveau. Mettez à jour l'intégration lorsque vous faites tourner le token.

Étape 4 : Vérifiez l'ingestion et la normalisation

Pour vérifier que les données Cato arrivent dans Stellar Cyber :

  1. Dans le CMA, ouvrez Intégrations configurées et confirmez que l'intégration quitte Configuration et ne montre pas d'erreur d'authentification ou de destination. Rafraîchissez la page si nécessaire.

  2. Générez un événement Cato récent ou un trafic réseau pour chaque source de données configurée.

  3. Dans Stellar Cyber, allez à Système > Intégrations > Connecteurs et trouvez le connecteur XDR Connect.

  4. Après l'arrivée des enregistrements, cliquez sur Voir les événements. Confirmez que chaque enregistrement Cato apparaît individuellement.

  5. Sélectionnez Plus d'infos pour un enregistrement. Sur l'onglet JSON, inspectez les champs analysés. Sur l'onglet Détails, vérifiez les champs normalisés.

  6. Vérifiez le locataire de destination, l'index, l'espace de noms et l'horodatage. Confirmer que data_source correspond à la source Cato configurée.

Filtres

Utilisez les filtres d'événement et de flux pour limiter les données Cato exportées vers Stellar Cyber. Cela aide à contrôler le volume d'ingestion et à concentrer les enquêtes sur l'activité pertinente.

Les conditions de filtre au sein d'un groupe utilisent la logique ET. Les groupes distincts utilisent la logique OU.

  • Filtre d'Événements – Cliquez sur Ajouter un Filtre pour définir une condition, ou Ajouter un Groupe pour ajouter un autre groupe de filtres.

  • Filtre de Flux – Disponible lorsque Flux est sélectionné. Il utilise la même logique de groupe que le filtre d'événement.

Les filtres trop restrictifs peuvent exclure tous les enregistrements sans signaler d'erreur. Si aucune donnée n'arrive, vérifiez la source de données sélectionnée et les conditions de filtre.

Limitations connues

  • Le type d'index et l'espace de noms ne peuvent pas être modifiés après la création d'un connecteur Stellar Cyber XDR. Choisissez la configuration de destination avant d'activer l'exportation.

  • Un connecteur a un locataire de destination par défaut. Le routage des enregistrements vers d'autres locataires nécessite un Mappage des Locataires et un identifiant approprié dans le JSON entrant.

  • Stellar Cyber ne prend pas en charge l'intégration d'alertes tierces ou les détections basées sur ML pour les données ingérées via XDR Connect. Les règles de Chasse aux Menaces automatiques peuvent fournir des détections supplémentaires et des alertes personnalisées.

  • Les clés API sont basées sur l'identité. Utilisez un jeton avec des privilèges uniquement d'ingestion et faites-le pivoter selon votre politique.

  • Vous ne pouvez pas personnaliser le format du corps de requête de l'intégration Cato, le type de contenu ou l'en-tête d'authentification.

Résolution des problèmes

Problème

Solution

L'authentification échoue avec HTTP 401 ou 403

Confirmez que le token API est valide et que son identité dispose du privilège de Ingestion de Connecteur XDR. Remplacez un token expiré ou révoqué et mettez à jour le Jeton Porteur dans le CMA.

La destination est inaccessible ou renvoie HTTP 404

Copiez le lien de webhook généré complet. Vérifiez le nom d'hôte de l'instance et, pour une destination d'Analyser de Données, le port 8889 et la connectivité réseau.

Les demandes sont rejetées ou les enregistrements individuels n'apparaissent pas

Inspectez la réponse de la destination et contactez le Support Cato avec la plage de temps affectée et les détails de l'erreur, en excluant le token API.

Les données arrivent dans le mauvais index ou espace de noms

Vérifiez le type d'index et l'espace de noms de la destination. Ces éléments ne peuvent être modifiés après la création ; créez une destination avec les valeurs correctes et mettez à jour l'intégration Cato correspondante.

Les champs ou les horodatages sont incorrects

Révisez les correspondances d'horodatage et de champ dans l'étape de Normalisation. Utilisez un échantillon représentatif et Afficher le Résultat pour vérifier le résultat. Sans correspondance d'horodatage, l'horodatage de l'événement est l'heure d'ingestion.

L'intégration semble saine mais aucune donnée n'arrive

Révisez la sélection de sources de données et les filtres, générez l'activité correspondant à Cato, et vérifiez le locataire par défaut et toute configuration de Mappage de Locataire.

Une seule source attendue arrive

Vérifiez la sélection des sources de données et les filtres de chaque intégration Cato par rapport à la configuration de destination Stellar.