Collecter les journaux Cisco APIC

Version de l'analyseur : 1.0

Compatible avec :

Ce document explique comment ingérer des journaux Cisco APIC dans Google Security Operations à l'aide de l'agent BindPlane.

L'analyseur extrait les champs des journaux au format syslog Cisco APIC. Il utilise grok et/ou kv pour analyser le message de journal, puis mappe ces valeurs au modèle de données unifié (UDM). Il définit également les valeurs de métadonnées par défaut pour la source et le type d'événement.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un hôte Windows 2016 ou version ultérieure, ou Linux avec systemd
  • Si vous exécutez l'agent derrière un proxy, assurez-vous que les ports de pare-feu sont ouverts conformément aux exigences de l'agent BindPlane.
  • Accès privilégié à la console de gestion Cisco APIC

Obtenir des identifiants Google SecOps pour l'agent BindPlane

Pour authentifier l'agent Bindplane auprès de Google SecOps, choisissez l'une des méthodes suivantes :

  • Nouveaux déploiements : utilisez l'API Chronicle (option 1).
  • Anciens déploiements : continuez à utiliser le fichier d'authentification d'ingestion (option 2) jusqu'à l'arrêt de l'API Ingestion le 20 juillet 2027.
  1. Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud associé à votre instance Google SecOps.
  2. Accédez à IAM et administration > Comptes de service.
  3. Cliquez sur Créer un compte de service.
  4. Fournissez les informations de configuration suivantes :
    • Nom du compte de service : saisissez un nom pour le compte (par exemple, bindplane-ingest).
    • Description du compte de service : saisissez une description (par exemple, Bindplane agent log ingestion).
  5. Cliquez sur Créer et continuer.
  6. Dans la section Autoriser ce compte de service à accéder au projet, cliquez sur Sélectionner un rôle, puis sélectionnez Éditeur Chronicle.
  7. Cliquez sur Continue (Continuer), puis sur Done (OK).
  8. Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
  9. Cliquez sur Ajouter une clé > Créer une clé.
  10. Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
  11. Enregistrez le fichier de clé sous le nom ingestion-auth.json dans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.json sous Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json sous Windows), ou mettez à jour creds_file_path dans config.yaml pour qu'il corresponde au chemin d'accès où vous l'enregistrez.
  12. Accédez à IAM et administration > Paramètres, puis copiez le numéro du projet. Vous en aurez besoin pour configurer l'exportateur.

Option 2 : Télécharger le fichier d'authentification d'ingestion (ancien)

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres > Gestion des données > Agents de collecte. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Agents de collecte.
  3. Téléchargez le fichier d'authentification d'ingestion.
  4. Enregistrez le fichier de manière sécurisée sur le système où l'agent BindPlane sera installé.

Obtenir le numéro client Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres > Administration > Profil. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Profil.
  3. Copiez et enregistrez le numéro client de la section Détails de l'organisation.

Installer l'agent BindPlane

Installez l'agent BindPlane sur votre système d'exploitation Windows ou Linux en suivant les instructions ci-dessous.

Installation de Windows

  1. Ouvrez l'invite de commande ou PowerShell en tant qu'administrateur.
  2. Exécutez la commande suivante :

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Installation sous Linux

  1. Ouvrez un terminal avec des droits d'accès racine ou sudo.
  2. Exécutez la commande suivante :

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

Ressources d'installation supplémentaires

Pour découvrir d'autres options d'installation, consultez ce guide d'installation.

Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps

  1. Accédez au fichier de configuration :
    • Trouvez le fichier config.yaml. En général, il se trouve dans le répertoire /opt/observiq-otel-collector/ sous Linux ou dans le répertoire d'installation sous Windows.
    • Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple, nano, vi ou Notepad).
  2. Modifiez le fichier config.yaml comme suit : yaml receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: YOUR_CUSTOMER_ID endpoint: chronicle.googleapis.com # Specify the log type that matches your Chronicle feed configuration # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup log_type: 'CISCO_APIC' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
  • Remplacez le port et l'adresse IP selon les besoins de votre infrastructure :
    • Remplacez <LOCATION> par la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1). L'exportateur ajoute cette valeur en préfixe à chronicle.googleapis.com.
    • Remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.
    • Remplacez YOUR_CUSTOMER_ID par le numéro client réel.
    • Remplacez /path/to/ingestion-authentication-file.json par le chemin d'accès au fichier de clé du compte de service (option 1) enregistré à l'étape 1.
    • Assurez-vous que la valeur log_type correspond au type de journal sélectionné dans la configuration de votre flux Google SecOps.

Ancien exportateur d'API d'ingestion

  • Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc exporters par le code suivant. Définissez creds_file_path sur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacez malachiteingestion-pa.googleapis.com par votre point de terminaison régional (par exemple, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: YOUR_CUSTOMER_ID
        endpoint: malachiteingestion-pa.googleapis.com
        # Specify the log type that matches your Chronicle feed configuration
        # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup
        log_type: 'CISCO_APIC'
        raw_log_field: body
        ingestion_labels:
    

Redémarrez l'agent BindPlane pour appliquer les modifications.

  1. Pour redémarrer l'agent BindPlane sous Linux, exécutez la commande suivante :

    sudo systemctl restart observiq-otel-collector
    
  2. Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :

    net stop observiq-otel-collector && net start observiq-otel-collector
    

Configurer le transfert Syslog sur Cisco APIC

Configurer les contrats de gestion (dépannage)

Si les messages syslog n'atteignent pas Google SecOps, vérifiez la configuration de l'accès de gestion :

  1. Connectez-vous à la console Cisco APIC.
  2. Accédez à Tenants > mgmt > Security Policies (Locataires > mgmt > Règles de sécurité).
  3. Vérifiez que les contrats de gestion autorisent le port UDP 514 :
    • Pour la gestion hors bande > assurez-vous que le contrat OOB autorise le port UDP 514.
    • Pour la gestion intrabande > assurez-vous que le contrat INB autorise le port UDP 514.
  4. Si nécessaire, créez ou modifiez des filtres pour autoriser le port UDP 514 pour l'EPG de gestion sélectionné.

Créer un groupe de destination de surveillance Syslog

  1. Accédez à Admin > Collecteurs de données externes > Destinations de surveillance > Syslog.
  2. Cliquez sur le signe + pour créer un groupe de destination de surveillance Syslog.
  3. Fournissez les informations de configuration suivantes :
    • Nom : saisissez un nom descriptif (par exemple, Google SecOps-Syslog).
    • Description : saisissez une description (par exemple, Syslog destination for Google Security Operations).
    • État de l'administrateur : sélectionnez Activé.
    • Format : sélectionnez aci (recommandé) ou nxos.
  4. Cliquez sur Suivant.
  5. Dans la section Create Syslog Remote Destination (Créer une destination Syslog distante), fournissez les informations de configuration suivantes :
    • Nom d'hôte/IP : saisissez l'adresse IP de l'agent BindPlane.
    • Nom : saisissez un nom descriptif pour la destination.
    • État de l'administrateur : sélectionnez Activé.
    • Gravité : sélectionnez Information (ou le niveau de gravité de votre choix).
    • Port : saisissez 514 (ou le port configuré sur l'agent BindPlane).
    • EPG de gestion : sélectionnez l'EPG de gestion approprié :
      • default (Out-of-Band) pour la gestion hors bande
      • inb-default pour la gestion intrabande
    • Fonction de transfert : sélectionnez local7 (ou la fonction de votre choix).
  6. Cliquez sur OK.
  7. Vérifiez la configuration, puis cliquez sur Finish (Terminer).

Configurer les sources syslog

Configurez les sources syslog pour envoyer différents types d'événements au groupe de destination :

Configurer la source Syslog de la règle Fabric

  1. Accédez à Fabric > Fabric Policies > Monitoring Policies (Structure > Règles de structure > Règles de surveillance).
  2. Développez default, puis sélectionnez Callhome/SNMP/Syslog.
  3. Cliquez sur le signe + pour créer une source syslog.
  4. Fournissez les informations de configuration suivantes :
    • Nom de la source : saisissez un nom (par exemple, fabric-syslog-source).
    • Gravité minimale : sélectionnez information.
    • Inclure : sélectionnez Tout cocher pour inclure les journaux d'audit, les événements, les erreurs et les journaux de session.
    • Groupe de destination : sélectionnez le groupe de destination de surveillance syslog créé précédemment.
  5. Cliquez sur Envoyer.

Configurer la source Syslog de la règle commune

  1. Accédez à Fabric > Fabric Policies > Monitoring Policies (Structure > Règles de structure > Règles de surveillance).
  2. Développez common et sélectionnez Callhome/SNMP/Syslog.
  3. Cliquez sur + pour créer une source syslog.
  4. Fournissez les informations de configuration suivantes :
    • Nom de la source : saisissez un nom (par exemple, common-syslog-source).
    • Gravité minimale : sélectionnez information.
    • Inclure : sélectionnez Tout cocher pour inclure les journaux d'audit, les événements, les erreurs et les journaux de session.
    • Groupe de destination : sélectionnez le groupe de destination de surveillance syslog créé précédemment.
  5. Cliquez sur Envoyer.

Configurer la source Syslog de la règle d'accès

  1. Accédez à Fabric > Access Policies > Monitoring Policies (Structure > Règles d'accès > Règles de surveillance).
  2. Développez default, puis sélectionnez Callhome/SNMP/Syslog.
  3. Cliquez sur le signe + pour créer une source syslog.
  4. Fournissez les informations de configuration suivantes :
    • Nom de la source : saisissez un nom (par exemple, access-syslog-source).
    • Gravité minimale : sélectionnez information.
    • Inclure : sélectionnez Tout cocher pour inclure les journaux d'audit, les événements, les erreurs et les journaux de session.
    • Groupe de destination : sélectionnez le groupe de destination de surveillance syslog créé précédemment.
  5. Cliquez sur Envoyer.

Configurer la règle de message système (facultatif)

  1. Accédez à Fabric > Fabric Policies > Monitoring Policies (Structure > Règles de structure > Règles de surveillance).
  2. Développez common > System Message Policies.
  3. Sélectionnez Policy for System Syslog Messages (Règle pour les messages Syslog du système).
  4. Sélectionnez l'établissement par défaut.
  5. Remplacez Gravité par Information.
  6. Cliquez sur Mettre à jour.

Table de mappage UDM

Champ du journal Mappage UDM Logique
fault_cause_label additional.fields Fusionné
ts metadata.event_timestamp Analysé en tant que ISO8601
event_type metadata.event_type Mappage direct
lifecycle_state metadata.product_event_type Mappage direct
host principal.asset.hostname Mappage direct
prin_ip principal.asset.ip Fusionné
host principal.hostname Mappage direct
prin_ip principal.ip Fusionné
mac principal.mac Fusionné
desc security_result.description Mappage direct
severity_detail security_result.severity_details Mappage direct
N/A metadata.product_name Constante : CISCO APIC
N/A metadata.vendor_name Constante : CISCO

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.