Recoger registros de ESET AV
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
- 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_AV' 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 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
- 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 |
---|---|---|
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.