Collecter les journaux ClamAV

Version de l'analyseur : 3.0

Compatible avec :

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

ClamAV est un moteur antivirus Open Source conçu pour détecter les chevaux de Troie, les virus, les logiciels malveillants et d'autres menaces malveillantes. Il permet d'analyser des fichiers en ligne de commande, de mettre à jour automatiquement la base de données de signatures et d'analyser plusieurs formats de fichiers, y compris les archives, les exécutables et les documents. ClamAV fonctionne comme un daemon local (clamd) ou un scanner de ligne de commande (clamscan) sur les systèmes Linux, Unix et Windows.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Windows Server 2016 ou version ultérieure, ou hôte Linux avec systemd
  • Connectivité réseau entre l'hôte de l'agent BindPlane et le serveur ClamAV
  • Si vous exécutez l'agent derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts conformément aux exigences de l'agent BindPlane.
  • ClamAV installé et exécuté sur les points de terminaison Linux
  • Un accès root ou sudo au serveur ClamAV et à l'hôte de l'agent BindPlane

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
    
  3. Attendez que l'installation se termine.

  4. Vérifiez l'installation en exécutant la commande suivante :

    sc query observiq-otel-collector
    

    L'état du service doit être RUNNING.

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
    
  3. Attendez que l'installation se termine.

  4. Vérifiez l'installation en exécutant la commande suivante :

    sudo systemctl status observiq-otel-collector
    

    L'état du service doit être active (running).

Ressources d'installation supplémentaires

Pour obtenir des options d'installation et de dépannage supplémentaires, consultez le guide d'installation de l'agent Bindplane.

Configurer l'agent Bindplane pour ingérer syslog et envoyer les journaux à Google SecOps

Localiser le fichier de configuration

  • Linux :

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows :

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Modifiez le fichier de configuration

  1. Remplacez l'intégralité du contenu de config.yaml par la configuration suivante :

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/clamav:
        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
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: chronicle.googleapis.com
        log_type: CLAM_AV
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/clamav_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/clamav
    
  2. Remplacez les espaces réservés suivants :

    • Configuration du récepteur :

      • listen_address : définissez cette option sur 0.0.0.0:514 pour écouter toutes les interfaces sur le port UDP 514. Si le port 514 nécessite des droits racine sous Linux, utilisez 0.0.0.0:1514 et configurez rsyslog pour qu'il transfère les données vers le port 1514.
    • Configuration de l'exportateur :

      • creds_file_path : chemin d'accès complet au fichier de clé JSON du compte de service (option 1) :

        • Linux : /opt/observiq-otel-collector/ingestion-auth.json
        • Windows : C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
      • customer_id : remplacez YOUR_CUSTOMER_ID par le numéro client obtenu précédemment.

      • location : 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. Pour obtenir la liste complète, consultez Points de terminaison régionaux.

      • project : remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.

      • endpoint : laissez la valeur définie sur chronicle.googleapis.com.

      • log_type : définissez cette option sur CLAM_AV (correspondance exacte pour l'analyseur Google SecOps).

      • ingestion_labels : étiquettes facultatives au format YAML (par exemple, env: production)

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/clamav:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CLAM_AV
        raw_log_field: body
        ingestion_labels:
          env: production
    

Enregistrez le fichier de configuration.

Après avoir modifié le fichier, enregistrez-le :

  • Linux : appuyez sur Ctrl+O, puis sur Enter, puis sur Ctrl+X.
  • Windows : cliquez sur Fichier > Enregistrer.

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

  • Pour redémarrer l'agent BindPlane sous Linux :

    1. Exécutez la commande suivante :

      sudo systemctl restart observiq-otel-collector
      
    2. Vérifiez que le service est en cours d'exécution :

      sudo systemctl status observiq-otel-collector
      
    3. Recherchez les erreurs dans les journaux :

      sudo journalctl -u observiq-otel-collector -f
      
  • Pour redémarrer l'agent BindPlane sous Windows :

    1. Choisissez l'une des options suivantes :

      • Invite de commande ou PowerShell en tant qu'administrateur :

        net stop observiq-otel-collector && net start observiq-otel-collector
        
      • Console Services :

        1. Appuyez sur Win+R, saisissez services.msc, puis appuyez sur Entrée.
        2. Recherchez observIQ OpenTelemetry Collector.
        3. Effectuez un clic droit et sélectionnez Redémarrer.
    2. Vérifiez que le service est en cours d'exécution :

      sc query observiq-otel-collector
      
    3. Recherchez les erreurs dans les journaux :

      type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
      

Configurer le transfert Syslog ClamAV

Activer la journalisation syslog dans ClamAV

  1. Connectez-vous au système Linux exécutant ClamAV avec des droits racine ou sudo.
  2. Ouvrez le fichier de configuration du daemon ClamAV :

    sudo nano /etc/clamav/clamd.conf
    
  3. Recherchez la ligne contenant #LogSyslog yes ou #LogSyslog true.

  4. Supprimez le caractère de commentaire # pour activer la journalisation syslog :

    LogSyslog yes
    
  5. Facultatif : Configurez la fonctionnalité syslog. Recherchez la ligne #LogFacility LOG_LOCAL6 et annulez la mise en commentaire :

    LogFacility LOG_LOCAL6
    
  6. (Facultatif) Activez des options de journalisation supplémentaires pour obtenir des journaux plus détaillés :

    LogTime yes
    LogVerbose yes
    ExtendedDetectionInfo yes
    
    • LogTime : ajoute des codes temporels aux messages de journal.
    • LogVerbose : active la journalisation détaillée avec des informations supplémentaires.
    • ExtendedDetectionInfo : inclut la taille et le hachage du fichier avec les détections de virus
  7. Enregistrez le fichier et quittez l'éditeur :

    Appuyez sur Ctrl+O, puis sur Enter, puis sur Ctrl+X

  8. Redémarrez le daemon ClamAV pour appliquer les modifications :

    sudo systemctl restart clamav-daemon
    
  9. Vérifiez que le daemon ClamAV est en cours d'exécution :

    sudo systemctl status clamav-daemon
    

Configurer rsyslog pour transférer les journaux ClamAV

  1. Créez un fichier de configuration rsyslog pour le transfert ClamAV :

    sudo nano /etc/rsyslog.d/30-clamav-forward.conf
    
  2. Ajoutez la configuration suivante pour transférer les journaux ClamAV à l'agent BindPlane :

    # Forward ClamAV logs (LOG_LOCAL6 facility) to Bindplane agent
    if $syslogfacility-text == 'local6' then {
        action(
            type="omfwd"
            protocol="udp"
            target="BINDPLANE_AGENT_IP"
            port="514"
            queue.type="linkedList"
            queue.size="10000"
            action.resumeRetryCount="100"
        )
        stop
    }
    
  3. Remplacez BINDPLANE_AGENT_IP par l'adresse IP de l'hôte de l'agent BindPlane :

    • Si Bindplane est installé sur le même hôte que ClamAV, utilisez 127.0.0.1.
    • Si BindPlane se trouve sur un autre hôte, utilisez l'adresse IP de cet hôte (par exemple, 192.168.1.100).
  4. Si vous avez configuré Bindplane pour écouter sur un autre port (par exemple, 1514), modifiez le paramètre port en conséquence.

  5. Enregistrez le fichier et quittez l'éditeur :

    Appuyez sur Ctrl+O, puis sur Enter, puis sur Ctrl+X

  6. Validez la syntaxe de configuration rsyslog :

    sudo rsyslogd -N1
    
  7. Redémarrez rsyslog pour appliquer les modifications :

    sudo systemctl restart rsyslog
    
  8. Vérifiez que rsyslog est en cours d'exécution :

    sudo systemctl status rsyslog
    

Tester la configuration

  1. Générez une détection de virus de test à l'aide du fichier de test EICAR :

    cd /tmp
    echo 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > eicar.com
    
  2. Analysez le fichier de test avec ClamAV :

    sudo clamdscan /tmp/eicar.com
    
  3. Vérifiez que la détection apparaît dans syslog :

    sudo tail -f /var/log/syslog | grep clamd
    

    Une entrée de journal semblable à celle-ci doit s'afficher :

    Jan 15 10:30:45 hostname clamd[1234]: /tmp/eicar.com: Win.Test.EICAR_HDB-1(44d88612fea8a8f36de82e1278abb02f:68) FOUND
    
  4. Vérifiez les journaux de l'agent Bindplane pour vous assurer que les journaux sont bien transférés :

    sudo journalctl -u observiq-otel-collector -f
    
  5. Vérifiez que les journaux s'affichent dans Google SecOps :

    1. Connectez-vous à la console Google SecOps.
    2. Accédez à Recherche > Recherche UDM.
    3. Exécutez une requête de recherche pour les journaux ClamAV :

      metadata.log_type = "CLAM_AV"
      
  6. Nettoyez le fichier de test :

    sudo rm /tmp/eicar.com
    

Autre configuration : transférer tous les messages syslog vers BindPlane

Si vous souhaitez transférer tous les messages syslog (pas seulement ClamAV) vers BindPlane, utilisez cette configuration plus simple :

  1. Modifier la configuration rsyslog :

    sudo nano /etc/rsyslog.d/30-forward-all.conf
    
  2. Ajoutez la configuration suivante :

    # Forward all logs to Bindplane agent
    *.* action(
        type="omfwd"
        protocol="udp"
        target="BINDPLANE_AGENT_IP"
        port="514"
        queue.type="linkedList"
        queue.size="10000"
        action.resumeRetryCount="100"
    )
    
  3. Remplacez BINDPLANE_AGENT_IP par l'adresse IP appropriée.

  4. Enregistrez, validez et redémarrez rsyslog comme décrit dans les étapes précédentes.

Table de mappage UDM

Champ du journal Mappage UDM Logique
parsed_msg.resource.labels.instance_id observer.resource.id Valeur copiée directement
parsed_msg.labels.compute.googleapis.com/resource_name observer.resource.name Valeur copiée directement
parsed_msg.resource.type, parsed_msg.labels.container.googleapis.com/stream observer.resource.type Concaténé à partir de parsed_msg.resource.type et parsed_msg.labels.container.googleapis.com/stream avec le séparateur "/"
parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name observer.hostname Concaténation de parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name et parsed_msg.resource.labels.container_name avec des séparateurs "/"
parsed_msg.resource.labels.container_name observer.application Valeur copiée directement
parsed_msg.labels.container.googleapis.com/namespace_name observer.namespace Valeur copiée directement
parsed_msg.resource.labels.zone observer.location.country_or_region Valeur copiée directement
parsed_msg.resource.labels.pod_id observer.labels Fusionné en tant que clé "pod_id" avec la valeur de parsed_msg.resource.labels.pod_id
parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name principal.hostname Concaténation de parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name et parsed_msg.resource.labels.container_name avec des séparateurs "/"
file, _file_path target.file.full_path Valeur du fichier si elle est extraite du modèle grok, sinon de _file_path si elle est extraite du modèle grok alternatif
menace security_result.threat_name Valeur copiée directement
total_files, _outcome, threat security_result.summary Définissez sur "%{total_files} infected files found." si num_files est extrait, sinon sur "File scanned. (%{_outcome})" si _outcome est extrait, sinon "Signature de la menace %{threat} trouvée." si threat n'est pas vide
catégorie security_result.category Valeur copiée directement (définie sur "SOFTWARE_MALICIOUS" si la menace n'est pas vide)
action security_result.action Valeur copiée directement (définie sur "BLOCK" si la menace n'est pas vide, sinon sur "ALLOW" si _outcome est extrait)
parsed_msg.insertId metadata.product_log_id Valeur copiée directement
parsed_msg.logName metadata.description Valeur copiée directement
metadata.event_type Définie sur "SCAN_FILE" si une menace est détectée ou si un fichier est analysé, ou sur "STATUS_UPDATE" si le nombre de fichiers infectés est extrait
metadata.product_name Définissez cette option sur "CLAMAV".
metadata.vendor_name Définissez cette option sur "Cisco Systems".

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