Recoger registros de Veridium ID

Disponible en:

En este documento se explica cómo ingerir registros de Veridium ID en Google Security Operations mediante Bindplane. El analizador primero extrae los campos de los mensajes syslog y los clasifica en función del "log_identifier". A continuación, usa la lógica condicional y el análisis de clave-valor para asignar los campos extraídos a una estructura de modelo de datos unificado (UDM), que admite los formatos ActionLog y EventLog.

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 Veridium ID

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

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

  1. Inicia sesión en 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.

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

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

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

  1. 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).
  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: 'VERIDIUM_ID'
            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 Servicios o introducir el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configurar Syslog para Veridium ID

  1. Inicia sesión en el host de Veridium ID mediante SSH o CLI.
  2. Edita el archivo /etc/rsyslog.conf o /etc/rsyslog.d/events.conf con VI.

    vi /etc/rsyslog.conf
    
  3. Introduce los siguientes detalles y sustituye <bindplane-ip> y <bindplane-port> por los detalles reales del agente de Bindplane.

    module(load="imfile" PollingInterval="10")
    input(type="imfile" File="/var/log/veridiumid/websecadmin/events.log" Tag="ver-adminevents" reopenOnTruncate="on")
    input(type="imfile" File="/var/log/veridiumid/tomcat/events.log" Tag="ver-events" reopenOnTruncate="on")
    
    if $programname == 'ver-events' then @@<bindplane-ip>:<bindplane-port>
    if $programname == 'ver-adminevents' then @@<bindplane-ip>:<bindplane-port>
    
  4. Guarda el archivo y sal de VI.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
_caller.accountId principal.user.userid Se asigna directamente desde el campo _caller.accountId.
_caller.accountEmailAddressInfo principal.user.email_addresses Se asigna directamente desde el campo _caller.accountEmailAddressInfo.
_caller.accountExternalId principal.user.email_addresses Se asigna directamente desde el campo _caller.accountExternalId.
_caller.accountStatus principal.user.attribute.labels[account_status].value Se asigna directamente desde el campo _caller.accountStatus.
_caller.deviceId principal.asset.asset_id Tiene el prefijo "VERIDIUM_ID:" y se asigna desde el campo _caller.deviceId.
_caller.deviceDescription principal.asset.attribute.labels[device_description].value Se asigna directamente desde el campo _caller.deviceDescription.
_caller.deviceManufacturer principal.asset.attribute.labels[device_manufacturer].value Se asigna directamente desde el campo _caller.deviceManufacturer.
_caller.deviceName principal.asset.attribute.labels[device_name].value Se asigna directamente desde el campo _caller.deviceName.
_caller.deviceOs principal.asset.platform_software.platform Asignado desde el campo _caller.deviceOs. Si el valor es "iOS", se asigna a "IOS". Si el valor es "Android", se asigna a "ANDROID". Si el valor es "WIN" o "Windows", se asigna a "WINDOWS".
_caller.deviceStatus principal.asset.attribute.labels[device_status].value Se asigna directamente desde el campo _caller.deviceStatus.
_caller.deviceType principal.asset.attribute.labels[device_type].value Se asigna directamente desde el campo _caller.deviceType.
actionDate additional.fields[action_date].value.string_value Se asigna directamente desde el campo actionDate.
actionName metadata.product_event_type Se asigna directamente desde el campo actionName.
accountEmail principal.user.email_addresses Se asigna directamente desde el campo accountEmail.
accountExternalId principal.user.email_addresses Se asigna directamente desde el campo accountExternalId.
accountId principal.user.userid Se asigna directamente desde el campo accountId.
authenticatorDeviceContext.deviceMake intermediary.asset.hardware.manufacturer Se asigna directamente desde el campo authenticatorDeviceContext.deviceMake.
authenticatorDeviceContext.ip intermediary.ip Se asigna directamente desde el campo authenticatorDeviceContext.ip.
authenticatorDeviceContext.location.city intermediary.asset.location.city Se asigna directamente desde el campo authenticatorDeviceContext.location.coordinates.latitude.
authenticatorDeviceContext.location.coordinates.latitude intermediary.asset.location.region_latitude Se asigna directamente desde el campo authenticatorDeviceContext.location.coordinates.latitude.
authenticatorDeviceContext.location.coordinates.longitude intermediary.asset.location.region_longitude Se asigna directamente desde el campo authenticatorDeviceContext.location.coordinates.longitude.
authenticatorDeviceContext.location.countryName intermediary.asset.location.country_or_region Se asigna directamente desde el campo authenticatorDeviceContext.location.countryName.
authenticatorDeviceContext.location.ip intermediary.ip Se asigna directamente desde el campo authenticatorDeviceContext.location.ip.
authenticationDeviceDescription intermediary.asset.attribute.labels[authentication_device_description].value Se asigna directamente desde el campo authenticationDeviceDescription.
authenticationDeviceName intermediary.asset.asset_id Tiene el prefijo "VERIDIUM_ID:" y se asigna desde el campo authenticationDeviceName.
authenticationDeviceOs intermediary.asset.platform_software.platform Asignado desde el campo authenticationDeviceOs. Si el valor es "iOS", se asigna a "IOS". Si el valor es "Android", se asigna a "ANDROID". Si el valor es "WIN" o "Windows", se asigna a "WINDOWS".
authenticationDeviceOsVersion intermediary.asset.platform_software.platform_version Se asigna directamente desde el campo authenticationDeviceOsVersion.
authenticationDevicePhone intermediary.asset.attribute.labels[authentication_device_phone].value Se asigna directamente desde el campo authenticationDevicePhone.
authenticationDevicePhoneModel intermediary.asset.attribute.labels[authentication_device_phone_model].value Se asigna directamente desde el campo authenticationDevicePhoneModel.
authenticationDeviceRegistrationTime intermediary.asset.attribute.labels[authentication_device_registeration_time].value Se asigna directamente desde el campo authenticationDeviceRegistrationTime.
authenticationDeviceType intermediary.asset.attribute.labels[authentication_device_type].value Se asigna directamente desde el campo authenticationDeviceType.
authenticationResult extensions.auth.auth_details Se asigna directamente desde el campo authenticationResult.
context.deviceMake principal.asset.hardware.manufacturer Se asigna directamente desde el campo context.deviceMake.
context.ip principal.ip Se asigna directamente desde el campo context.ip.
context.location.countryName principal.location.country_or_region Se asigna directamente desde el campo context.location.countryName.
context.location.ip principal.ip Se asigna directamente desde el campo context.location.ip.
context.osVersion principal.asset.platform_software.platform_version Se asigna directamente desde el campo context.osVersion.
context.userAgentRaw network.http.user_agent Se asigna directamente desde el campo context.userAgentRaw.
exploiterDeviceContext.deviceMake src.asset.hardware.manufacturer Se asigna directamente desde el campo exploiterDeviceContext.deviceMake.
exploiterDeviceContext.ip src.ip Se asigna directamente desde el campo exploiterDeviceContext.ip.
exploiterDeviceContext.location.city src.asset.location.city Se asigna directamente desde el campo exploiterDeviceContext.location.city.
exploiterDeviceContext.location.coordinates.latitude src.asset.location.region_latitude Se asigna directamente desde el campo exploiterDeviceContext.location.coordinates.latitude.
exploiterDeviceContext.location.coordinates.longitude src.asset.location.region_longitude Se asigna directamente desde el campo exploiterDeviceContext.location.coordinates.longitude.
exploiterDeviceContext.location.countryName src.asset.location.country_or_region Se asigna directamente desde el campo exploiterDeviceContext.location.countryName.
exploiterDeviceContext.location.ip src.ip Se asigna directamente desde el campo exploiterDeviceContext.location.ip.
exploiterDeviceContext.osName src.asset.platform_software.platform Asignado desde el campo exploiterDeviceContext.osName. Si el valor es "WIN" o "Windows", se asigna a "WINDOWS". Si el valor es "iOS", se asigna a "IOS". Si el valor es "Android", se asigna a "ANDROID".
exploiterDeviceContext.osVersion src.asset.platform_software.platform_version Se asigna directamente desde el campo exploiterDeviceContext.osVersion.
exploiterDeviceName src.asset.attribute.labels[exploiter_device_name].value Se asigna directamente desde el campo exploiterDeviceName.
hostname principal.hostname Se asigna directamente desde el campo hostname.
ipAddress principal.ip Se asigna directamente desde el campo ipAddress.
location principal.location.city Se asigna directamente desde el campo location.
location.city about.location.city Se asigna directamente desde el campo location.city.
location.coordinates.latitude about.location.region_latitude Se asigna directamente desde el campo location.coordinates.latitude.
location.coordinates.longitude about.location.region_longitude Se asigna directamente desde el campo location.coordinates.longitude.
location.countryName about.location.country_or_region Se asigna directamente desde el campo location.countryName.
location.ip about.ip Se asigna directamente desde el campo location.ip.
metadata.collected_timestamp metadata.collected_timestamp Se asigna directamente desde el campo collected_time.
metadata.event_timestamp metadata.event_timestamp Se asigna directamente desde el campo event_time.
metadata.event_type metadata.event_type Se ha asignado el valor "USER_UNCATEGORIZED".
metadata.product_event_type metadata.product_event_type Se asigna directamente desde el campo actionName.
metadata.product_name metadata.product_name Se le asigna el valor "VERIDIUM_ID".
namespace principal.namespace Se asigna directamente desde el campo namespace.
pid principal.process.pid Se asigna directamente desde el campo pid.
request.context.userAgentRaw network.http.user_agent Se asigna directamente desde el campo request.context.userAgentRaw.
request.sessionId network.session_id Se asigna directamente desde el campo request.sessionId.
requestMethod network.http.method Se asigna directamente desde el campo requestMethod.
requestURI network.http.referral_url Se asigna directamente desde el campo requestURI.
security_result.severity security_result.severity Asignado desde el campo severity. Si el valor es "INFO", se asigna a "INFORMATIONAL".
principal.application Se asigna directamente desde el campo application.
principal.asset.hostname Se asigna directamente desde el campo hostname.

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