Recoger registros de ESET AV

Disponible en:

En este documento se explica cómo ingerir registros de antivirus de ESET en Google Security Operations mediante Bindplane. El código del analizador de Logstash extrae datos de eventos de seguridad de los registros de ESET_AV con formato SYSLOG o JSON. Primero, normaliza el mensaje sin procesar y, a continuación, lo analiza en función del formato identificado, asignando los campos extraídos al esquema del modelo de datos unificado (UDM) correspondiente para que la representación y el análisis sean coherentes.

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, los puertos del cortafuegos están abiertos
  • Acceso privilegiado a ESET Protect

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

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
            ingestion_labels:
                log_type: 'ESET_AV'
                raw_log_field: body
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
  3. Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.

  4. Sustituye <customer_id> por el ID de cliente real.

  5. 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 ESET PROTECT on-premise

  1. Inicia sesión en la consola web de ESET Protect.
  2. Ve a Más > Configuración > Ajustes avanzados > Servidor Syslog.
  3. Selecciona el interruptor situado junto a Habilitar Syslog.
  4. Proporcione los siguientes detalles de configuración:
    • Host: introduce la dirección IP del agente de Bindplane.
    • Puerto: introduce el número de puerto del agente de Bindplane (514 para UDP).
    • Formato: selecciona Syslog.
    • Transporte: selecciona UDP.
    • Nivel de detalle del registro de seguimiento: selecciona Informativo.
    • Exportar registros a Syslog: selecciona Habilitar.
    • Formato de los registros exportados: selecciona JSON.
  5. Haz clic en Guardar.

Configurar Syslog para ESET PROTECT Cloud

  1. Inicia sesión en la consola web de ESET Protect.
  2. Ve a Más > Ajustes > Servidor Syslog.
  3. Selecciona el interruptor situado junto a Habilitar Syslog.
  4. Proporcione los siguientes detalles de configuración:
    • Formato de la carga útil: selecciona JSON.
    • Formato del envoltorio: selecciona Syslog.
    • Nivel de registro mínimo: selecciona Informativo.
    • Tipos de eventos que se registrarán: selecciona Todos los tipos de eventos.
    • IP de destino: introduce la dirección IP del agente de Bindplane.
    • Puerto: introduce el número de puerto del agente de Bindplane (514 para UDP).
  5. Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
cuenta principal.administrative_domain Extraído del campo account mediante el patrón grok %{DATA:admin_domain}\\\\%{WORD:user_id}.
cuenta principal.user.userid Extraído del campo account mediante el patrón grok %{DATA:admin_domain}\\\\%{WORD:user_id}.
acción security_result.action Si action es Block (sin distinguir entre mayúsculas y minúsculas), se le asigna el valor BLOCK. Si action es Start (sin distinguir entre mayúsculas y minúsculas), se le asigna el valor ALLOW.
action_taken security_result.action_details Se asigna directamente desde el campo action_taken.
computer_severity_score security_result.detection_fields Se crea un par clave-valor con la clave computer_severity_score y el valor del campo computer_severity_score. Este par se añade a la matriz security_result.detection_fields.
detail security_result.description Se asigna directamente desde el campo detail.
dominio principal.domain.name Se asigna directamente desde el campo domain.
eialarmid security_result.detection_fields Se crea un par clave-valor con la clave eialarmid y el valor del campo eialarmid. Este par se añade a la matriz security_result.detection_fields.
eiconsolelink principal.url Se asigna directamente desde el campo eiconsolelink.
evento metadata.description Se ha cambiado el nombre de event a event_desc y se ha asignado a metadata.description.
event_type metadata.product_event_type Se asigna directamente desde el campo event_type.
group_name principal.group.group_display_name Se asigna directamente desde el campo group_name.
hash principal.file.sha1 Se ha convertido a minúsculas. Si el valor en minúsculas coincide con la expresión regular SHA-1, se asigna a principal.file.sha1.
hash principal.resource.attribute.labels Se crea un par clave-valor con la clave hash y el valor del campo hash. Este par se añade a la matriz principal.resource.attribute.labels.
nombre de host principal.asset.hostname Se asigna directamente desde el campo hostname.
nombre de host principal.hostname Se asigna directamente desde el campo hostname.
entrante network.direction Si es true, asigna el valor INBOUND. Si es false, asigna el valor OUTBOUND.
ipv4 target.asset.ip Se asigna directamente desde el campo ipv4 si target_address está vacío.
ipv4 target.ip Se asigna directamente desde el campo ipv4 si target_address está vacío.
json_data Se analiza como JSON para extraer varios campos.
mensaje Se analiza con grok para extraer la marca de tiempo, el host y json_data.
need_restart additional.fields Se crea un par clave-valor con la clave need_restart y el valor del campo need_restart (convertido en cadena). Este par se añade a la matriz additional.fields.
os_name principal.platform Si contiene Window o window (sin distinguir entre mayúsculas y minúsculas), asigna el valor WINDOWS. Si contiene Linux o linux (sin distinguir entre mayúsculas y minúsculas), asigna el valor LINUX. Si contiene Mac o mac (sin distinguir entre mayúsculas y minúsculas), asigna el valor MAC.
os_name principal.platform_version Se asigna directamente desde el campo os_name.
process_name principal.process.file.full_path Se asigna directamente desde el campo process_name. Si está vacío, toma el valor de processname.
processname principal.process.file.full_path Si process_name está vacío, se asigna a process_name.
protocolo network.ip_protocol Se ha convertido a mayúsculas. Si el valor en mayúsculas coincide con protocolos conocidos (TCP, UDP, ICMP, etc.), se asigna a network.ip_protocol.
result security_result.summary Se asigna directamente desde el campo result.
rulename security_result.rule_name Se asigna directamente desde el campo rulename.
scan_id security_result.detection_fields Se crea un par clave-valor con la clave scan_id y el valor del campo scan_id. Este par se añade a la matriz security_result.detection_fields.
scanner_id security_result.detection_fields Se crea un par clave-valor con la clave scanner_id y el valor del campo scanner_id. Este par se añade a la matriz security_result.detection_fields.
gravedad security_result.severity Si contiene Warn o warn (sin distinguir entre mayúsculas y minúsculas), asigna el valor HIGH. Si contiene Info o info (sin distinguir entre mayúsculas y minúsculas), asigna el valor LOW.
severity_score security_result.detection_fields Se crea un par clave-valor con la clave severity_score y el valor del campo severity_score. Este par se añade a la matriz security_result.detection_fields.
source_address principal.asset.ip Se asigna directamente desde el campo source_address.
source_address principal.ip Se asigna directamente desde el campo source_address.
source_port principal.port Se ha convertido en una cadena y, después, en un número entero. Asignado a principal.port.
source_uuid metadata.product_log_id Se asigna directamente desde el campo source_uuid.
target Se ha cambiado el nombre a target1.
target_address target.asset.ip Se asigna directamente desde el campo target_address.
target_address target.ip Se asigna directamente desde el campo target_address.
target_port target.port Se ha convertido en una cadena y, después, en un número entero. Asignado a target.port.
threat_handled security_result.detection_fields Se crea un par clave-valor con la clave threat_handled y el valor del campo threat_handled (convertido en cadena). Este par se añade a la matriz security_result.detection_fields.
threat_name security_result.threat_name Se asigna directamente desde el campo threat_name.
threat_type security_result.threat_id Se asigna directamente desde el campo threat_type.
Tiempo metadata.event_timestamp Se usa para rellenar metadata.event_timestamp.
nombre de usuario principal.user.userid Se asigna directamente desde el campo username si user_id y user están vacíos.
usuario principal.user.userid Se asigna directamente desde el campo user si user_id está vacío.
metadata.event_type Si source_address y target_address no están vacíos, asigna el valor NETWORK_CONNECTION. Si has_user es true, se asigna el valor USER_UNCATEGORIZED. Si has_principal es true, se asigna el valor STATUS_UPDATE. De lo contrario, asigna el valor GENERIC_EVENT.
metadata.log_type Su valor debe ser ESET_AV.
metadata.product_name Su valor debe ser ESET_AV.
metadata.vendor_name Su valor debe ser ESET_AV.
intermediary.hostname El valor de este campo se toma del campo host extraído del mensaje de registro.
principal.user.userid Si el campo account no está vacío, el analizador extrae el ID de usuario del campo account mediante un patrón grok. De lo contrario, comprueba si el campo user no está vacío y, si es así, toma su valor. Si tanto account como user están vacíos, comprueba si el campo username no está vacío. Si no lo está, toma su valor.

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