Esta página se ha traducido con Cloud Translation API.

Recoger registros de VMware Tanzu

Disponible en:

SecOps de Google SIEM

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

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

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

Inicia sesión en la consola de Google SecOps.
Ve a Configuración de SIEM > Agentes de recogida.
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

Inicia sesión en la consola de Google SecOps.
Ve a Configuración de SIEM > Perfil.
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

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

Abre un terminal con privilegios de superusuario 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 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

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

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

Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.
Sustituye <customer_id> por el ID de cliente real.
Actualiza /path/to/ingestion-authentication-file.json a la ruta en la que se guardó el archivo de autenticación en la sección Obtener el archivo de autenticación de ingestión 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 Servicios o introducir el siguiente comando:
```
net stop BindPlaneAgent && net start BindPlaneAgent
```

Configurar Syslog para VMware Tanzu

Inicia sesión en la interfaz web de Tanzu Operations Manager.
Selecciona tu Nombre de usuario y, a continuación, haz clic en Configuración.
Selecciona Syslog.
Haz clic en Sí para enviar los registros del sistema a un servidor remoto.
Proporcione los siguientes detalles de configuración:
- Dirección: introduce la dirección IP del agente de Bindplane.
- Puerto: introduce el número de puerto del agente de Bindplane.
- Protocolo de transporte: selecciona UDP o TCP, según la configuración 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 UDM se define como ALLOW. De lo contrario, se asigna el valor BLOCK.
`annotations.authorization.k8s.io/reason`	`security_result.description`	Si existe la anotación `authorization.k8s.io/reason`, se usa su valor (sin las comillas dobles).
`apiVersion`	`metadata.product_version`	Asignación directa.
`auditID`	`metadata.product_log_id`	Asignación directa.
`kind`	`metadata.product_event_type`	Asignación directa.
`objectRef.name`	`target.resource.name`	Asignación directa.
`objectRef.namespace`	`target.resource.attribute.labels.key`, `target.resource.attribute.labels.value`	El `key` se define como "namespace" y el `value` se toma de `objectRef.namespace`.
`objectRef.resource`	`target.resource.resource_subtype`	Asignación directa.
`objectRef.resourceVersion`	`target.resource.attribute.labels.key`, `target.resource.attribute.labels.value`	El `key` se define como "resourceVersion" y el `value` se toma de `objectRef.resourceVersion`.
`objectRef.uid`	`target.resource.product_object_id`	Asignación directa.
`requestReceivedTimestamp`/`timestamp`	`metadata.event_timestamp`	El analizador intenta analizar `requestReceivedTimestamp` primero. Si no está presente, se usa el campo `timestamp` extraído del prefijo syslog.
`requestURI`	`target.url`	Asignación directa.
`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 de la matriz `sourceIPs` se añaden a la matriz `principal.ip`.
`stage`	`metadata.description`	Asignación directa.
`stageTimestamp`	`metadata.collected_timestamp`	Asignación directa.
`user.groups`	`principal.user.group_identifiers`	Todos los grupos de la matriz `user.groups` se añaden a la matriz `principal.user.group_identifiers`.
`user.uid`	`principal.user.userid`	Asignación directa.
`user.username`	`principal.user.user_display_name`	Asignación directa.
`verb`	`network.http.method`	Se asigna directamente después de convertirse a mayúsculas. Determinado por 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 define como `GENERIC_EVENT`. Codificado como "VMWARE_TANZU". Codificado como "VMWARE". Codificado como "VMWARE_TANZU". Codificado como "CLUSTER".

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