--- title: "Intégration des Données Cato avec Palo Alto Cortex" slug: "integrating-cato-data-with-cortex-xdr" updated: 2026-11-14T00:10:07Z published: 2026-11-14T00:10:07Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-cortex-xdr" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Intégration des Données Cato avec Palo Alto Cortex > [!TIP] > **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](https://api.catonetworks.com/documentation/#definition-EventFieldName) 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](https://api.catonetworks.com/documentation/#definition-AppStatsFieldName) 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](/v1/docs/managing-admin-roles-using-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](/v1/docs/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 :** 1. Connectez-vous à votre locataire Cortex. 2. Accédez à **Personnalisé - Collecteur basé sur HTTP** et cliquez sur **Ajouter une instance**. 3. Dans la boîte de dialogue **Activer la collecte de journaux HTTP**, entrez un **Nom**, tel que `Cato Networks`. 4. Définissez **Compression** sur **non compressé** et **Format de journal** sur **JSON**. 5. **(Facultatif)** Définir **Fournisseur** à `Cato Networks` et **Produit** à `Cato Cloud`. 6. Cliquez sur **Sauvegarder & Générer le Token**. 7. 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. ```bash (  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' ) ``` 1. Remplacez `<your-collector-url>` par votre URL de collecteur. 2. Entrez le token du collecteur HTTP de l'étape 1 à l'invite masquée. Une requête réussie renvoie un statut HTTP 2xx. 3. Dans Cortex, recherchez `événement de test depuis curl` pour 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 :** 1. Dans le menu de navigation du CMA, allez à **Ressources** > **Intégrations**. 2. Ouvrez l'onglet **Intégrations configurées** et cliquez sur **Nouveau** Le panneau **Nouvelle intégration** s'ouvre. 3. Sélectionnez **Palo Alto Cortex**. La **Capacité** est définie automatiquement sur **Données exportées**. 4. Dans le menu déroulant **Auth**, sélectionnez **l'authentification par jeton collecteur HTTP pour Palo Alto Cortex**. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(252).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A38%3A09Z&se=2026-11-22T15%3A38%3A09Z&sr=b&sp=r&sig=io4PWgBmzrN7bRfP2Nle9y7Q3E%2B0Jj%2FfcuXAr3h%2Bm8E%3D) 5. Entrez un **Nom** pour cette intégration et une **Description** optionnelle. 6. 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`. 7. Entrez le **Jeton Collecteur HTTP** que vous avez généré dans Cortex. 8. Sous **Sources de Données**, sélectionnez **Événements**, **Flux**, ou les deux. 9. **(Optionnel)** Ajoutez des filtres pour contrôler quelles données sont envoyées à Cortex, [comme décrit ci-dessous](/docs/fr/integrating-cato-data-with-cortex-xdr#filters). 10. 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](/v1/docs/cato-event-schema) 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. |