Important: This integration is a preview and subject to change. The certification process is underway.
Vue d’ensemble
Utilisez l'intégration Exabeam pour analyser les données réseau et de sécurité Cato à côté des données d'autres sources sur la plateforme Exabeam New-Scale Security Operations. L'intégration native envoie les données directement à un collecteur cloud JSON Webhook, permettant ainsi à votre SOC de rechercher des enregistrements Cato et de les utiliser dans ses flux de surveillance et d'enquête.
Vous configurez l'intégration dans l'Application de Gestion Cato (CMA). Cato envoie des requêtes POST HTTPS contenant des tableaux JSON et s'authentifie avec le jeton porteur du collecteur. L'analyse des champs Cato dans Exabeam peut nécessiter une configuration supplémentaire.
Sources de Données Exabeam
Vous pouvez envoyer Événements, Flux, ou les deux :
Événements: Enregistrements d'activité de réseau et de sécurité, tels que des correspondances de politiques, des menaces, des modifications de connectivité et des activités d'audit.
Flux: Enregistrements de flux réseau qui ajoutent le contexte des applications et des utilisateurs ainsi que des détails de session agrégés, tels que des octets, des paquets et la durée.
Chaque enregistrement comprend un champ data_source avec la valeur events ou flows. Les données de flux peuvent générer un volume nettement supérieur aux données d'événements, selon votre trafic.
Pré-requis
Autorisation 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 Exabeam New-Scale avec la permission d'administrer les Collecteurs Cloud.
Les prérequis décrits dans Commencer avec les Intégrations d'Événements, y compris tout nécessaire de la liste blanche IP.
Cas d'utilisation
Ces exemples supposent que les sources de données pertinentes sont ingérées et que les champs utilisés pour corréler les enregistrements sont analysés de manière cohérente.
Événements
Enquêtez sur un compte suspecté compromis en examinant ses événements de menaces Cato ainsi que les connexions de fournisseurs d'identité dans une chronologie de recherche Exabeam. Utilisez les informations utilisateur correspondantes et les horodatages pour construire une séquence d'activité.
Flux
Ajoutez les enregistrements de flux Cato du compte à l'enquête pour évaluer les destinations contactées, la durée de connexion et le volume de transfert.
Création de l'Intégration Exabeam
Créez un collecteur cloud JSON Webhook dans Exabeam, puis utilisez son URL de destination et de jeton d'authentification pour configurer l'intégration dans le CMA.
Étape 1 : Créez le Collecteur Cloud Webhook dans Exabeam
Pour créer le collecteur :
Connectez-vous à Exabeam et accédez à Collecteurs > Collecteurs Cloud.
Cliquez sur Nouveau Collecteur et sélectionnez Webhook.
Saisissez un nom descriptif, tel que
Cato Networks.Pour Format, sélectionnez JSON. Ce format permet à Exabeam d'extraire des enregistrements individuels des tableaux JSON que Cato envoie.
(Optionnel) Sélectionnez un Site et un Fuseau horaire.
Cliquez sur Installer. Exabeam affiche le jeton d'authentification et l'URL de destination. Copiez les deux valeurs et stockez le jeton en toute sécurité.
Cliquez sur Accéder à la vue d'ensemble et confirmez que le collecteur apparaît.
Utilisez l'URL complète générée pour votre collecteur, incluant le nom d'hôte régional et le chemin /logs/json.
Étape 2 : Tester le point de terminaison avec curl
Avant de configurer l'intégration dans le CMA, envoyez une requête de test directement à Exabeam. Cela aide à isoler les problèmes de point de terminaison et d'authentification de l'intégration Cato.
Pour tester le point de terminaison :
Remplacez
<api-fqdn>par le nom d'hôte API de votre point de terminaison de test. Entrez le jeton du collecteur à l'invite masquée. Cet exemple utilise la syntaxe Bash pour le JSON délimité par des sauts de ligne.Mettez à jour les horodatages d'échantillon à l'heure UTC actuelle, puis exécutez la commande suivante :
Exécutez l'exemple entier dans un shell Bash interactif (exécutez
bashd'abord si nécessaire). Entrez les identifiants à l'invite masquée; ne les insérez pas dans la commande. L'exemple désactive le tracé du shell et transmet les en-têtes d'authentification via l'entrée standard en utilisant--header @-, gardant les identifiants hors de l'historique du shell et des arguments en ligne de commande de curl. Les variables d'identification temporaires sont rejetées lorsque l'exemple se termine.( set +axv set -euo pipefail unset CATO_TEST_TOKEN IFS= read -r -s -p 'Jeton de collecteur Exabeam : ' CATO_TEST_TOKEN builtin printf '\n' >&2 case "$CATO_TEST_TOKEN" in ''|*$'\r'*) builtin printf 'Entrez un identifiant non vide sans retour de chariot.\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://<api-fqdn>/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' )Vérifiez la réponse HTTP pour détecter une erreur. Une requête réussie retourne un statut HTTP 2xx.
Dans Exabeam, recherchez
ndjson log line 1etndjson log line 2, et confirmez qu'ils apparaissent en tant qu'enregistrements distincts.
Ce test vérifie si la destination accepte la requête d'exemple. Vérifiez les données Cato et l'analyse après avoir configuré l'intégration ci-dessous.
Étape 3 : Créer l'Intégration dans le CMA
Pour créer l'intégration Exabeam :
Dans le menu de navigation du CMA, allez à Ressources > Intégrations.
Ouvrez l'onglet Intégrations Activées et cliquez sur Nouveau.
Sélectionnez Exabeam et la capacité Exportation de Données.
Entrez un Nom et une Description facultative.
Pour URL d'Ingestion, collez l'URL complète de destination générée par Exabeam.
Pour Jeton Porteur, collez le token d'authentification du collecteur. Entrez uniquement le token; Cato ajoute le préfixe
Bearer.Sous Sources de Données, sélectionnez Événements, Flux, ou les deux.
(Optionnellement) Configurez les filtres d'événements et de flux pour contrôler quels enregistrements sont envoyés. Voir Filtres.
Cliquez sur Sauvegarder.
Cato stocke le token chiffré et ne l'affiche plus. Mettez à jour l'intégration lorsque vous faites tourner le token du collecteur.
Étape 4 : Vérifier l'Ingestion et le Parsing
Pour vérifier que les données de Cato arrivent dans Exabeam :
Dans le CMA, examinez le statut de l'intégration. Rafraîchissez la page si nécessaire et vérifiez les erreurs d'authentification ou de destination.
Dans Exabeam, accédez à Collecteurs > Collecteurs de Cloud > Vue d'ensemble, ouvrez le collecteur Cato et confirmez qu'il reçoit des données.
Générer un événement Cato récent ou un trafic réseau pour chaque source de données sélectionnée.
Utilisez Recherche Exabeam pour trouver des enregistrements Cato récents par une valeur distinctive ou le champ
data_source. Lorsque les deux sources sont sélectionnées, vérifiez les enregistrements avec les valeurseventsetflows.Vérifiez si les champs Cato sont analysés. Si les enregistrements restent non analysés, utilisez le Générateur de Parseur Automatique d'Exabeam ou le workflow Log Stream pour configurer l'analyse, en suivant les directives d'Exabeam.
Filtres
Utilisez des filtres d'événements et de flux pour limiter les données Cato exportées vers Exabeam. Cela aide à contrôler le volume d'ingestion et à concentrer les enquêtes sur les activités pertinentes.
Les conditions de filtre au sein d'un groupe utilisent la logique ET. Les groupes séparés 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 regroupement que le filtre d'événements.
Des filtres trop restrictifs peuvent exclure tous les enregistrements sans signaler d'erreur. Si aucune donnée n'arrive, vérifiez les sources de données sélectionnées et les conditions de filtre.
Limites connues
Le Collecteur de Cloud Webhook générique d'Exabeam n'inclut pas le support de contenu préconfiguré. Vous pourriez avoir besoin de développer un analyseur pour les enregistrements Cato.
Exabeam limite les demandes de lots non compressées à 32 MB et à une durée de demande de deux minutes.
Les modifications des métadonnées de site Exabeam peuvent prendre jusqu'à cinq minutes pour apparaître dans les journaux de webhook.
Vous ne pouvez pas personnaliser le format du corps de la requête d'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 jeton appartient au collecteur de destination et qu'il n'a pas expiré ou été révoqué. Copiez ou régénérez le jeton de collecteur et mettez à jour Jeton Porteur dans le CMA. |
La destination est inaccessible ou renvoie HTTP 404 | Copiez l'URL complète de destination depuis Exabeam. Vérifiez le nom d'hôte régional et le chemin |
La destination renvoie HTTP 400 ou rejette les enregistrements | Confirmez que le collecteur utilise le format JSON et que Cato utilise l'URL de destination JSON du collecteur. |
L'intégration semble saine mais aucune donnée n'arrive | Vérifiez la sélection de la source de données et les filtres, générez une activité Cato correspondante, et consultez la Vue d'ensemble du collecteur dans Exabeam. Autorisez plusieurs minutes pour l'ingestion. |
Seuls les événements ou seuls les flux arrivent | Confirmez que les sources requises sont sélectionnées et examinez les groupes de filtres pour chaque source. |
Les enregistrements arrivent mais les champs ne sont pas analysés | Inspectez les enregistrements bruts et configurez l'analyse avec le générateur de parser automatique d'Exabeam ou le flux de journal. |
Les requêtes échouent à volume élevé | Vérifiez les erreurs du collecteur concernant les limites de taille de lot et de durée de requête. Contactez le Support Cato avec la plage de temps affectée et la réponse de destination, sans inclure les tokens d'authentification. |