Recopila registros de VMware Horizon

Compatible con:

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

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Instancia de Google SecOps
  • Windows 2016 o versiones posteriores, o un host de Linux con systemd
  • Si ejecutas la herramienta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos.
  • Acceso privilegiado a Omnissa Horizon 8

Obtén el archivo de autenticación de transferencia de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Collection Agents.
  3. Descarga el archivo de autenticación de transferencia. Guarda el archivo de forma segura en el sistema en el que se instalará BindPlane.

Obtén el ID de cliente de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Profile.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de BindPlane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.

Instalación en Windows

  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 en Linux

  1. Abre una terminal con privilegios de raíz 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 obtener más opciones de instalación, consulta la guía de instalación.

Configura el agente de BindPlane para transferir Syslog y enviarlo a Google SecOps

  1. Accede al archivo de configuración:
    • Ubica el archivo config.yaml. Por lo general, 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 de Servicios o ingresar el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura Syslog para Omnissa Horizon (anteriormente, VMware Horizon)

  1. Accede a la IU web de Onmissa Horizon.
  2. Ve a Configuración > Configuración de eventos.
  3. En la sección Send to syslog servers, haz clic en Add.
  4. Ingresa 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, luego, 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 agrega al array "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 de "PoolId" del registro sin procesar se agrega al array "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 de "SessionType" del registro sin procesar se agrega al array "additional.fields".
Severity security_result.severity El valor de "Gravedad" del registro sin procesar se convierte a mayúsculas, se asigna a las gravedades genéricas de Chronicle y, luego, 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, luego, 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 de "ViewApiMethodName" del registro sin procesar se agrega al array "additional.fields".
ViewApiServiceName additional.fields La clave "ViewApiServiceName" con el valor de "ViewApiServiceName" del registro sin procesar se agrega al array "additional.fields".
extensions.auth.type El valor se establece en "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", "TIMING_PROFILER_USER_AUTHENTICATION".
metadata.event_type El valor se determina según el campo "EventType". Si "EventType" es uno de los siguientes valores: "ADMIN_USERLOGGEDOUT", "AGENT_DISCONNECTED", "AGENT_ENDED", "AGENT_PENDING_EXPIRED", "BROKER_USER_LOCK_SSO" o "BROKER_USERLOGGEDOUT", entonces "metadata.event_type" es "USER_LOGOUT". Si "EventType" es uno de los siguientes valores: "AGENT_CONNECTED", "AGENT_PENDING", "AGENT_RECONNECTED", "BROKER_USERLOGGEDIN", "VLSI_USERLOGGEDIN", "VLSI_INSUFFICIENT_PERMISSION" o "VLSI_USERLOGGEDIN_REST", entonces "metadata.event_type" es "USER_LOGIN". Si "EventType" es "TIMING_PROFILER_GET_LAUNCH_ITEMS", entonces "metadata.event_type" es "STATUS_UNCATEGORIZED". Si "EventType" es "AGENT_SHUTDOWN", entonces "metadata.event_type" es "STATUS_SHUTDOWN". Si "EventType" es uno de los valores "AGENT_STARTUP" o "BROKER_LMV_REMOTE_POD_DESKTOP_LAUNCH", entonces "metadata.event_type" es "STATUS_STARTUP". De lo contrario, "metadata.event_type" es "GENERIC_EVENT".
metadata.log_type El valor se establece en "VMWARE_HORIZON".
metadata.product_name El valor se establece en "HORIZON".
metadata.vendor_name El valor se establece en "VMWARE".

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.