Recopila registros de ESET AV

Compatible con:

En este documento, se explica cómo transferir registros de antivirus de ESET a Google Security Operations con 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, luego, lo analiza en función del formato identificado, asignando los campos extraídos al esquema del modelo de datos unificado (UDM) correspondiente para una representación y un análisis coherentes.

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 se ejecuta detrás de un proxy, los puertos del firewall están abiertos.
  • Acceso con privilegios a ESET Protect

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

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Agentes de recopilación.
  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 Configuración de SIEM > Perfil.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de Bindplane

Instalación de 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 de 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
            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. Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.

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

  5. 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 Obtén el archivo de autenticación de 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 Services o ingresar el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura Syslog para ESET PROTECT local

  1. Accede a la consola web de ESET Protect.
  2. Ve a Más > Configuración > Configuración avanzada > Servidor de Syslog.
  3. Selecciona el botón de activación junto a Habilitar Syslog.
  4. Proporciona los siguientes detalles de configuración:
    • Host: Ingresa la dirección IP del agente de Bindplane.
    • Puerto: Ingresa el número de puerto del agente de Bindplane (514 para UDP).
    • Formato: Selecciona Syslog.
    • Transporte: Selecciona UDP.
    • Verbosidad del registro de seguimiento: Selecciona Informativo.
    • Interruptor para exportar registros a Syslog: Selecciona Habilitar.
    • Formato de los registros exportados: Selecciona JSON.
  5. Haz clic en Guardar.

Configura Syslog para ESET PROTECT Cloud

  1. Accede a la consola web de ESET Protect.
  2. Ve a Más > Configuración > Servidor de Syslog.
  3. Selecciona el botón de activación junto a Habilitar Syslog.
  4. Proporciona los siguientes detalles de configuración:
    • Formato de la carga útil: Selecciona JSON.
    • Formato del sobre: 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: Ingresa la dirección IP del agente de Bindplane.
    • Puerto: Ingresa el número de puerto del agente de Bindplane (514 para UDP).
  5. Haz clic en Guardar.

Tabla de asignación de la UDM

Campo de registro Asignación de UDM Lógica
cuenta principal.administrative_domain Se extrae del campo account con el patrón grok %{DATA:admin_domain}\\\\%{WORD:user_id}.
cuenta principal.user.userid Se extrae del campo account con el patrón grok %{DATA:admin_domain}\\\\%{WORD:user_id}.
acción security_result.action Si action es Block (sin distinción entre mayúsculas y minúsculas), configúralo como BLOCK. Si action es Start (sin distinción entre mayúsculas y minúsculas), configúralo como 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 agrega al array security_result.detection_fields.
detalle 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 agrega al array security_result.detection_fields.
eiconsolelink principal.url Se asigna directamente desde el campo eiconsolelink.
evento metadata.description Se cambió el nombre de event por event_desc y se asignó 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 convirtió en minúsculas. Si el valor en minúsculas coincide con la regex 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 agrega al array 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 verdadero, configúralo como INBOUND. Si es falso, configúralo como 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 los datos JSON.
need_restart additional.fields Se crea un par clave-valor con la clave need_restart y el valor del campo need_restart (convertido a cadena). Este par se agrega al array additional.fields.
os_name principal.platform Si contiene Window o window (sin distinción entre mayúsculas y minúsculas), configúralo como WINDOWS. Si contiene Linux o linux (sin distinción entre mayúsculas y minúsculas), configúralo como LINUX. Si contiene Mac o mac (sin distinción entre mayúsculas y minúsculas), configúralo como 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.
protocol network.ip_protocol Se convirtió en mayúsculas. Si el valor en mayúsculas coincide con protocolos conocidos (TCP, UDP, ICMP, etc.), se asigna a network.ip_protocol.
Resultado 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 agrega al array 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 agrega al array security_result.detection_fields.
gravedad, security_result.severity Si contiene Warn o warn (sin distinción entre mayúsculas y minúsculas), configúralo como HIGH. Si contiene Info o info (sin distinción entre mayúsculas y minúsculas), configúralo como 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 agrega al array 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 convierte en una cadena y, luego, en un número entero. Se asignó a principal.port.
source_uuid metadata.product_log_id Se asigna directamente desde el campo source_uuid.
objetivo Se cambió 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 convierte en una cadena y, luego, en un número entero. Se asignó 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 a cadena). Este par se agrega al array 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.
hora metadata.event_timestamp Se usa para propagar 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, configúralos como NETWORK_CONNECTION. De lo contrario, si has_user es verdadero, configúralo como USER_UNCATEGORIZED. De lo contrario, si has_principal es verdadero, configúralo como STATUS_UPDATE. De lo contrario, configúralo como GENERIC_EVENT.
metadata.log_type Se define en ESET_AV.
metadata.product_name Se define en ESET_AV.
metadata.vendor_name Se define en 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 con un patrón grok. De lo contrario, comprueba si el campo user no está vacío y, de ser así, toma su valor. Si account y user están vacíos, comprueba si el campo username no está vacío y, de ser así, toma su valor.

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