--- title: "Intégrer les Données Cato avec Google SecOps" slug: "integrating-cato-data-with-google-secops" updated: 2026-10-23T23:17:01Z published: 2026-10-23T23:17:01Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-google-secops" --- > ## 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égrer les Données Cato avec Google SecOps > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## Aperçu Utilisez l'intégration Google SecOps pour analyser les données de réseau et de sécurité Cato aux côtés d'autres télémétries de sécurité dans Google Security Operations (Google SecOps, anciennement Chronicle). L'intégration native envoie directement les données à un flux webhook HTTPS de Google SecOps pour la surveillance et l'investigation. Vous configurez l'intégration dans l'Application de Gestion Cato (CMA). Cato envoie des JSON délimités par saut de ligne, avec un enregistrement par ligne, et s'authentifie avec une clé API Google Cloud et la clé secrète du webhook du flux. Cette intégration est distincte de l'intégration Google Chronicle qui récupère des données via l'API `eventsFeed` de Cato. ### Sources de Données Google SecOps Vous pouvez sélectionner **Événements**, **Flux**, ou les deux : - **Événements :** Enregistrements de l'activité du réseau et de Sécurité, tels que les Correspondances de Politique, les Menaces, les Modifications de Connectivité et l'Activité d'Audit. - **Flux :** Enregistrements de flux Réseau qui ajoutent un contexte de l'Utilisateur et de l'Application, ainsi que 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 beaucoup plus de volume que les données d'événement, selon votre trafic. ### Pré-requis - Permission 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](/v1/docs/managing-admin-roles-using-rbac). - Une instance Google SecOps liée à un projet Google Cloud, avec l'API Chronicle activée. - Permission de créer un flux webhook dans Google SecOps et une clé API dans le projet Google Cloud lié. - Les prérequis décrits dans [Getting Started with Event Integrations](/v1/docs/getting-started-with-event-integrations), 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 systématiquement analysés. ### Événements Après avoir validé les mappings UDM, créez une règle YARA-L qui corrèle une connexion suspecte avec un événement de menace Cato pour le même utilisateur dans une fenêtre temporelle définie. ### Flux Utilisez des recherches statistiques pour identifier des transferts sortants inhabituellement grands, puis examinez les événements Cato associés pour le contexte politique ou menaçant. ## Création de l'Intégration Google SecOps Créer un flux de webhook et une clé API Google Cloud, tester le point de terminaison avec curl, puis entrer l’URL du flux et les identifiants dans le CMA. ### Étape 1 : Créer le flux webhook HTTPS dans Google SecOps **Pour créer le flux de webhook :** 1. Se connecter à Google SecOps et aller à **Paramètres > Flux**. 2. Cliquer sur **Ajouter nouveau** et entrer un **Nom du flux**, tel que `Cato Networks`. 3. Pour **Type de source**, sélectionner **Webhook**. 4. Sélectionner le **Type de journal** pour les enregistrements Cato. 5. Cliquez sur **Suivant<\/strong>.** 6. Définir **Délimiteur de séparation** à `\n` pour que Google SecOps ingère chaque enregistrement JSON limité par une nouvelle ligne en tant qu’entrée de journal distincte. 7. (Optionnellement) Configurer un **Espace de noms d’actif** et des **Étiquettes d’ingestion**. 8. Cliquer sur **Suivant**, examiner la configuration du flux, et cliquer sur **Soumettre**. 9. Cliquer sur **Générer une clé secrète**. Copier la clé et la stocker en toute sécurité avant de quitter l’écran. Google ne l’affiche pas à nouveau. 10. Sur l’onglet **Détails**, copier l’URL du point de terminaison du flux depuis **Informations sur le point de terminaison**. Utiliser l’URL complète, y compris le suffixe `:importPushLogs`. 11. Confirmer que le flux est activé. Générer une autre clé secrète invalide la clé précédente. Si vous tournez le secret après avoir configuré Cato, mettez à jour immédiatement la **Clé d’accès Webhook** dans le CMA pour éviter une interruption de la livraison. ### Étape 2 : Créer la clé API Google Cloud **Pour créer la clé API :** 1. Dans la console Google Cloud, sélectionnez le projet lié à votre instance Google SecOps. 2. Aller à **APIs & Services > Identifiants**. 3. Cliquer sur **Créer des identifiants > Clé API**. 4. Restreindre la clé à l’**API Chronicle** et enregistrer la restriction. 5. Copier la clé API et la stocker en toute sécurité. Vous pouvez également utiliser une clé API existante restreinte à l’API Chronicle pour le projet lié. ### Étape 3 : Tester le point de terminaison avec curl Avant de configurer l’intégration dans le CMA, envoyer une demande de test directement à Google SecOps. 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 `ENDPOINT_URL` par l'URL complète du feed endpoint de l'Étape 1. Lorsque cela est demandé, entrez la Clé API Google Cloud de l'Étape 2 et la clé secrète du feed de l'Étape 1. 2. Mettez à jour les échantillons de timestamps à l'heure UTC actuelle, puis exécutez la commande suivante. Conservez chaque objet JSON sur sa propre ligne ; la commande envoie les deux enregistrements dans une seule requête : Exécutez l'exemple complet dans une shell **Bash** interactive (exécutez `bash` d'abord si nécessaire). Entrez les identifiants aux suggestions cachées ; ne les insérez pas dans la commande. L'exemple désactive la traçabilité de shell et passe les en-têtes d'authentification via l'entrée standard en utilisant `--header @-`, gardant les identifiants hors de l'historique de shell et des arguments de ligne de commande curl. Les variables d'identifiants temporaires sont rejetées lorsque l'exemple se termine. ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_API_KEY CATO_TEST_WEBHOOK_SECRET  IFS= read -r -s -p 'Clé API Google Cloud : ' CATO_TEST_API_KEY  builtin printf '\n' >&2  case "$CATO_TEST_API_KEY" in    ''|*$'\r'*) builtin printf 'Entrez une crédence non vide sans retour de chariot.\n' >&2; exit 1 ;;  esac  IFS= read -r -s -p 'Clé secrète du Webhook : ' CATO_TEST_WEBHOOK_SECRET  builtin printf '\n' >&2  case "$CATO_TEST_WEBHOOK_SECRET" in    ''|*$'\r'*) builtin printf 'Entrez une crédence non vide sans retour de chariot.\n' >&2; exit 1 ;;  esac  builtin printf '%s\n' "X-goog-api-key: ${CATO_TEST_API_KEY}" "X-Webhook-Access-Key: ${CATO_TEST_WEBHOOK_SECRET}" | \    curl -q --fail --show-error --include --max-time 30 -X POST "ENDPOINT_URL" \  --header @- \  -H "Content-Type: application/json" \  --data-binary '{"message":"test event from Cato 1","timestamp":"2026-07-14T12:00:00Z"} {"message":"test event from Cato 2","timestamp":"2026-07-14T12:00:01Z"}' ) ``` 3. Vérifiez la réponse HTTP pour une erreur. Une requête réussie renvoie un statut HTTP 2xx. 4. Dans Google SecOps, recherchez les logs bruts récents pour `test event from Cato 1` et `test event from Cato 2`. Permettez plusieurs minutes pour l'ingestion, puis confirmez qu'ils apparaissent comme deux entrées de journal distinctes. Si les deux enregistrements apparaissent dans une seule entrée de journal, vérifiez que le **Délimiteur de fractionnement** du flux est défini sur `\n`. Cet échantillon vérifie la connectivité et le fractionnement des enregistrements ; il ne valide pas toutes les correspondances de parseur pour les Événements et les Flux Cato. Ce test vérifie si la destination accepte la demande d'échantillon et la divise en entrées de journal individuelles. Vérifiez les données Cato et le parsing après avoir configuré l'intégration ci-dessous. ### Étape 4 : Créez l'Intégration dans le CMA **Pour créer l'intégration Google SecOps :** 1. À partir du menu de navigation du CMA, allez sur **Ressources > Intégrations**. 2. Ouvrez l'onglet **Intégrations configurées** et cliquez sur **Nouveau**. 3. Sélectionnez **Google SecOps** et la capacité **Données exportées**. 4. Entrez un **Nom** et une **Description** facultative. 5. Pour l'URL du **Webhook**, collez l'URL du feed endpoint complet de l'Étape 1. 6. Pour **Clé API Google Cloud**, collez la clé API restreinte à l'API Chronicle. 7. Pour **Clé d'Accès Webhook**, collez la clé secrète du flux. 8. Sous **Sources de Données**, sélectionnez **Événements**, **Flux**, ou les deux. 9. (Facultatif) Configurez les filtres d'événements et de flux pour contrôler quels enregistrements sont envoyés. Voir [Filtres](/docs/fr/integrating-cato-data-with-google-secops#filters). 10. Cliquez sur Enregistrer. Cato stocke les deux clés cryptées et ne les affiche pas à nouveau. Lors de l'édition de l'intégration, laissez une clé inchangée pour conserver sa valeur stockée, ou entrez un remplacement. Cato définit automatiquement les en-têtes `X-goog-api-key`, `X-Webhook-Access-Key` et `Content-Type: application/json`. Vous n'avez pas besoin de configurer les en-têtes. ### Étape 5 : Vérifiez l'ingestion et l'analyse **Pour vérifier que les données de Cato arrivent dans Google SecOps :** 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 Google SecOps, allez à **Paramètres > Feeds**, ouvrez le flux Cato et examinez son statut et l'heure de la dernière ingestion. 3. Générez un événement Cato récent ou un trafic réseau pour chaque source de données sélectionnée. 4. Recherchez des journaux bruts récents en utilisant une étiquette d'ingestion configurée sur le flux ou une valeur d'enregistrement Cato distinctive. Vous pouvez également rechercher le champ `data_source` avec la valeur `events` ou `flows`. Accordez plusieurs minutes pour l'ingestion. 5. Vérifiez que des enregistrements individuels sont analysés et que leurs horodatages et champs mappés correspondent à l'activité de Cato. ## Filtres Utilisez des filtres d'événements et de flux pour limiter les données Cato exportées vers Google SecOps. Cela permet de contrôler le volume d'ingestion et de concentrer les enquêtes sur l'activité pertinente. Les conditions de filtrage au sein d'un groupe utilisent la logique ET. Les groupes séparés utilisent la logique OU. - **Filtre des É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 groupement que le filtre d'événements. Les filtres qui sont trop restrictifs peuvent exclure tous les dossiers sans signaler une erreur. Si aucune donnée n'arrive, vérifiez les sources de données sélectionnées et les conditions du filtre. ## Limites connues - Google SecOps prend en charge une taille maximale de requête webhook de 4 MB et un débit maximal de 15 000 requêtes par seconde (QPS) par instance. - La façon dont les enregistrements Cato se mappent dans UDM dépend du type de journal du flux et de la configuration du parseur. - La régénération du secret du flux invalide la clé précédente. Mettez à jour la **clé d'accès webhook** dans CMA lorsque vous faites tourner le secret. - Vous ne pouvez pas personnaliser le format du corps de la requête de l'intégration Cato, le type de contenu ou les noms d'en-tête. ## Résolution des problèmes | Problème | Solution | | --- | --- | | L'authentification échoue avec HTTP 401 ou 403 | Vérifiez que la clé API Google Cloud appartient au projet lié et autorise l'API Chronicle. Confirmez que le secret du flux n'a pas été remplacé, et mettez à jour les informations d'identification dans CMA si nécessaire. | | La destination est inaccessible | Copiez l'URL du point de terminaison complet à partir de **Details > Endpoint Information**, y compris `:importPushLogs`, et confirmez que le flux est activé. | | L'intégration semble saine mais aucune donnée n'arrive | Vérifiez la sélection de sources de données et les filtres, générez l'activité de correspondance Cato, et examinez le statut d'ingestion et les erreurs de parseur du flux. | | Seuls des événements ou seuls des flux arrivent | Confirmez que les sources requises sont sélectionnées et que leurs filtres permettent des enregistrements correspondants. Vérifiez que chaque source est envoyée vers le flux configuré pour elle. | | Des dossiers bruts arrivent mais les champs ne sont pas analysés | Examinez le **type de journal** du flux et la configuration du parseur par rapport à l'installation à l'étape 1. | | Les requêtes sont rejetées ou l'ingestion est retardée à haut volume | Examinez les erreurs de destination pour les limites de taille de requête ou de débit et contactez le Support Cato avec la plage de temps affectée et les détails de l'erreur, sans inclure les clés API et secrets de webhook. | ## Ressources supplémentaires - [Google SecOps : Configurer un webhook SIEM](https://docs.cloud.google.com/chronicle/docs/ingestion/setup-siem-webhook)