Recopila registros de ExtraHop RevealX
En este documento, se explica cómo transferir registros de ExtraHop RevealX a las Operaciones de seguridad de Google con Bindplane. El analizador extrae campos de los registros con formato JSON y Syslog. Utiliza patrones de Grok y lógica condicional para controlar diferentes formatos de registro, asigna los campos extraídos al UDM y enriquece los datos con información relacionada con la seguridad, como la gravedad y las categorías. El analizador también controla tipos de eventos específicos de ExtraHop, como la revinculación de DNS, los errores de autenticación de Kerberos y las conexiones RDP, y aplica una lógica de análisis especializada para cada uno.
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 ejecutas la herramienta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos.
- Acceso con privilegios a ExtraHop Reveal X
Obtén el archivo de autenticación de transferencia de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a SIEM Settings > Collection Agents.
- 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
- Accede a la consola de Google SecOps.
- Ve a SIEM Settings > Profile.
- Copia y guarda el ID de cliente de la sección Detalles de la organización.
Instala el agente de BindPlane
Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.
Instalación en Windows
- 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 en Linux
- Abre una terminal con privilegios de raíz 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 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
- 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).
- Ubica 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 log_type: 'EXTRAHOP' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
- Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.
- Reemplaza
<customer_id>
por el ID de cliente real. - 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 Cómo obtener el archivo de autenticación de la 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 de Servicios o ingresar el siguiente comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Configura ExtraHop Syslog
- Accede a ExtraHop Administration con
https://<extrahop-hostname-or-IP-address>/admin
. - Ve a Estado y diagnóstico > Registro de auditoría.
- Haz clic en Configurar parámetros de Syslog.
- Proporciona los siguientes detalles de configuración:
- Destino: Ingresa la dirección IP del agente de BindPlane.
- Protocolo: Selecciona UDP o TCP, según la configuración de Bindplane.
- Puerto: Ingresa el número de puerto del agente de Bindplane.
- Haz clic en Configuración de la prueba.
- Haz clic en Guardar.
Tabla de asignación de UDM
Campo de registro | Asignación de UDM | Lógica |
---|---|---|
alert_name |
security_result.summary |
El valor de alert_name del registro sin procesar se asigna a security_result.summary . |
answers[].data |
network.dns.answers[].data |
El valor de data para cada elemento del array answers del registro sin procesar se asigna al campo data del elemento correspondiente en el array network.dns.answers . |
answers[].name |
network.dns.answers[].name |
El valor de name para cada elemento del array answers del registro sin procesar se asigna al campo name del elemento correspondiente en el array network.dns.answers . |
answers[].ttl |
network.dns.answers[].ttl |
El valor de ttl para cada elemento del array answers del registro sin procesar se asigna al campo ttl del elemento correspondiente en el array network.dns.answers . |
answers[].typeNum |
network.dns.answers[].type |
El valor de typeNum para cada elemento del array answers del registro sin procesar se asigna al campo type del elemento correspondiente en el array network.dns.answers . |
client_ip |
principal.ip |
El valor de client_ip del registro sin procesar se asigna a principal.ip . |
cn1 |
security_result.rule_labels[].value |
El valor de cn1 del registro sin procesar se usa como el valor de un elemento security_result.rule_labels con la clave "ID de detección". |
cn2 |
security_result.detection_fields[].value |
El valor de cn2 del registro sin procesar se usa como el valor de un elemento security_result.detection_fields con la clave "riskscore". |
cs1 |
security_result.rule_name |
El valor de cs1 del registro sin procesar se asigna a security_result.rule_name . |
cs2 |
security_result.category_details[] |
El valor de cs2 del registro sin procesar se agrega como un elemento al array security_result.category_details . |
description |
metadata.description |
El valor de description del registro sin procesar, después de cierto procesamiento (quitar caracteres de nueva línea y barras inversas), se asigna a metadata.description . En algunos casos, otros campos del registro sin procesar pueden contribuir a este campo o sobrescribirlo. |
details |
principal.resource.resource_subtype , security_result.summary , principal.ip |
Se analiza el campo details . El valor asociado a la clave "facility" se asigna a principal.resource.resource_subtype . El valor asociado a la clave "details" se asigna a security_result.summary . El valor asociado a la clave "src_ip" se asigna a principal.ip . |
dst |
target.ip o target.mac |
El valor de dst del registro sin procesar se asigna a target.ip si es una dirección IP o a target.mac si es una dirección MAC. |
dst_ip |
target.ip |
El valor de dst_ip del registro sin procesar se asigna a target.ip . |
eh_event |
metadata.event_type , network.application_protocol |
Si eh_event es "dns", metadata.event_type se establece en NETWORK_DNS y network.application_protocol se establece en DNS . Si eh_event es "RDP", metadata.event_type se establece en NETWORK_CONNECTION y network.application_protocol se establece en RDP . |
event_id |
metadata.product_event_type |
El valor de event_id del registro sin procesar se asigna a metadata.product_event_type . |
facility |
principal.resource.resource_subtype |
El valor de facility del registro sin procesar se asigna a principal.resource.resource_subtype . |
ipaddr |
principal.ip |
El valor de ipaddr del registro sin procesar se asigna a principal.ip . |
jsonPayload.description |
metadata.product_event_type , principal.hostname , principal.asset.hostname , security_result.summary |
El campo jsonPayload.description se analiza como JSON. El campo "operation" se asigna a metadata.product_event_type . El campo "event" (después de quitar "Audit Log") se asigna a principal.hostname y principal.asset.hostname . El campo “details” se asigna a security_result.summary . |
jsonPayload.event |
metadata.product_event_type , principal.hostname , principal.asset.hostname |
El valor de jsonPayload.event del registro sin procesar (después de quitar "Audit Log") se asigna a metadata.product_event_type , principal.hostname y principal.asset.hostname . |
jsonPayload.id |
metadata.product_log_id |
El valor de jsonPayload.id del registro sin procesar se asigna a metadata.product_log_id . |
macaddr |
principal.mac |
El valor de macaddr del registro sin procesar se asigna a principal.mac . |
name |
metadata.description |
El valor de name del registro sin procesar se asigna a metadata.description . |
object_id |
target.resource.product_object_id |
El valor de object_id del registro sin procesar se asigna a target.resource.product_object_id . |
object_name |
target.resource.name |
El valor de object_name del registro sin procesar se asigna a target.resource.name . |
object_type |
target.resource.resource_type |
El valor de object_type del registro sin procesar (convertido a mayúsculas) se asigna a target.resource.resource_type . |
operation |
metadata.product_event_type |
El valor de operation del registro sin procesar se asigna a metadata.product_event_type . |
priority |
security_result.severity , security_result.severity_details |
Si priority es "notice", security_result.severity se establece en MEDIUM y security_result.severity_details se establece en el valor de priority . |
product_event_type |
metadata.product_event_type |
El valor de product_event_type del registro sin procesar se asigna a metadata.product_event_type . También se usa para determinar el metadata.event_type y otros campos según su valor. |
qname |
network.dns.questions[].name |
El valor de qname del registro sin procesar se asigna al campo name de un elemento network.dns.questions . |
qname_or_host |
intermediary.hostname |
El valor de qname_or_host del registro sin procesar se asigna a intermediary.hostname . |
qtype |
network.dns.questions[].type |
El valor de qtype del registro sin procesar se asigna al campo type de un elemento network.dns.questions , lo que convierte la representación de cadena en su equivalente numérico según los tipos de registros DNS. |
resource.labels.project_id |
target.resource.attribute.labels[].value |
El valor de resource.labels.project_id del registro sin procesar se usa como el valor de un elemento target.resource.attribute.labels con la clave "ID del proyecto". |
resource.type |
target.resource.resource_subtype |
El valor de resource.type del registro sin procesar se asigna a target.resource.resource_subtype . |
rdp_record.clientBuild |
metadata.product_version |
El valor de rdp_record.clientBuild del registro sin procesar se asigna a metadata.product_version . |
rdp_record.clientBytes |
network.sent_bytes |
El valor de rdp_record.clientBytes del registro sin procesar se asigna a network.sent_bytes . |
rdp_record.clientName |
principal.hostname |
El valor de rdp_record.clientName del registro sin procesar se asigna a principal.hostname . |
rdp_record.clientPort |
principal.port |
El valor de rdp_record.clientPort del registro sin procesar se asigna a principal.port . |
rdp_record.cookie |
principal.user.userid |
El valor de rdp_record.cookie (después de quitar "mstshash=") del registro sin procesar se asigna a principal.user.userid . |
rdp_record.proto |
network.ip_protocol |
El valor de rdp_record.proto del registro sin procesar se asigna a network.ip_protocol , lo que convierte "TCP" en "TCP" y "UDP" en "UDP". |
rdp_record.selectedProtocol |
security_result.description |
El valor de rdp_record.selectedProtocol del registro sin procesar se asigna a security_result.description . |
rdp_record.serverBytes |
network.received_bytes |
El valor de rdp_record.serverBytes del registro sin procesar se asigna a network.received_bytes . |
rdp_record.serverPort |
target.port |
El valor de rdp_record.serverPort del registro sin procesar se asigna a target.port . |
rt |
metadata.event_timestamp |
El valor de rt del registro sin procesar se analiza como una marca de tiempo y se asigna a metadata.event_timestamp . |
severity |
security_result.severity , security_result.severity_details , event.idm.is_alert , event.idm.is_significant |
El valor de severity se asigna a security_result.severity_details . También se usa para determinar el valor de security_result.severity , event.idm.is_alert y event.idm.is_significant . |
src |
principal.ip o principal.mac |
El valor de src del registro sin procesar se asigna a principal.ip si es una dirección IP o a principal.mac si es una dirección MAC. |
src_ip |
principal.ip o principal.mac |
El valor de src_ip del registro sin procesar se asigna a principal.ip si es una dirección IP o a principal.mac si es una dirección MAC. |
summary |
security_result.summary |
El valor de summary del registro sin procesar se asigna a security_result.summary . |
ts |
metadata.event_timestamp |
El valor de ts del registro sin procesar se analiza como una marca de tiempo y se asigna a metadata.event_timestamp . |
user |
principal.user.userid |
El valor de user del registro sin procesar se asigna a principal.user.userid . |
(N/A) | metadata.log_type |
Siempre se establece en "EXTRAHOP". |
(N/A) | metadata.vendor_name |
Siempre se establece en "EXTRAHOP". |
(N/A) | metadata.product_name |
Siempre se establece en "EXTRAHOP". |
(N/A) | security_result.severity |
Se establece en CRITICAL de forma predeterminada o según el valor de severity o priority . |
(N/A) | event.idm.is_alert |
Se establece en true si security_result.severity es "HIGH" o "CRITICAL". |
(N/A) | event.idm.is_significant |
Se establece en true si security_result.severity es "HIGH" o "CRITICAL". |
(N/A) | metadata.event_type |
Se determina en función de los valores de otros campos, como eh_event , product_event_type , has_principal y dst . El valor predeterminado es GENERIC_EVENT . |
(N/A) | network.application_protocol |
Se establece en DNS si eh_event es "dns" o si message contiene "DNS Rebinding". Se establece en RDP si eh_event es "RDP". |
(N/A) | security_result.rule_labels[].key |
Se establece en "ID de detección" para la etiqueta de regla derivada de cn1 . |
(N/A) | security_result.detection_fields[].key |
Se establece en "riskscore" para el campo de detección derivado de cn2 . |
(N/A) | principal.user.attribute.roles[].type |
Se establece en SERVICE_ACCOUNT si user_name está presente. |
(N/A) | extensions.auth.type |
Se establece en SSO si product_event_type es "Errores de autenticación del cliente Kerberos". |
(N/A) | extensions.auth.mechanism |
Se establece en USERNAME_PASSWORD si product_event_type es "Unsafe LDAP Authentication" o "Kerberos Client Auth Errors". |
(N/A) | security_result.category |
Se establece en NETWORK_SUSPICIOUS si product_event_type es "DNS Internal Reverse Lookup Scan" o contiene "Inbound Suspicious Connections". Se establece en NETWORK_MALICIOUS si product_event_type es "Solicitud al servidor de base de datos externo". |
(N/A) | network.http.response_code |
Se establece según el status_code extraído de product_event_type si coincide con el patrón "HTTP Server %{INT:status_code} %{GREEDYDATA}". |
jsonPayload.cs1 |
security_result.detection_fields[].value |
El valor de jsonPayload.cs1 del registro sin procesar se usa como el valor de un elemento security_result.detection_fields . |
jsonPayload.cn1 |
security_result.detection_fields[].value |
El valor de jsonPayload.cn1 del registro sin procesar se usa como el valor de un elemento security_result.detection_fields . |
jsonPayload.cn2 |
security_result.detection_fields[].value |
El valor de jsonPayload.cn2 del registro sin procesar se usa como el valor de un elemento security_result.detection_fields . |
jsonPayload.cs1Label , jsonPayload.cn1Label , jsonPayload.cn2Label |
security_result.detection_fields[].key |
Estos campos del registro sin procesar se usan como claves para los elementos correspondientes en security_result.detection_fields . |
jsonPayload.src |
principal.ip |
El valor de jsonPayload.src del registro sin procesar se asigna a principal.ip . |
jsonPayload.dst |
target.ip |
El valor de jsonPayload.dst del registro sin procesar se asigna a target.ip . |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.