Recopila registros de Hyper-V de Windows

Se admite en los siguientes sistemas operativos:

Google SecOps SIEM

Nota: Esta función está sujeta a las Condiciones de las Ofertas de Fase Previa a la DG de las Condiciones Específicas del Servicio de Google Security Operations. Las características de la fase previa a la DG pueden tener asistencia limitada, y es posible que los cambios en las características de la fase previa a la DG no sean compatibles con otras versiones de la fase previa a la DG. Para obtener más información, consulta los Lineamientos de los Servicios de Asistencia Técnica de Google SecOps y las Condiciones Específicas del Servicio de Google SecOps.
Si esta función no está visible en tu entorno, consulta Cómo administrar las funciones en versión preliminar o comunícate con tu administrador del sistema.

En este documento, se explica cómo transferir registros de Windows Hyper-V a Google Security Operations con Bindplane.

Windows Hyper-V es un hipervisor de Microsoft que genera registros de eventos de ciclo de vida, red, almacenamiento y seguridad de la VM. El agente de Bindplane recopila los archivos de registro de eventos de Hyper-V exportados directamente desde el sistema de archivos local.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

• Una instancia de Google SecOps
• Windows Server 2016 o versiones posteriores con compatibilidad de servicios de observiq-otel-collector
• Si se ejecuta detrás de un proxy, asegúrate de que los puertos de firewall estén abiertos según los requisitos del agente de Bindplane.
• Acceso con privilegios al host de Hyper-V de Windows con permisos de administrador

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

1. Accede a la consola de Google SecOps.
2. Ve a Configuración de SIEM > Agentes de recopilación.

3. Descarga el archivo de autenticación de transferencia. Guarda el archivo de forma segura en el sistema en el que se instalará Bindplane.

   Nota: Este archivo JSON contiene credenciales para autenticar el agente de Bindplane en Google SecOps.

Obtén el ID de cliente de Google SecOps

1. Accede a 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.

   Nota: Se requiere el ID del cliente para configurar el exportador del agente de Bindplane.

Instala el agente de Bindplane

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

Instalación en Windows

1. Abre el símbolo del sistema o PowerShell como administrador.

2. Ejecuta el comando siguiente:

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

3. Espera a que se complete la instalación.

4. Ejecuta el siguiente comando para verificar la instalación:

   sc query observiq-otel-collector
   

El servicio debe mostrarse como RUNNING.

Recursos de instalación adicionales

Para obtener más opciones de instalación y solucionar problemas, consulta la guía de instalación del agente de Bindplane.

Configura el agente de BindPlane para transferir registros y enviarlos a Google SecOps

Ubica el archivo de configuración

• Windows:

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

Edita el archivo de configuración

• Reemplaza todo el contenido de config.yaml por la siguiente configuración:

  receivers:
      filelog:
          include:
              - C:\HyperVLogs\*.evtx
          start_at: beginning
  
  exporters:
      chronicle/windows_hyperv:
          compression: gzip
          creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json'
          customer_id: '<customer_id>'
          endpoint: malachiteingestion-pa.googleapis.com
          log_type: WINDOWS_HYPERV
          raw_log_field: body
          ingestion_labels:
              env: production
  
  service:
      pipelines:
          logs/hyperv_to_chronicle:
              receivers:
                  - filelog
              exporters:
                  - chronicle/windows_hyperv
  

Parámetros de configuración

Reemplaza los marcadores de posición que se indican más abajo:

• Configuración del receptor:

  • filelog: Tipo de receptor para recopilar archivos de registro del disco
  • include: Es una lista de rutas de acceso a archivos para supervisar. Establece esta opción en la ubicación en la que exportas los registros de eventos de Hyper-V (por ejemplo, C:\HyperVLogs\*.evtx).
  • start_at: Configúralo como beginning para leer los registros existentes o end para leer solo las entradas nuevas

• Configuración del exportador:

  • windows_hyperv: Nombre descriptivo del exportador
  • creds_file_path: Ruta de acceso completa al archivo de autenticación de la transferencia:
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • <customer_id>: ID del cliente del paso anterior
  • endpoint: URL del endpoint regional:
    • EE.UU.: malachiteingestion-pa.googleapis.com
    • Europa: europe-malachiteingestion-pa.googleapis.com
    • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
    • Consulta Extremos regionales para obtener la lista completa.
  • WINDOWS_HYPERV: Tipo de registro tal como aparece en Chronicle
  • ingestion_labels: Etiquetas opcionales en formato YAML (por ejemplo, env: production)

• Configuración de la canalización:

  • hyperv_to_chronicle: Nombre descriptivo de la canalización

Cómo guardar el archivo de configuración

• Después de editarlo, guarda el archivo:
  • Windows: Haz clic en Archivo > Guardar.

Reinicia el agente de Bindplane para aplicar los cambios

Para reiniciar el agente de Bindplane en Windows, haz lo siguiente:

1. Elige una de las siguientes opciones:

   • Símbolo del sistema o PowerShell como administrador:

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

   • Consola de Services:
     1. Presiona Win+R, escribe services.msc y presiona Intro.
     2. Busca observIQ OpenTelemetry Collector.
     3. Haz clic con el botón derecho y selecciona Reiniciar.

2. Verifica que el servicio esté en ejecución:

   sc query observiq-otel-collector
   

3. Revisa los registros en busca de errores:

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

Configura la exportación de registros de Windows Hyper-V

Los registros de Hyper-V de Windows se almacenan como entradas del registro de eventos de Windows. Debes exportar estos registros a archivos en el disco para que el agente de BindPlane pueda recopilarlos.

1. Crea un directorio para almacenar los archivos de registro exportados:

   mkdir C:\HyperVLogs
   

2. Exporta registros de eventos de Hyper-V con wevtutil:

   wevtutil epl Microsoft-Windows-Hyper-V-VMMS-Admin C:\HyperVLogs\hyperv-vmms-admin.evtx
   wevtutil epl Microsoft-Windows-Hyper-V-Worker-Admin C:\HyperVLogs\hyperv-worker-admin.evtx
   

   Puedes exportar canales de eventos de Hyper-V adicionales según sea necesario. Los canales disponibles incluyen los siguientes:

   • Microsoft-Windows-Hyper-V-VMMS-Admin (Servicio de administración de máquinas virtuales)
   • Microsoft-Windows-Hyper-V-Worker-Admin (procesos de VM de trabajador)
   • Microsoft-Windows-Hyper-V-Hypervisor-Admin (Eventos del hipervisor)
   • Microsoft-Windows-Hyper-V-Config-Admin (eventos de configuración)

3. (Opcional) Programa exportaciones periódicas con PowerShell:

   $action = New-ScheduledTaskAction -Execute "cmd.exe" -Argument '/c wevtutil epl Microsoft-Windows-Hyper-V-VMMS-Admin C:\HyperVLogs\hyperv-vmms-admin.evtx /ow:true && wevtutil epl Microsoft-Windows-Hyper-V-Worker-Admin C:\HyperVLogs\hyperv-worker-admin.evtx /ow:true'
   $trigger = New-ScheduledTaskTrigger -RepetitionInterval (New-TimeSpan -Hours 1) -Once -At (Get-Date)
   Register-ScheduledTask -Action $action -Trigger $trigger -TaskName "ExportHyperVLogs" -Description "Export Hyper-V logs for Bindplane agent"
   

4. Verifica que los archivos de registro exportados se creen en `C:\HyperVLogs`.

5. Asegúrate de que la ruta de acceso include del agente de BindPlane en config.yaml coincida con el directorio de exportación.

   Nota: La marca /ow:true reemplaza los archivos de exportación existentes. La cuenta de servicio del agente de Bindplane debe tener acceso de lectura al directorio de exportación.

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
channel, event_data.data, event_id.id, event_id.qualifiers, keywords, task, SeverityValue, OpcodeValue, EventID, ProviderGuid, ActivityId, Version, RecordNumber, ProcessID, ThreadID, Channel, AccountName, UserID, AccountType, Opcode, SourceModuleName, SourceModuleType	additional.fields	Se combinaron con las etiquetas creadas a partir de estos campos.
system_time, EventReceivedTime	metadata.collected_timestamp	Se analiza a partir de system_time con formatos o de EventReceivedTime como UNIX o UNIX_MS.
Mensaje	metadata.description	El valor se copió directamente.
EventTime, EventReceivedTime	metadata.event_timestamp	Se analizó a partir de EventTime como UNIX o UNIX_MS, o a partir de EventReceivedTime como UNIX o UNIX_MS.
	metadata.event_type	Se establece en "PROCESS_LAUNCH" si tiene principal y tiene proceso de destino; de lo contrario, se establece en "USER_LOGIN" si tiene principal y tiene destino, pero no tiene proceso de destino; de lo contrario, se establece en "STATUS_UPDATE" si tiene principal, pero no tiene destino; de lo contrario, se establece en "USER_RESOURCE_ACCESS" si tiene destino; de lo contrario, se establece en "GENERIC_EVENT".
provider.event_source	metadata.product_event_type	El valor se copió directamente.
record_id, RecordNumber	metadata.product_log_id	Se convierte en cadena a partir de record_id si no está vacío o de RecordNumber si no está vacío.
provider.name, SourceName	metadata.product_name	Valor de provider.name si no está vacío; de lo contrario, SourceName si no está vacío; de lo contrario, "Microsoft-Windows-Hyper-V"
Versión	metadata.product_version	Se convirtió en cadena
mensaje	network.session_duration.nanos	Se extrae del mensaje con un patrón de grok y se convierte en un número entero.
Dominio	principal.administrative_domain	El valor se copió directamente.
computadora	principal.asset.hostname	El valor se copió directamente.
computadora, Nombre de host	principal.hostname	Valor de la computadora si no está vacío y, luego, del nombre de host si no está vacío
AccountName	principal.user.role_description	El valor se copió directamente.
AccountType	principal.user.role_name	El valor se copió directamente.
event_data.name	principal.user.user_display_name	El valor se copió directamente.
security.user_id, UserID	principal.user.userid	Valor de security.user_id si no está vacío y, luego, de UserID si no está vacío
mensaje	security_result.description	Se extrae del mensaje con un patrón de grok
message, ActivityId	security_result.detection_fields	Se fusionó con la etiqueta de nt_status extraída del mensaje con grok y de ActivityId.
level, Severity	security_result.severity	Se establece según el valor del nivel (1-3 INFORMATIONAL, 4 ERROR, 5 CRITICAL, de lo contrario, UNKNOWN_SEVERITY) o según la gravedad (INFO INFORMATIONAL, WARN MEDIUM, ERROR ERROR).
EventType	security_result.severity_details	El valor se copió directamente.
execution.process_id, ProcessID	target.process.pid	Se convierte en una cadena a partir de execution.process_id si no está vacío, o de ProcessID si no está vacío.
execution.thread_id, ThreadID	target.process.product_specific_process_id	Se establece en "ThreadID: " a partir de execution.thread_id si no está vacío, o de ThreadID si no está vacío
provider.guid, ProviderGuid	target.resource.id	Valor de provider.guid después de quitar {}, o de ProviderGuid después de quitar {}
mensaje	target.resource.product_object_id	Se extrae del mensaje con un patrón de grok
provider.guid	target.resource.type	Se establece en "Hyper-V VmSwitch" si no está vacío.

Registro de cambios

Consulta el registro de cambios de este analizador

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