Recopila registros de VMware vSphere
En este documento, se explica cómo transferir registros de VMware vSphere a Google Security Operations con el agente de Bindplane.
VMware vSphere es una plataforma de virtualización que genera mensajes de syslog para eventos de host de ESXi, operaciones de VM, autenticación y supervisión del estado del sistema.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Windows Server 2016 o posterior, o host de Linux con
systemd - Conectividad de red entre el agente de Bindplane y el host de VMware vSphere ESXi
- Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
- Acceso con privilegios al cliente web de VMware vSphere o a la shell de ESXi
Obtén credenciales de Google SecOps para el agente de Bindplane
Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:
- Implementaciones nuevas: Usa la API de Chronicle (opción 1).
- Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
Opción 1: Crea una cuenta de servicio para la API de Chronicle (recomendado)
- Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
- Ve a IAM y administración > Cuentas de servicio.
- Haga clic en Crear cuenta de servicio.
- Proporciona los siguientes detalles de configuración:
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
bindplane-ingest). - Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo,
Bindplane agent log ingestion).
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
- Haz clic en Crear y continuar.
- En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
- Haz clic en Continuar y, luego, en Listo.
- Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
- Haz clic en Agregar clave > Crear clave nueva.
- Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
- Guarda el archivo de claves como
ingestion-auth.jsonen el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonen Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonen Windows) o actualizacreds_file_pathenconfig.yamlpara que coincida con la ruta de acceso en la que lo guardas. - Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.
Opción 2: Descarga el archivo de autenticación de transferencia (heredado)
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
- Descarga el archivo de autenticación de transferencia.
- Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.
Obtén el ID de cliente de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
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
- Abre el símbolo del sistema o PowerShell como administrador.
Ejecuta el comando siguiente:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sc query observiq-otel-collectorEl servicio debería mostrarse como RUNNING.
Instalación en Linux
- Abre una terminal con privilegios de raíz o sudo.
Ejecuta el comando siguiente:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sudo systemctl status observiq-otel-collectorEl servicio debería mostrarse como active (running).
Recursos de instalación adicionales
Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.
Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps
Ubica el archivo de configuración
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edita el archivo de configuración
Reemplaza todo el contenido de
config.yamlpor la siguiente configuración:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/vmware_vsphere: 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: '<customer_id>' endpoint: chronicle.googleapis.com log_type: VMWARE_VSPHERE raw_log_field: body service: pipelines: logs/vmware_vsphere_to_chronicle: receivers: - udplog exporters: - chronicle/vmware_vsphere
Parámetros de configuración
Reemplaza los marcadores de posición que se indican más abajo:
Configuración del receptor:
listen_address: Es la dirección IP y el puerto que se escucharán:0.0.0.0para escuchar en todas las interfaces (recomendado)- El puerto
514es el puerto estándar de syslog (requiere acceso raíz en Linux; usa1514para acceso no raíz)
Configuración del exportador:
creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Es el ID de cliente copiado de la consola de Google SecOps.location: Reemplaza<LOCATION>por la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1). El exportador agrega el prefijochronicle.googleapis.comcon este valor. Consulta Extremos regionales para obtener la lista completa.project: Reemplaza<PROJECT_NUMBER>por el número de proyecto de IAM y administración > Configuración.endpoint: Mantén la configuración comochronicle.googleapis.com.
Exportador de la API de transferencia heredada
Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque
exporterspor lo siguiente. Establececreds_file_pathen la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplazamalachiteingestion-pa.googleapis.compor tu extremo regional (por ejemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/vmware_vsphere: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: VMWARE_VSPHERE raw_log_field: body
Guarda el archivo de configuración
- Después de editarlo, guarda el archivo:
- Linux: Presiona
Ctrl+O, luegoEntery, por último,Ctrl+X - Windows: Haz clic en Archivo > Guardar.
- Linux: Presiona
Reinicia el agente de Bindplane para aplicar los cambios.
Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:
sudo systemctl restart observiq-otel-collectorVerifica que el servicio esté en ejecución:
sudo systemctl status observiq-otel-collectorRevisa los registros en busca de errores:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:
Símbolo del sistema o PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collectorConsola de servicios:
- Presiona
Win+R, escribeservices.mscy presiona Intro. - Busca observIQ OpenTelemetry Collector.
- Haz clic con el botón derecho y selecciona Reiniciar.
Verifica que el servicio esté en ejecución:
sc query observiq-otel-collectorRevisa los registros en busca de errores:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Presiona
Configura syslog en VMware vSphere
Opción 1: Cliente web de vSphere
- Accede al cliente web de vSphere.
- Selecciona el host de ESXi.
- Ve a Configurar > Sistema > Configuración avanzada del sistema.
- Haz clic en Editar.
- Establece el parámetro
Syslog.global.logHostenudp://<bindplane-ip>:514(reemplaza<bindplane-ip>por la dirección IP de tu agente de Bindplane). - Haz clic en Aceptar.
Opción 2: Shell de ESXi
- Establece una conexión SSH al host de ESXi.
Ejecuta los siguientes comandos:
esxcli system syslog config set --loghost=udp://<bindplane-ip>:514 esxcli system syslog reload- Reemplaza
<bindplane-ip>por la dirección IP de tu agente de Bindplane.
- Reemplaza
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
Originator_label |
additional.fields |
Combinado |
activityType_label |
additional.fields |
Combinado |
certVerificationStatus_label |
additional.fields |
Combinado |
cls_simple_activity_label |
additional.fields |
Combinado |
itemType_label |
additional.fields |
Combinado |
logtype_label |
additional.fields |
Combinado |
opID_label |
additional.fields |
Combinado |
progress_label |
additional.fields |
Combinado |
securityCompliance_label |
additional.fields |
Combinado |
sub_label |
additional.fields |
Combinado |
vpxd_label |
additional.fields |
Combinado |
column9 |
extensions.auth.type |
Asignado: logged out → AUTHTYPE_UNSPECIFIED |
column9 |
metadata.description |
Asignada directamente |
msg |
metadata.description |
Asignada directamente |
response_Message |
metadata.description |
Asignada directamente |
column3 |
metadata.event_timestamp |
Analizado como ISO8601 |
column9 |
metadata.event_type |
Asignado: logged out → USER_LOGOUT |
has_principal |
metadata.event_type |
Asignado: true → NETWOK_CONNECTION, true → STATUS_UPDATE |
column4 |
metadata.product_event_type |
Asignada directamente |
column1 |
metadata.product_log_id |
Asignada directamente |
uuid |
metadata.product_log_id |
Asignada directamente |
user_agent |
network.http.parsed_user_agent |
Se cambió el nombre o se asignó |
user_agent |
network.http.user_agent |
Asignada directamente |
sessionId |
network.session_id |
Asignada directamente |
Hostname |
principal.asset.hostname |
Asignada directamente |
hostname |
principal.asset.hostname |
Asignada directamente |
srcip |
principal.asset.ip |
Combinado |
Hostname |
principal.hostname |
Asignada directamente |
hostname |
principal.hostname |
Asignada directamente |
srcip |
principal.ip |
Combinado |
column5 |
security_result.severity |
Asignado: INFO → INFORMATIONAL |
severity |
security_result.severity_details |
Asignada directamente |
pid |
target.process.pid |
Asignada directamente |
column7 |
target.resource.name |
Asignada directamente |
column6 |
target.user.userid |
Asignada directamente |
| N/A | extensions.auth.type |
Constante: AUTHTYPE_UNSPECIFIED |
| N/A | metadata.event_type |
Constante: NETWOK_CONNECTION |
| N/A | metadata.product_name |
Constante: VMWARE_VSPHERE |
| N/A | metadata.vendor_name |
Constante: VMWARE_VSPHERE |
| N/A | security_result.severity |
Constante: INFORMATIONAL |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
Asignado desde el registro de cambios |
file_path |
event.idm.read_only_udm.target.process.file.full_path |
Asignado desde el registro de cambios |
api_invocations |
event.idm.read_only_udm.security_result.detection_fields |
Asignado desde el registro de cambios |
column2 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
login time |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
syslog_priority |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
user_level |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
session_id |
event.idm.read_only_udm.network.session_id |
Asignado desde el registro de cambios |
uuid |
event.idm.read_only_udm.metadata.product_log_id |
Asignado desde el registro de cambios |
Hostname |
event.idm.read_only_udm.principal.hostname |
Asignado desde el registro de cambios |
Hostname |
event.idm.read_only_udm.principal.asset.hostname |
Asignado desde el registro de cambios |
msg |
event.idm.read_only_udm.metadata.description |
Asignado desde el registro de cambios |
Originator |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
sub |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
opID |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
progress |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
cls_simple_activity |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
certVerificationStatus |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
itemType |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
vpxd |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
securityCompliance |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
logtype |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
severity |
event.idm.read_only_udm.security_result.severity_details |
Asignado desde el registro de cambios |
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.