Collecter les journaux de données contextuelles des éléments d'adresse IP statique

Compatible avec :

Ce document explique comment ingérer des données contextuelles d'éléments d'adresse IP statique dans Google Security Operations à l'aide de Google Cloud Storage V2.

"Adresse IP statique" est un type de données contextuelles d'élément qui mappe les adresses IP statiques aux noms d'hôte et aux métadonnées d'élément. En ingérant ces données, vous enrichissez les événements dans Google SecOps avec un contexte supplémentaire sur les éléments réseau, ce qui permet d'améliorer la corrélation, l'investigation et les alertes. Comme ces données sont généralement conservées dans des systèmes sur site ou exportées sous forme de fichiers plats, vous devez les importer dans un bucket Google Cloud Storage (GCS), puis configurer un flux Google SecOps pour les ingérer.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un projet Google Cloud avec l'API Cloud Storage activée
  • Autorisations de créer et de gérer des buckets GCS
  • Autorisations permettant de gérer les stratégies IAM sur les buckets GCS
  • Données d'éléments d'adresse IP statique exportées sous forme de fichier structuré (par exemple, CSV ou JSON)
  • Accès au système ou au répertoire où sont stockés les fichiers de données d'adresses IP statiques

Créer un bucket Google Cloud Storage

  1. Accédez à la console Google Cloud.
  2. Sélectionnez votre projet ou créez-en un.
  3. Dans le menu de navigation, accédez à Cloud Storage > Buckets.
  4. Cliquez sur Créer un bucket.
  5. Fournissez les informations de configuration suivantes :

    Paramètre Valeur
    Attribuez un nom au bucket Saisissez un nom unique (par exemple, asset-static-ip-data).
    Type d'emplacement Choisissez celle qui correspond le mieux à vos besoins (régionale, birégionale ou multirégionale).
    Emplacement Sélectionnez l'emplacement le plus proche de votre instance Google SecOps (par exemple, us-central1).
    Classe de stockage Standard (recommandé pour les données fréquemment consultées)
    Access control (Contrôle des accès) Uniforme (recommandé)
    Outils de protection Facultatif : Activez la gestion des versions d'objets ou la règle de conservation.
  6. Cliquez sur Créer.

Configurer une exportation automatisée des données d'adresses IP statiques vers GCS

Les données contextuelles des éléments d'adresse IP statique sont généralement conservées sous forme de fichiers plats (CSV, JSON) sur un système interne tel qu'une plate-forme de gestion des adresses IP (IPAM), une CMDB ou une base de données d'inventaire réseau. Pour que les données de GCS restent à jour, configurez un pipeline d'exportation automatisé à l'aide de l'une des approches suivantes.

Utilisez Cloud Build déclenché par Cloud Scheduler pour exécuter une tâche d'exportation conteneurisée de manière planifiée. Cette approche ne nécessite pas de VM persistante et utilise une infrastructure gérée par Google.

  1. Créez un compte de service pour le job d'exportation :

    1. Dans la console GCP, accédez à IAM et administration > Comptes de service.
    2. Cliquez sur Créer un compte de service.
    3. Fournissez les informations de configuration suivantes :
      • Nom du compte de service : saisissez static-ip-export-sa.
      • Description du compte de service : saisissez Service account for automated Static IP data export to GCS.
    4. Cliquez sur Créer et continuer.
    5. Ajoutez les rôles suivants :
      • Administrateur des objets Storage (pour écrire des fichiers dans GCS)
      • Éditeur Cloud Build (pour exécuter des jobs Cloud Build)
    6. Cliquez sur OK.
  2. Créez un fichier de configuration Cloud Build (cloudbuild.yaml) :

    steps:
      - name: 'gcr.io/cloud-builders/gcloud'
        entrypoint: 'bash'
        args:
          - '-c'
          - |
            apt-get update && apt-get install -y curl jq
            # Export Static IP data from your source system
            # Replace with the actual command for your environment
            # Example: query IPAM API, export from CMDB, or generate from network scan
            curl -s -H "Authorization: Bearer $${API_TOKEN}" \
              "https://your-ipam-system.example.com/api/v1/static-ips" \
              -o /workspace/static_ip_data.json
            # Upload to GCS
            gcloud storage cp /workspace/static_ip_data.json \
              gs://${_BUCKET_NAME}/static-ip/static_ip_$(date -u +%Y%m%d_%H%M%S).json
    substitutions:
      _BUCKET_NAME: 'asset-static-ip-data'
    
  3. Créez un job Cloud Scheduler pour déclencher la compilation :

    1. Dans la console GCP, accédez à Cloud Scheduler.
    2. Cliquez sur Créer une tâche.
    3. Fournissez les informations de configuration suivantes :

      Paramètre Valeur
      Nom static-ip-export-daily
      Région Sélectionnez la même région que votre bucket GCS.
      Fréquence 0 2 * * * (tous les jours à 2h UTC)
      Fuseau horaire UTC (recommandé)
      Type de cible HTTP
      URL https://cloudbuild.googleapis.com/v1/projects/YOUR_PROJECT_ID/builds
      Méthode HTTP POST
      En-tête d'authentification Ajouter un jeton OAuth
      Compte de service static-ip-export-sa@YOUR_PROJECT_ID.iam.gserviceaccount.com
    4. Cliquez sur Créer.

Option 2 : Service de transfert de stockage (pour les systèmes de fichiers sur site)

Si les données d'adresse IP statique sont stockées sur un système de fichiers sur site, utilisez le service de transfert de stockage Google Cloud avec un agent de transfert.

  1. Dans la console GCP, accédez au service de transfert de stockage.
  2. Cliquez sur Créer un job de transfert.
  3. Sélectionnez Système de fichiers POSIX comme source.
  4. Suivez les instructions pour installer l'agent de transfert de stockage sur une machine ayant accès aux fichiers de données de l'adresse IP statique.
  5. Configurez le job de transfert :

    Paramètre Valeur
    Répertoire source Chemin d'accès au répertoire contenant les fichiers de données d'adresses IP statiques
    Bucket de destination asset-static-ip-data
    Chemin de destination static-ip/
    Programmation Définissez une programmation récurrente (par exemple, quotidienne).
  6. Cliquez sur Créer.

Récupérer le compte de service Google SecOps

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Cliquez sur Configurer un flux unique.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Static IP Asset Data).
  5. Sélectionnez Google Cloud Storage V2 comme Type de source.
  6. Sélectionnez IP statique comme Type de journal.
  7. Cliquez sur Get Service Account (Obtenir un compte de service).
  8. Une adresse e-mail de compte de service unique s'affiche, par exemple :

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  9. Copiez l'adresse e-mail pour l'utiliser à l'étape suivante.

Accorder des autorisations IAM au compte de service Google SecOps

Le compte de service Google SecOps doit disposer du rôle Lecteur des objets Storage sur votre bucket GCS.

  1. Accédez à Cloud Storage > Buckets.
  2. Cliquez sur le nom de votre bucket (par exemple, asset-static-ip-data).
  3. Accédez à l'onglet Autorisations.
  4. Cliquez sur Accorder l'accès.
  5. Fournissez les informations de configuration suivantes :
    • Ajouter des comptes principaux : collez l'adresse e-mail du compte de service Google SecOps (par exemple, chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com).
    • Attribuer des rôles : sélectionnez Lecteur d'objets Storage.
  6. Cliquez sur Enregistrer.

Configurer le flux Google SecOps

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Cliquez sur Configurer un flux unique.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Static IP Asset Data).
  5. Sélectionnez Google Cloud Storage V2 comme Type de source.
  6. Sélectionnez IP statique comme Type de journal.
  7. Cliquez sur Suivant.
  8. Spécifiez les valeurs des paramètres d'entrée suivants :

    • URL du bucket de stockage : saisissez l'URI du bucket GCS :

      gs://asset-static-ip-data/static-ip/
      
      • Remplacez asset-static-ip-data par le nom de votre bucket GCS.
      • Remplacez static-ip par le chemin d'accès du préfixe que vous avez configuré.
    • Option de suppression de la source : sélectionnez l'option de suppression de votre choix :

      • Jamais : ne supprime jamais les fichiers après les transferts (recommandé pour les tests).
      • Supprimer les fichiers transférés : supprime les fichiers après un transfert réussi.
      • Supprimer les fichiers transférés et les répertoires vides : supprime les fichiers et les répertoires vides une fois le transfert réussi.

    • Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours (180 jours par défaut).

    • Espace de noms de l'élément : espace de noms de l'élément.

    • Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux.

  9. Cliquez sur Suivant.

  10. Vérifiez la configuration de votre nouveau flux d'actualités sur l'écran Finaliser, puis cliquez sur Envoyer.

Table de mappage UDM

Champ du journal Mappage UDM Logique
date metadata.event_timestamp Analysé en tant que RFC 3339
client_mac network.dhcp.chaddr Mappage direct
client_hostname network.dhcp.client_hostname Mappage direct
client_ip network.dhcp.yiaddr Mappage direct
client_hostname principal.hostname Mappage direct
client_ip principal.ip Fusionné
client_mac principal.mac Fusionné
N/A metadata.event_type Constante : NETWORK_DHCP
N/A metadata.product_name Constante : PCAP DHCP
N/A network.application_protocol Constante : DHCP
N/A network.dhcp.type Constante : ACK

Journal des modifications

Afficher le journal des modifications de cet analyseur

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.