Recoger registros de ESET EDR
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
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Agentes de recogida.
- 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
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Perfil.
- 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
- Abre el símbolo del sistema o PowerShell como administrador.
Ejecuta el siguiente comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Instalación de Linux
- Abre un terminal con privilegios de superusuario o sudo.
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
- 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).
- Busca el archivo
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
Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.
Sustituye
<customer_id>
por el ID de cliente real.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
- Inicia sesión en la consola web de ESET Protect.
- Ve a Más > Configuración > Ajustes avanzados > Servidor Syslog.
- Selecciona el interruptor situado junto a Habilitar Syslog.
- 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.
- Haz clic en Guardar.
Configurar Syslog para ESET PROTECT Cloud
- Inicia sesión en la consola web de ESET Protect.
- Ve a Más > Ajustes > Servidor Syslog.
- Selecciona el interruptor situado junto a Habilitar Syslog.
- 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).
- 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.