Recoger registros de VMware Horizon

Disponible en:

En este documento se explica cómo ingerir registros de Omnissa Horizon (antes conocido como VMware Horizon) en Google Security Operations mediante Bindplane. El analizador primero usa expresiones regulares (patrones grok) para extraer campos de mensajes syslog sin procesar. A continuación, asigna los campos extraídos a los campos correspondientes del esquema UDM de Chronicle, normalizando y estructurando los datos para el análisis.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos:

  • Instancia de Google SecOps
  • Windows 2016 o versiones posteriores, o un host Linux con systemd
  • Si se ejecuta a través de un proxy, asegúrate de que los puertos del cortafuegos estén abiertos.
  • Acceso privilegiado a Omnissa Horizon 8

Obtener el archivo de autenticación de ingestión de Google SecOps

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Agentes de recogida.
  3. Descarga el archivo de autenticación de ingestión. Guarda el archivo de forma segura en el sistema en el que se instalará Bindplane.

Obtener el ID de cliente de Google SecOps

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Perfil.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instalar el agente de Bindplane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux siguiendo las instrucciones que se indican a continuación.

Instalación de ventanas

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el siguiente comando:

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

Instalación de Linux

  1. Abre un terminal con privilegios de superusuario o sudo.
  2. Ejecuta el siguiente comando:

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

Recursos de instalación adicionales

Para ver más opciones de instalación, consulta la guía de instalación.

Configurar el agente de BindPlane para ingerir Syslog y enviarlo a Google SecOps

  1. Accede al archivo de configuración:
    • Busca el archivo config.yaml. Normalmente, se encuentra en el directorio /etc/bindplane-agent/ en Linux o en el directorio de instalación en Windows.
    • Abre el archivo con un editor de texto (por ejemplo, nano, vi o Bloc de notas).
  2. Edita el archivo config.yaml de la siguiente manera:

    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
    

Reinicia el agente de Bindplane para aplicar los cambios

  • Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:

    sudo systemctl restart bindplane-agent
    
  • Para reiniciar el agente de Bindplane en Windows, puedes usar la consola Servicios o introducir el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configurar Syslog para Omnissa Horizon (antes VMware Horizon)

  1. Inicia sesión en la interfaz de usuario web de Onmissa Horizon.
  2. Ve a Configuración > Configuración de eventos.
  3. En la sección Enviar a servidores syslog, haz clic en Añadir.
  4. Introduce la dirección IP y el número de puerto del agente de Bindplane (asegúrate de configurar el protocolo de Bindplane como UDP).
  5. Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
ActionId metadata.product_log_id El valor de "ActionId" del registro sin procesar se asigna a "metadata.product_log_id".
admin_domain principal.administrative_domain El valor de "admin_domain" del registro sin procesar se asigna a "principal.administrative_domain".
BrokerName principal.hostname El valor de "BrokerName" del registro sin procesar se asigna a "principal.hostname".
BrokerSessionId network.session_id El valor de "BrokerSessionId" del registro sin procesar se asigna a "network.session_id".
ClientIpAddress principal.ip El valor de "ClientIpAddress" del registro sin procesar se asigna a "principal.ip".
CurrentSessionLength network.session_duration.seconds El valor de "CurrentSessionLength" del registro sin procesar se convierte en un número entero y, a continuación, se asigna a "network.session_duration.seconds".
description metadata.description El valor de "description" del registro sin procesar se asigna a "metadata.description".
DesktopDisplayName principal.hostname El valor de "DesktopDisplayName" del registro sin procesar se asigna a "principal.hostname".
EventType metadata.product_event_type El valor de "EventType" del registro sin procesar se asigna a "metadata.product_event_type".
ForwardedClientIpAddress principal.nat_ip El valor de "ForwardedClientIpAddress" del registro sin procesar se asigna a "principal.nat_ip".
GlobalEntitlementName target.user.group_identifiers El valor de "GlobalEntitlementName" del registro sin procesar se asigna a "target.user.group_identifiers".
host principal.hostname El valor de "host" del registro sin procesar se asigna a "principal.hostname".
MachineDnsName principal.url El valor de "MachineDnsName" del registro sin procesar se asigna a "principal.url".
MachineName intermediary.hostname El valor de "MachineName" del registro sin procesar se asigna a "intermediary.hostname".
Module additional.fields La clave "Module" con el valor "Module" del registro sin procesar se añade a la matriz "additional.fields".
pid principal.process.pid El valor de "pid" del registro sin procesar se asigna a "principal.process.pid".
PoolId additional.fields La clave "PoolId" con el valor "PoolId" del registro sin procesar se añade a la matriz "additional.fields".
program principal.application El valor de "program" del registro sin procesar se asigna a "principal.application".
SessionType additional.fields La clave "SessionType" con el valor "SessionType" del registro sin procesar se añade a la matriz "additional.fields".
Severity security_result.severity El valor de "Severity" del registro sin procesar se escribe en mayúsculas, se asigna a gravedades genéricas de Chronicle y, a continuación, se asigna a "security_result.severity".
timestamp metadata.event_timestamp El valor de "timestamp" del registro sin procesar se convierte al formato de Chronicle y, a continuación, se asigna a "metadata.event_timestamp".
UserDisplayName target.user.user_display_name El valor de "UserDisplayName" del registro sin procesar se asigna a "target.user.user_display_name".
UserName target.user.userid El valor de "UserName" del registro sin procesar se asigna a "target.user.userid".
UserSID target.user.windows_sid El valor de "UserSID" del registro sin procesar se asigna a "target.user.windows_sid".
ViewApiMethodName additional.fields La clave "ViewApiMethodName" con el valor "ViewApiMethodName" del registro sin procesar se añade a la matriz "additional.fields".
ViewApiServiceName additional.fields La clave "ViewApiServiceName" con el valor 'ViewApiServiceName' del registro sin procesar se añade a la matriz "additional.fields".
extensions.auth.type El valor es "SSO" si el campo "EventType" es uno de los siguientes: "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" o "TIMING_PROFILER_USER_AUTHENTICATION".
metadata.event_type El valor se determina mediante el campo "EventType". Si el valor de "EventType" es "ADMIN_USERLOGGEDOUT", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING_EXPIRED", "BROKER_USER_LOCK_SSO" o "BROKER_USERLOGGEDOUT", el valor de "metadata.event_type" es "USER_LOGOUT". Si el valor de "EventType" es "AGENT_CONNECTED", "AGENT_PENDING", "AGENT_RECONNECTED", "BROKER_USERLOGGEDIN", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION" o "VLSI_USERLOGGEDIN_REST", el valor de "metadata.event_type" es "USER_LOGIN". Si "EventType" es "TIMING_PROFILER_GET_LAUNCH_ITEMS", "metadata.event_type" es "STATUS_UNCATEGORIZED". Si "EventType" es "AGENT_SHUTDOWN", "metadata.event_type" es "STATUS_SHUTDOWN". Si "EventType" es "AGENT_STARTUP" o "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", "metadata.event_type" es "STATUS_STARTUP". De lo contrario, 'metadata.event_type' es "GENERIC_EVENT".
metadata.log_type El valor es "VMWARE_HORIZON".
metadata.product_name El valor es "HORIZON".
metadata.vendor_name El valor es "VMWARE".

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.