Recopila registros de Veridium ID

Compatible con:

En este documento, se explica cómo transferir registros de Veridium ID a las Operaciones de seguridad de Google con Bindplane. Primero, el analizador extrae los campos de los mensajes de Syslog y los categoriza según el "log_identifier". Luego, 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), controlando los formatos ActionLog y EventLog.

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

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

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

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Profile.
  3. 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

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

  1. Abre una terminal con privilegios de raíz 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 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

  1. 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).
  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 de Servicios o ingresar el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura Syslog para Veridium ID

  1. Accede al host de Veridium ID con SSH o la CLI.
  2. Edita el archivo /etc/rsyslog.conf o /etc/rsyslog.d/events.conf con VI.

    vi /etc/rsyslog.conf
    
  3. Ingresa los siguientes detalles y reemplaza <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 Se asignó 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 Se asignó 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 Se asignó 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 establece en "USER_UNCATEGORIZED".
metadata.product_event_type metadata.product_event_type Se asigna directamente desde el campo actionName.
metadata.product_name metadata.product_name Se establece en "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 Se asignó 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? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.