Important: This integration is a preview and subject to change. The certification process is underway.
Aperçu
Utilisez l'intégration Palo Alto Cortex pour inclure les données de réseau et de sécurité de Cato dans vos flux de surveillance, de corrélation, et d'investigation existants. L'intégration native envoie les données directement de Cato à votre tenant Cortex, vous permettant d'analyser l'activité de Cato aux côtés des données provenant d'autres sources sur une plateforme centralisée. Cela aide votre SOC à corréler les données, créer des alertes, et rechercher des menaces sans nécessiter de mécanismes supplémentaires de collecte de données.
Sources de Données Palo Alto Cortex
L'intégration Palo Alto Cortex prend en charge deux sources de données :
Événements : Générés lorsqu'une activité spécifique se produit dans le réseau ou le système, par exemple lorsqu'une règle de politique est appliquée ou qu'une menace est détectée. Ces enregistrements fournissent des aperçus discrets et en temps réel de la sécurité et de l'application de la politique de déploiement. Les données sont envoyées en utilisant le schéma d'événement de Cato.
Flux : Provenant de flux réseau (5-tuple) et enrichis avec des informations au niveau des applications dès qu'elles deviennent disponibles à partir des moteurs Cato. En plus du contexte de l'application et de l'utilisateur, les flux incluent les données de session agrégées telles que les octets, les paquets et la durée, fournissant une vue complète de l'activité réseau au fil du temps. Le schéma appStats représente l'ensemble complet des champs de flux.
Par défaut, de nouvelles intégrations exportent uniquement Événements. La source de données Flux peut générer considérablement plus de données que la source de données Événements. Le volume exact dépend de votre trafic. Vous pouvez configurer plusieurs intégrations dans le CMA pour envoyer différentes sources de données selon les besoins.
Prérequis
Pour ajouter un connecteur, vous devez avoir la permission d'éditeur pour Intégrations (dans la section Ressources). Pour plus d'informations, voir Gestion des rôles d'administration à l'aide de RBAC.
Un tenant Cortex avec la permission d'ajouter une source de données Personnalisé - Collecteur basé sur HTTP.
Votre URL d'ingestion Cortex et le jeton de collecteur HTTP.
Passez en revue les prérequis pour toutes les intégrations des événements Cato dans Getting Started with Event Integrations.
Cas d'utilisation
Événements
Sample Company utilise Cortex pour la surveillance centralisée de la sécurité. En tant que client Cato, il dispose de données Cato concernant l'activité réseau, les menaces, les données utilisateur, les appareils et tous les autres aspects du trafic traversant la plateforme Cato. L'administrateur utilise cette intégration pour envoyer ces données directement à Cortex, où l'équipe SOC travaille avec elles aux côtés de leurs autres sources.
Flux
Un analyste en sécurité chez Sample Company identifie un événement suspect où un utilisateur a accédé à une application à haut risque qui peut être associée à une exfiltration de données. En utilisant uniquement les événements Cato, l'analyste peut voir la décision de politique, l'identité utilisateur et l'application, mais pas combien de données ont été transférées ni combien de temps la session a duré.
Avec les données de flux agrégées, l'analyste peut voir le contexte complet de la session, y compris le total des octets transférés, le nombre de paquets et la durée de la session. Cela permet à l'analyste de déterminer si l'activité impliquait une interaction minimale ou un transfert de données conséquent pouvant indiquer une exfiltration.
Création de l'Intégration Palo Alto Cortex
Pour envoyer les données de Cato à Cortex, créez un collecteur HTTP dans Cortex, confirmez que le point de terminaison accepte les données, puis créez l'intégration dans le CMA.
Étape 1 : Créez le collecteur HTTP dans Cortex
Cortex affiche la valeur du token seulement lorsqu'il est généré. Copiez-la avant de fermer la boîte de dialogue. Si vous la perdez, générez un nouveau token et utilisez celui-ci.
Les valeurs de Fournisseur et Produit déterminent le jeu de données pour les Données ingérées et le parser à Appliquer. Nous recommandons les valeurs ci-dessous pour la cohérence dans l'ensemble des intégrations.
Pour créer le collecteur :
Connectez-vous à votre locataire Cortex.
Accédez à Personnalisé - Collecteur basé sur HTTP et cliquez sur Ajouter une instance.
Dans la boîte de dialogue Activer la collecte de journaux HTTP, entrez un Nom, tel que
Cato Networks.Définissez Compression sur non compressé et Format de journal sur JSON.
(Facultatif) Définir Fournisseur à
Cato Networkset Produit àCato Cloud.Cliquez sur Sauvegarder & Générer le Token.
Copiez la valeur du token et stockez-la en toute sécurité, et notez l'URL d'ingestion pour le collecteur.
Étape 2 : Testez le Point de terminaison avec curl
Avant de configurer l'intégration dans le CMA, confirmez que votre clé API, point de terminaison et index fonctionnent. Cela aide à isoler les problèmes côté Cortex des problèmes liés à l'intégration CMA.
Utilisez l'en-tête Content-Type: application/json pour faire correspondre les demandes envoyées par l'intégration Cato :
Exécutez l'exemple complet dans un shell Bash interactif (exécutez bash en premier si nécessaire). Entrez des informations d'identification lors des invites masquées; ne les insérez pas dans la commande. L'exemple désactive le traçage du shell et passe les en-têtes d'authentification par l'entrée standard en utilisant --header @-, gardant ainsi les informations d'identification hors de l'historique du shell et des arguments de ligne de commande curl. Les variables d'informations 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 collecteur HTTP Cortex: ' CATO_TEST_TOKEN
builtin printf '\n' >&2
case "$CATO_TEST_TOKEN" in
''|*$'\r'*) builtin printf 'Entrez un identifiant non vide sans retours chariots.\n' >&2; exit 1 ;;
esac
builtin printf '%s\n' "Authorization: ${CATO_TEST_TOKEN}" | \
curl -q -X POST "https://<your-collector-url>" \
--header @- \
-H "Content-Type: application/json" \
--data-binary $'{"message":"événement de test à partir de curl","event_type":"test"}\n'
)Remplacez
<your-collector-url>par votre URL de collecteur.Entrez le token du collecteur HTTP de l'étape 1 à l'invite masquée.
Une requête réussie renvoie un statut HTTP 2xx.Dans Cortex, recherchez
événement de test depuis curlpour confirmer que le document est arrivé.
Étape 3 : Créer l'intégration dans le CMA
Pour créer l'intégration Palo Alto Cortex :
Dans le menu de navigation du CMA, allez à Ressources > Intégrations.
Ouvrez l'onglet Intégrations configurées et cliquez sur Nouveau
Le panneau Nouvelle intégration s'ouvre.Sélectionnez Palo Alto Cortex. La Capacité est définie automatiquement sur Données exportées.
Dans le menu déroulant Auth, sélectionnez l'authentification par jeton collecteur HTTP pour Palo Alto Cortex.
.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A27%3A40Z&se=2026-11-22T14%3A44%3A40Z&sr=b&sp=r&sig=g25Vg1NvWYI%2BsURZ2eP1jzR2iK0iG%2BMneg31St01PGY%3D)
Entrez un Nom pour cette intégration et une Description optionnelle.
Entrez l'URL d'ingestion que vous avez testée à l'étape 2, par exemple
https://api-tenant.xdr.us.paloaltonetworks.com/logs/v1/event.Entrez le Jeton Collecteur HTTP que vous avez généré dans Cortex.
Sous Sources de Données, sélectionnez Événements, Flux, ou les deux.
(Optionnel) Ajoutez des filtres pour contrôler quelles données sont envoyées à Cortex, comme décrit ci-dessous.
Cliquez sur Enregistrer.
Rafraîchissez la page Intégrations. L'intégration apparaît dans le tableau Intégrations configurées avec le statut Connecté.
Filtres
Utilisez des filtres pour contrôler quelles données Cato sont exportées vers Cortex. Cela aide à réduire les coûts d'ingestion, minimiser le bruit, et concentrer les enquêtes sur les données les plus pertinentes pour des sites spécifiques, des utilisateurs ou des régions. Vous pouvez également utiliser des filtres pour acheminer différents sous-ensembles de données vers différents environnements SIEM.
Utilisez des groupes de filtres pour définir des filtres basés sur tout Champ d'Événement ou combinaison de champs. Les conditions au sein de chaque groupe utilisent la logique ET. La logique OU est appliquée entre les groupes.
Filtre des Événements - Cliquez sur Ajouter un filtre pour définir une condition, ou sur Ajouter un groupe pour ajouter un groupe de filtres.
Filtre de Flux - Disponible lorsque Flux est sélectionné comme source de données. Il suit la même logique que le Filtre des Événements.
Les filtres trop étroits peuvent tout exclure sans afficher d'erreur. Si aucune donnée n'arrive dans Cortex après l'enregistrement de l'intégration, vérifiez d'abord la configuration du filtre.
Résolution des problèmes
Problème | Solution |
|---|---|
L'intégration montre une Erreur de Connectivité | Vérifiez que l'URL d'ingestion et le token du collecteur HTTP sont entrés correctement, et qu'ils correspondent à ce que vous avez testé à l'étape 2. Confirmez que le token n'a pas été révoqué dans Cortex. |
Les événements arrivent mais apparaissent comme du texte brut au lieu de champs analysés | Confirmez que le collecteur est configuré au format de journal JSON et à non compressé, comme décrit à l'étape 1. |
Aucun événement n'arrive dans Cortex | Vérifiez le filtre des événements. Un filtre trop restreint peut exclure toutes les données sans signaler d'erreur. |
Aucun flux n'arrive dans Cortex | Confirmez que Flux est sélectionné sous Sources de données, et vérifiez le filtre des flux pour des conditions trop restrictives. |
L'intégration ne montre pas un statut Connecté après que vous l'avez enregistré | Rafraîchissez la page Intégrations. Si le statut ne change pas, vérifiez le token du collecteur HTTP et l'URL d'ingestion dans Cortex. |