Important: This integration is a preview and subject to change. The certification process is underway.
Aperçu
Utilisez l'intégration TrendAI pour analyser les données de réseau et de sécurité Cato aux côtés d'autres données de sécurité dans TrendAI Vision One Agentic SIEM. L'intégration native envoie des données via HTTPS à un collecteur de collecte d'événements HTTP TrendAI, permettant à votre SOC de rechercher des enregistrements Cato et de les utiliser dans ses workflows de surveillance et d'enquête.
Vous configurez l'intégration dans l'Application de Gestion Cato (CMA). Cato envoie des tableaux JSON avec Content-Type: application/json et s'authentifie avec un jeton porteur généré dans TrendAI.
Sources de Données TrendAI
Vous pouvez sélectionner Événements, Flux, ou les deux :
Événements: Enregistrements d'activité de réseau et de sécurité, tels que les correspondances de politique de déploiement, les menaces, les modifications de connectivité et l'activité d'audit.
Flux: Enregistrements de flux de réseau qui ajoutent le contexte d'application et d'utilisateur et des détails de session agrégés, tels que les octets, les paquets et la 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 nettement plus important que les données d'événement, selon votre trafic.
Pré-requis
Permission d'Éditeur pour Intégrations dans la section Ressources de la CMA. Pour plus d'informations, voir Gestion des rôles d'administration à l'aide de RBAC.
Un locataire TrendAI Vision One avec Agentic SIEM et la permission de configurer des référentiels et des collecteurs de collecte d'événements HTTP.
Crédits suffisants d'Agentic SIEM pour l'ingestion de données tierces et la rétention requise.
Les prérequis décrits dans Commencer avec les Intégrations d'Événements, y compris toute liste blanche IP requise.
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
À partir d'une alerte de point de terminaison TrendAI, recherchez les événements Cato dans l'Explorateur de Données XDR pour des informations de correspondance sur l'hôte, l'adresse IP et le temps afin d'enquêter sur l'activité réseau liée.
Flux
Passez en revue les flux Cato autour de l'alerte de point de terminaison pour évaluer les destinations que l'hôte a contactées et la quantité de données qu'il a transférée.
Création de l'Intégration TrendAI
Créer un collecteur de collecte d'événements HTTP dans un dépôt TrendAI, tester son point de terminaison avec curl, puis utiliser l'URL du point de terminaison et le jeton JWT pour configurer l'intégration dans le CMA.
Étape 1 : Créer le Collecteur d'Événements HTTP dans TrendAI
Pour préparer la destination TrendAI :
Connectez-vous à TrendAI Vision One et accédez à Agentic SIEM & XDR > Source de données et Gestion des journaux > Dépôts de journaux tiers.
Créer un dépôt de journaux ou ouvrir un dépôt existant. Sélectionnez les paramètres d'ingestion et de rétention qui correspondent à la façon dont vous prévoyez d'utiliser les données.
Vous ne pouvez pas changer le type d'ingestion d'un dépôt après sa création. L'ingestion analytique prend en charge l'analyse, la corrélation et la chasse aux menaces; l'ingestion archivale est destinée à des requêtes peu fréquentes et aux exigences de rétention.
Dans le panneau du dépôt, ouvrez l'onglet Collecteurs et cliquez sur Ajouter un collecteur.
Sélectionnez le fournisseur et le produit pour les données Cato, choisissez JSON comme format de journal, et sélectionnez le fuseau horaire utilisé par les journaux.
Entrez un nom de collecteur et une description.
Sélectionnez collecte d'événements HTTP comme méthode et copiez l'URL du point de terminaison
/hecgénérée pour le collecteur.Cliquez sur Ajouter.
Sur l'écran Générer le jeton JWT, sélectionnez la période d'expiration et cliquez sur Générer le jeton.
Copiez le jeton, stockez-le en toute sécurité, et cliquez sur Fermer.
Dans l'onglet Collecteurs du dépôt, vérifiez les détails du collecteur et l'URL du point de terminaison.
É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 à TrendAI. Cela aide à isoler les problèmes de point de terminaison et d'authentification de l'intégration Cato.
Pour tester le point de terminaison :
Utilisez l'URL complète du point de terminaison
/hecgénérée à l'étape 1 à la place de l'URL d'exemple. Entrez le jeton JWT du collecteur à l'invite cachée.Mettez à jour les horodatages d'exemple à l'heure actuelle UTC, puis exécutez la commande suivante :
Exécutez l'exemple entier dans un shell Bash interactif (exécutez d'abord
bashsi nécessaire). Entrez les identifiants à l'invite cachée; ne les insérez pas dans la commande. L'exemple désactive le traçage de la console et passe les en-têtes d'authentification via l'entrée standard en utilisant--header @-, gardant ainsi la confidentialité des identifiants hors de l'historique de la console et des lignes de commande curl. Les variables d'identification temporaires sont rejetées lorsque l'exemple est terminé.( set +axv set -euo pipefail unset CATO_TEST_TOKEN IFS= read -r -s -p 'Token JWT TrendAI : ' CATO_TEST_TOKEN builtin printf '\n' >&2 case "$CATO_TEST_TOKEN" in ''|*$'\r'*) builtin printf 'Entrez une identification non vide sans retour 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: application/json" \ -d '[{"timestamp": "2026-04-07T10:00:03Z", "msg": "ligne de journal json 1"},{"timestamp": "2026-04-07T10:00:05Z", "msg": "ligne de journal json 2"}]' )Vérifiez la réponse HTTP pour détecter une erreur. Une demande réussie retourne un statut HTTP 2xx.
Dans TrendAI, recherchez
ligne de journal json 1etligne de journal json 2dans le dépôt de destination. Confirmez que les deux enregistrements apparaissent séparément.
Ce test vérifie si la destination accepte la demande d'exemple. Vérifiez les données et l'analyse de Cato 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 TrendAI :
Dans le menu de navigation CMA, allez à Ressources > Intégrations.
Ouvrez l'onglet Intégrations activées et cliquez sur Nouveau.
Sélectionnez TrendAI et la capacité Exportation de données.
Entrez un Nom et une Description facultative.
Pour URL d'Ingestion, collez l'URL du point de terminaison
/hecgénérée complète à partir du collecteur TrendAI.Pour Jeton Porteur, collez le token JWT 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.
(Facultatif) 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 pivoter le token JWT.
Cato s'authentifie avec le JWT en utilisant l'en-tête Authorization: Bearer <token>.
Étape 4 : Vérifier l'ingestion et l'analyse
Pour vérifier que les données de Cato arrivent dans TrendAI :
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 TrendAI, ouvrez le dépôt et examinez le statut du collecteur et les informations d'ingestion.
Générer un événement Cato récent ou un trafic réseau pour chaque source de données sélectionnée.
Ouvrir XDR Explorateur de Données et rechercher les enregistrements récents de Cato en utilisant une valeur distinctive ou le champ
source_de_données. Autoriser plusieurs minutes pour l'ingestion.Vérifiez que les enregistrements apparaissent individuellement et que leurs horodatages et champs analysés correspondent à l'activité Cato. Pour chaque source sélectionnée, confirmez la valeur correspondante
événementsouflux.
Filtres
Utilisez les filtres d'événements et de flux pour limiter les données Cato exportées vers TrendAI. 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 des Flux: Disponible lorsque Flux est sélectionné. Il utilise la même logique de regroupement que le filtre d'événements.
Les 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
L'ingestion de données tierces utilise des crédits SIEM Agentic. La rétention au-delà de la période par défaut nécessite des crédits supplémentaires.
Le type d'ingestion d'un dépôt ne peut être modifié après création. Pour utiliser un type d'ingestion différent, créez un autre dépôt.
Si le jeton JWT expire ou est révoqué, la livraison s'arrête jusqu'à ce que vous mettiez à jour le jeton dans le CMA.
Vous ne pouvez pas personnaliser le format du corps de la demande 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 JWT appartient au collecteur de destination et n'a pas expiré ni été révoqué. Générez un remplacement si nécessaire et mettez à jour le Jeton Porteur dans le CMA. |
La destination est inaccessible | Copiez l'URL de point de terminaison complète des détails du collecteur TrendAI, et confirmez que le collecteur est disponible dans votre locataire. |
La destination retourne HTTP 400 ou 415 | Confirmer que le point de terminaison est l'URL |
L'intégration semble saine mais aucune donnée n'arrive | Revoir la sélection des sources de données et des filtres, générer une activité Cato correspondante, et vérifier les informations d'ingestion et les paramètres du dépôt du collecteur TrendAI. |
Seuls des événements ou seuls des flux arrivent | Vérifiez que les sources requises sont sélectionnées et que leurs filtres permettent la correspondance des enregistrements. Confirmer que chaque source est envoyée à la destination configurée pour elle. |
Les enregistrements arrivent mais les champs ne sont pas analysés | Examinez le fournisseur, le produit et les sélections de format de journal du collecteur par rapport à la configuration utilisée à l'étape 1. |