Recopila registros de ExtraHop RevealX

Compatible con:

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

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Collection Agents.
  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 SIEM Settings > Profile.
  3. 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

  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 en 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
            log_type: 'EXTRAHOP'
            raw_log_field: body
            ingestion_labels:
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    

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

  1. Accede a ExtraHop Administration con https://<extrahop-hostname-or-IP-address>/admin.
  2. Ve a Estado y diagnóstico > Registro de auditoría.
  3. Haz clic en Configurar parámetros de Syslog.
  4. 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.
  5. 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.