Recoger registros de ESET EDR

Disponible en:

En este documento se explica cómo ingerir registros de ESET en Google Security Operations mediante Bindplane. El código del analizador de Logstash primero intenta extraer campos de los registros de ESET EDR en formato SYSLOG o JSON mediante una serie de patrones grok. En función de los campos extraídos y su formato, procesa los datos mediante filtros de clave-valor (kv) o análisis JSON para estructurar la información en una representación del modelo de datos unificado (UDM).

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_EDR'
                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 donde 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
acción event1.idm.read_only_udm.security_result.action Se define condicionalmente como BLOCK si el valor es Blocked.
actionTaken event2.idm.read_only_udm.metadata.event_type Se define condicionalmente como SCAN_PROCESS si el valor es Cleaned by deleting.
actionTaken event1.idm.read_only_udm.security_result.action_details Se asigna directamente desde el campo actionTaken.
actionTaken event2.idm.read_only_udm.security_result.action_details Se asigna directamente desde el campo actionTaken.
accountName event2.idm.read_only_udm.additional.fields.value.string_value Se asigna directamente desde el campo accountName. La tecla está configurada como accountName.
aplicación event3.idm.read_only_udm.principal.application Se asigna directamente desde el campo app.
circunstancias event2.idm.read_only_udm.additional.fields.value.string_value Se asigna directamente desde el campo circumstances. La tecla está configurada como circumstances.
Computer_name event3.idm.read_only_udm.principal.hostname Se asigna directamente desde el campo Computer_name.
Computer_name event3.idm.read_only_udm.principal.asset.hostname Se asigna directamente desde el campo Computer_name.
date_time
Detection_name event3.idm.read_only_udm.security_result.threat_name Se asigna directamente desde el campo Detection_name.
Detectiontype event3.idm.read_only_udm.security_result.category_details Se asigna directamente desde el campo Detectiontype.
dst event2.idm.read_only_udm.target.ip Se asigna directamente desde el campo dst.
dst event2.idm.read_only_udm.target.asset.ip Se asigna directamente desde el campo dst.
dstPort event2.idm.read_only_udm.target.port Se asigna directamente desde el campo dstPort después de convertirlo en un número entero.
evento event1.idm.read_only_udm.metadata.description Se asigna directamente desde el campo event.
event_type event1.idm.read_only_udm.metadata.product_event_type Se asigna directamente desde el campo event_type.
event_type event1.idm.read_only_udm.metadata.event_type Se define condicionalmente como NETWORK_CONNECTION si el valor es FirewallAggregated_Event.
hash event1.idm.read_only_udm.target.file.sha1 Se asigna directamente desde el campo hash después de convertirlo a minúsculas.
nombre de host event1.idm.read_only_udm.target.hostname Se asigna directamente desde el campo hostname.
nombre de host event1.idm.read_only_udm.target.asset.hostname Se asigna directamente desde el campo hostname.
nombre de host event.alert.devices.hostname Se asigna directamente desde el campo hostname.
ipv4 event1.idm.read_only_udm.principal.ip Se asigna directamente desde el campo ipv4. Este campo se almacena primero en un campo temporal udm_ip.
ipv4 event1.idm.read_only_udm.principal.asset.ip Se asigna directamente desde el campo ipv4. Este campo se almacena primero en un campo temporal udm_ip.
ipv4 event.alert.devices.ip_addresses Se asigna directamente desde el campo ipv4 después de convertirlo en una dirección IP.
Logged_user event3.idm.read_only_udm.principal.user.userid Se asigna directamente desde el campo Logged_user.
objectUri event1.idm.read_only_udm.target.file.full_path Se asigna directamente desde el campo objectUri.
objectUri event2.idm.read_only_udm.target.file.full_path Se asigna directamente desde el campo objectUri.
processName event2.idm.read_only_udm.target.process.file.full_path Se asigna directamente desde el campo processName.
processName event1.idm.read_only_udm.principal.process.file.full_path Se asigna directamente desde el campo processName.
process_id event3.idm.read_only_udm.principal.process.pid Se asigna directamente desde el campo process_id.
process_id event2.idm.read_only_udm.target.process.pid Se asigna directamente desde el campo process_id.
protocolo event1.idm.read_only_udm.network.ip_protocol Se asigna directamente desde el campo protocol.
proto event2.idm.read_only_udm.network.ip_protocol Se asigna directamente desde el campo proto.
result event2.idm.read_only_udm.security_result.action Se define condicionalmente como ALLOW si el valor es Success.
Test event3.idm.read_only_udm.security_result.description Se asigna directamente desde el campo Scanner.
gravedad event1.idm.read_only_udm.security_result.severity Se asigna desde el campo severity en función de estas condiciones: - INFO, Informational, DEBUG, info: INFORMATIONAL - ERROR, error: ERROR - WARNING, Warning: LOW
source_address event1.idm.read_only_udm.principal.ip Se asigna directamente desde el campo source_address.
source_address event1.idm.read_only_udm.principal.asset.ip Se asigna directamente desde el campo source_address.
source_port event1.idm.read_only_udm.principal.port Se asigna directamente desde el campo source_port después de convertirlo en un número entero.
source_uuid event1.idm.read_only_udm.metadata.product_log_id Se asigna directamente desde el campo source_uuid.
src event2.idm.read_only_udm.principal.ip Se asigna directamente desde el campo src.
src event2.idm.read_only_udm.principal.asset.ip Se asigna directamente desde el campo src.
srcPort event2.idm.read_only_udm.principal.port Se asigna directamente desde el campo srcPort después de convertirlo en un número entero.
target_address event1.idm.read_only_udm.target.ip Se asigna directamente desde el campo target_address.
target_address event1.idm.read_only_udm.target.asset.ip Se asigna directamente desde el campo target_address.
target_port event1.idm.read_only_udm.target.port Se asigna directamente desde el campo target_port después de convertirlo en un número entero.
threatName event2.idm.read_only_udm.security_result.threat_name Se asigna directamente desde el campo threatName.
threatName event.alert.alert_short_name Se asigna directamente desde el campo threatName.
Time_of_occurrence event3.idm.read_only_udm.additional.fields.value.string_value Se asigna directamente desde el campo Time_of_occurrence. La tecla está configurada como Time_of_occurrence.
tipo event2.idm.read_only_udm.security_result.category_details Se asigna directamente desde el campo type.
tipo event2.idm.read_only_udm.metadata.event_type Se asigna condicionalmente a GENERIC_EVENT si no se cumple ningún otro tipo de evento específico.
user_id event2.idm.read_only_udm.principal.user.userid Se asigna directamente desde el campo user_id.
event1.idm.read_only_udm.metadata.event_type Se define condicionalmente como FILE_UNCATEGORIZED si el valor de event_type es Threat_Event.
event1.idm.read_only_udm.metadata.log_type Su valor debe ser ESET_EDR.
event1.idm.read_only_udm.metadata.product_name Se define condicionalmente como ESET si el valor de event_type es FirewallAggregated_Event.
event2.idm.read_only_udm.metadata.log_type Su valor debe ser ESET_EDR.
event2.idm.read_only_udm.metadata.product_name Su valor debe ser EDR.
event2.idm.read_only_udm.metadata.vendor_name Su valor debe ser ESET.
event3.idm.read_only_udm.metadata.event_type Se define de forma condicional según estas reglas: - USER_UNCATEGORIZED si principal_user_present es true. - STATUS_UPDATE si principal_machine_id_present es true. - GENERIC_EVENT en cualquier otro caso.
event3.idm.read_only_udm.metadata.log_type Su valor debe ser ESET_EDR.
event3.idm.read_only_udm.metadata.product_name Su valor debe ser EDR.
event3.idm.read_only_udm.metadata.vendor_name Su valor debe ser ESET.
event.alert.is_significant Se establece en true y, a continuación, se convierte en un valor booleano.
event3.idm.read_only_udm.security_result.description Se asigna condicionalmente al valor de kv_data si Scanner está vacío.

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