Se usó la API de Cloud Translation para traducir esta página.

Recopila registros de VMware Tanzu

Compatible con:

Google SecOps SIEM

En este documento, se explica cómo transferir registros de VMware Tanzu a Google Security Operations con Bindplane. El analizador extrae los registros de auditoría de los mensajes con formato JSON o SYSLOG+JSON. Analiza los datos de registro, normaliza los campos en el formato del UDM y enriquece el evento con metadatos, como detalles del usuario, información de recursos, actividad de red y resultados de seguridad, y controla tanto los objetos JSON únicos como los objetos JSON incorporados en los mensajes de syslog.

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 con privilegios a VMware Tanzu

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

Accede a la consola de Google SecOps.
Ve a SIEM Settings > Collection Agents.
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

Accede a la consola de Google SecOps.
Ve a SIEM Settings > Profile.
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 siguiente comando:

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

Instalación en Linux

Abre una terminal con privilegios de raíz o sudo.

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

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).

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_TANZU'
        raw_log_field: body
        ingestion_labels:

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels

Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.
Reemplaza <customer_id> por el ID de cliente real.
Actualiza /path/to/ingestion-authentication-file.json a la ruta de acceso en la que se guardó el archivo de autenticación en la sección Cómo obtener el archivo de autenticación de la transferencia de Google SecOps.

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 VMware Tanzu

Accede a la IU web de Tanzu Operations Manager.
Selecciona tu Nombre de usuario y, luego, haz clic en Configuración.
Selecciona Syslog.
Haz clic en Sí para enviar registros del sistema a un servidor remoto.
Proporciona los siguientes detalles de configuración:
- Dirección: Ingresa la dirección IP del agente de BindPlane.
- Puerto: Ingresa el número de puerto del agente de Bindplane.
- Transport Protocol: Selecciona UDP o TCP, según la configuración real del agente de Bindplane.
Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
`annotations.authorization.k8s.io/decision`	`security_result.action`	Si existe la anotación `authorization.k8s.io/decision`, su valor se convierte a mayúsculas. Si el valor en mayúsculas es "ALLOW", el campo de UDM se establece en ALLOW. De lo contrario, se establece como BLOCK.
`annotations.authorization.k8s.io/reason`	`security_result.description`	Si existe la anotación `authorization.k8s.io/reason`, se usa su valor (sin comillas dobles).
`apiVersion`	`metadata.product_version`	Se asigna directamente.
`auditID`	`metadata.product_log_id`	Se asigna directamente.
`kind`	`metadata.product_event_type`	Se asigna directamente.
`objectRef.name`	`target.resource.name`	Se asigna directamente.
`objectRef.namespace`	`target.resource.attribute.labels.key`, `target.resource.attribute.labels.value`	El `key` se establece en "namespace", y el `value` se toma de `objectRef.namespace`.
`objectRef.resource`	`target.resource.resource_subtype`	Se asigna directamente.
`objectRef.resourceVersion`	`target.resource.attribute.labels.key`, `target.resource.attribute.labels.value`	El `key` se establece en "resourceVersion", y el `value` se toma de `objectRef.resourceVersion`.
`objectRef.uid`	`target.resource.product_object_id`	Se asigna directamente.
`requestReceivedTimestamp`/`timestamp`	`metadata.event_timestamp`	El analizador intenta analizar `requestReceivedTimestamp` primero. Si no está presente, se usa el campo `timestamp` extraído del prefijo de syslog.
`requestURI`	`target.url`	Se asigna directamente.
`responseStatus.code`	`network.http.response_code`	Se asigna directamente después de convertirse en un número entero.
`sourceIPs`	`principal.ip`	Todas las direcciones IP del array `sourceIPs` se agregan al array `principal.ip`.
`stage`	`metadata.description`	Se asigna directamente.
`stageTimestamp`	`metadata.collected_timestamp`	Se asigna directamente.
`user.groups`	`principal.user.group_identifiers`	Todos los grupos del array `user.groups` se agregan al array `principal.user.group_identifiers`.
`user.uid`	`principal.user.userid`	Se asigna directamente.
`user.username`	`principal.user.user_display_name`	Se asigna directamente.
`verb`	`network.http.method`	Se asigna directamente después de convertirse a mayúsculas. Se determina según el campo `verb`. Si `verb` es "CREATE", el tipo de evento es `USER_RESOURCE_CREATION`. Si `verb` es "PATCH" o "UPDATE", el tipo de evento es `USER_RESOURCE_UPDATE_CONTENT`. Si `verb` es "DELETE", el tipo de evento es `USER_RESOURCE_DELETION`. De lo contrario, si `verb` no está vacío, el tipo de evento es `USER_RESOURCE_ACCESS`. Si no se cumple ninguna de estas condiciones, el tipo de evento se establece en `GENERIC_EVENT`. Se codifica como "VMWARE_TANZU". Se codifica como "VMWARE". Se codifica como "VMWARE_TANZU". Se codifica de forma rígida como "CLUSTER".

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