Collecter les journaux VMware Horizon

Compatible avec :

Ce document explique comment ingérer les journaux Omnissa Horizon (anciennement VMware Horizon) dans Google Security Operations à l'aide de Bindplane. L'analyseur syntaxique utilise d'abord des expressions régulières (modèles Grok) pour extraire les champs des messages syslog bruts. Il mappe ensuite les champs extraits aux champs correspondants du schéma UDM Chronicle, en normalisant et en structurant les données pour l'analyse.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Instance Google SecOps
  • Windows 2016 ou version ultérieure, ou un hôte Linux avec systemd
  • Si vous exécutez le programme derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.
  • Accès privilégié à Omnissa Horizon 8

Obtenir le fichier d'authentification d'ingestion Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres du SIEM > Agents de collecte.
  3. Téléchargez le fichier d'authentification d'ingestion. Enregistrez le fichier de manière sécurisée sur le système sur lequel Bindplane sera installé.

Obtenir l'ID client Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres SIEM> Profil.
  3. Copiez et enregistrez le numéro client de la section Informations sur 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 fenêtres

  1. Ouvrez l'invite de commandes 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 de Linux

  1. Ouvrez un terminal avec les droits root 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 plus d'options d'installation, consultez le 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 règle générale, il se trouve dans le répertoire /etc/bindplane-agent/ 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 le Bloc-notes).
  2. Modifiez le fichier config.yaml comme suit :

    receivers:
        udplog:
            # Replace the port and IP address as required
            listen_address: "0.0.0.0:514"
    
    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: <customer_id>
            endpoint: malachiteingestion-pa.googleapis.com
            # Add optional ingestion labels for better organization
            log_type: 'VMWARE_HORIZON'
            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 <customer_id> par le numéro client réel.
    • Mettez à jour /path/to/ingestion-authentication-file.json en indiquant le chemin d'accès où le fichier d'authentification a été enregistré dans la section Obtenir le fichier d'authentification pour l'ingestion Google SecOps.

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

  • Pour redémarrer l'agent Bindplane sous Linux, exécutez la commande suivante :

    sudo systemctl restart bindplane-agent
    
  • Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configurer Syslog pour Omnissa Horizon (anciennement VMware Horizon)

  1. Connectez-vous à l'interface utilisateur Web Onmissa Horizon.
  2. Accédez à Paramètres> Configuration des événements.
  3. Dans la section Send to syslog servers (Envoyer aux serveurs Syslog), cliquez sur Add (Ajouter).
  4. Saisissez l'adresse IP et le numéro de port de l'agent Bindplane (assurez-vous de configurer le protocole Bindplane sur UDP).
  5. Cliquez sur Enregistrer.

Table de mappage UDM

Champ du journal Mappage UDM Logique
ActionId metadata.product_log_id La valeur de "ActionId" du journal brut est mappée sur "metadata.product_log_id".
admin_domain principal.administrative_domain La valeur "admin_domain" du journal brut est mappée sur "principal.administrative_domain".
BrokerName principal.hostname La valeur de "BrokerName" du journal brut est mappée sur "principal.hostname".
BrokerSessionId network.session_id La valeur de "BrokerSessionId" du journal brut est mappée sur "network.session_id".
ClientIpAddress principal.ip La valeur de "ClientIpAddress" du journal brut est mappée sur "principal.ip".
CurrentSessionLength network.session_duration.seconds La valeur de "CurrentSessionLength" du journal brut est convertie en entier, puis mappée sur "network.session_duration.seconds".
description metadata.description La valeur de "description" du journal brut est mappée sur "metadata.description".
DesktopDisplayName principal.hostname La valeur de "DesktopDisplayName" du journal brut est mappée sur "principal.hostname".
EventType metadata.product_event_type La valeur de "EventType" du journal brut est mappée à "metadata.product_event_type".
ForwardedClientIpAddress principal.nat_ip La valeur de "ForwardedClientIpAddress" du journal brut est mappée sur "principal.nat_ip".
GlobalEntitlementName target.user.group_identifiers La valeur de "GlobalEntitlementName" du journal brut est mappée sur "target.user.group_identifiers".
host principal.hostname La valeur de "host" du journal brut est mappée sur "principal.hostname".
MachineDnsName principal.url La valeur de "MachineDnsName" du journal brut est mappée sur "principal.url".
MachineName intermediary.hostname La valeur de "MachineName" du journal brut est mappée sur "intermediary.hostname".
Module additional.fields La clé "Module" avec la valeur "Module" du journal brut est ajoutée au tableau "additional.fields".
pid principal.process.pid La valeur de "pid" du journal brut est mappée sur "principal.process.pid".
PoolId additional.fields La clé "PoolId" avec la valeur "PoolId" du journal brut est ajoutée au tableau "additional.fields".
program principal.application La valeur "program" du journal brut est mappée sur "principal.application".
SessionType additional.fields La clé "SessionType" avec la valeur "SessionType" du journal brut est ajoutée au tableau "additional.fields".
Severity security_result.severity La valeur de "Gravité" du journal brut est mise en majuscules, mappée aux niveaux de gravité génériques de Chronicle, puis mappée à "security_result.severity".
timestamp metadata.event_timestamp La valeur de "timestamp" du journal brut est convertie au format Chronicle, puis mappée sur "metadata.event_timestamp".
UserDisplayName target.user.user_display_name La valeur de "UserDisplayName" du journal brut est mappée sur "target.user.user_display_name".
UserName target.user.userid La valeur "UserName" du journal brut est mappée sur "target.user.userid".
UserSID target.user.windows_sid La valeur "UserSID" du journal brut est mappée sur "target.user.windows_sid".
ViewApiMethodName additional.fields La clé "ViewApiMethodName" avec la valeur "ViewApiMethodName" du journal brut est ajoutée au tableau "additional.fields".
ViewApiServiceName additional.fields La clé "ViewApiServiceName" avec la valeur 'ViewApiServiceName' du journal brut est ajoutée au tableau "additional.fields".
extensions.auth.type La valeur est définie sur "SSO" si le champ "EventType" est l'un des suivants : "ADMIN_USERLOGGEDOUT", "AGENT_CONNECTED", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING", "AGENT_PENDING_EXPIRED", "AGENT_RECONNECTED", "BROKER_DESKTOP_REQUEST", "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", "BROKER_MACHINE_ALLOCATED", "BROKER_USER_AUTHFAILED_BAD_USER_PASSWORD", "BROKER_USER_LOCK_SSO", "BROKER_USERLOGGEDIN", "BROKER_USERLOGGEDOUT", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION", "VLSI_USERLOGGEDIN_REST", "TIMING_PROFILER_TUNNEL_CONNECTION", "TIMING_PROFILER_GET_LAUNCH_ITEMS", "TIMING_PROFILER_USER_AUTHENTICATION".
metadata.event_type La valeur est déterminée par le champ "EventType". Si "EventType" est "ADMIN_USERLOGGEDOUT", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING_EXPIRED", "BROKER_USER_LOCK_SSO" ou "BROKER_USERLOGGEDOUT", alors "metadata.event_type" est "USER_LOGOUT". Si "EventType" est "AGENT_CONNECTED", "AGENT_PENDING", "AGENT_RECONNECTED", "BROKER_USERLOGGEDIN", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION" ou "VLSI_USERLOGGEDIN_REST", alors "metadata.event_type" est "USER_LOGIN". Si "EventType" est "TIMING_PROFILER_GET_LAUNCH_ITEMS", alors "metadata.event_type" est "STATUS_UNCATEGORIZED". Si "EventType" est "AGENT_SHUTDOWN", alors "metadata.event_type" est "STATUS_SHUTDOWN". Si "EventType" est "AGENT_STARTUP" ou "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", alors "metadata.event_type" est "STATUS_STARTUP". Sinon, "metadata.event_type" est défini sur "GENERIC_EVENT".
metadata.log_type La valeur est définie sur "VMWARE_HORIZON".
metadata.product_name La valeur est définie sur "HORIZON".
metadata.vendor_name La valeur est définie sur "VMWARE".

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