Intégration des Données Cato avec Exabeam

Prev Next

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

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 :

  1. Connectez-vous à Exabeam et accédez à Collecteurs > Collecteurs Cloud.

  2. Cliquez sur Nouveau Collecteur et sélectionnez Webhook.

  3. Saisissez un nom descriptif, tel que Cato Networks.

  4. Pour Format, sélectionnez JSON. Ce format permet à Exabeam d'extraire des enregistrements individuels des tableaux JSON que Cato envoie.

  5. (Optionnel) Sélectionnez un Site et un Fuseau horaire.

  6. 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é.

  7. 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 :

  1. 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.

  2. 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 bash d'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'
    )
  3. Vérifiez la réponse HTTP pour détecter une erreur. Une requête réussie retourne un statut HTTP 2xx.

  4. Dans Exabeam, recherchez ndjson log line 1 et ndjson 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 :

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

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

  3. Sélectionnez Exabeam 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 de destination générée par Exabeam.

  6. Pour Jeton Porteur, collez le token d'authentification du collecteur. Entrez uniquement le token; Cato ajoute le préfixe Bearer.

  7. Sous Sources de Données, sélectionnez Événements, Flux, ou les deux.

  8. (Optionnellement) Configurez les filtres d'événements et de flux pour contrôler quels enregistrements sont envoyés. Voir Filtres.

  9. 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 :

  1. 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.

  2. Dans Exabeam, accédez à Collecteurs > Collecteurs de Cloud > Vue d'ensemble, ouvrez le collecteur Cato et confirmez qu'il reçoit des données.

  3. Générer un événement Cato récent ou un trafic réseau pour chaque source de données sélectionnée.

  4. 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 valeurs events et flows.

  5. 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 /logs/json.

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.

Ressources supplémentaires