Recopila registros del balanceador de cargas de Kemp

Compatible con:

En este documento, se explica cómo transferir registros de Progress Kemp LoadMaster a Google Security Operations con el agente de Bindplane.

Progress Kemp LoadMaster (antes Kemp Load Balancer) es un controlador de entrega de aplicaciones (ADC) que proporciona balanceo de cargas, descarga de SSL y administración de tráfico para aplicaciones empresariales. Distribuye el tráfico entrante entre varios servidores para garantizar una alta disponibilidad, optimizar el rendimiento y mejorar la seguridad de las aplicaciones y los servicios basados en la Web.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Un host de Windows 2016 o posterior, o Linux con systemd
  • Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
  • Acceso con privilegios a la interfaz de usuario web (WUI) de Progress Kemp LoadMaster

Obtén credenciales de Google SecOps para el agente de Bindplane

Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:

  • Implementaciones nuevas: Usa la API de Chronicle (opción 1).
  • Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
  1. Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
  2. Ve a IAM y administración > Cuentas de servicio.
  3. Haga clic en Crear cuenta de servicio.
  4. Proporciona los siguientes detalles de configuración:
    • Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo, bindplane-ingest).
    • Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo, Bindplane agent log ingestion).
  5. Haz clic en Crear y continuar.
  6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
  7. Haz clic en Continuar y, luego, en Listo.
  8. Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
  9. Haz clic en Agregar clave > Crear clave nueva.
  10. Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
  11. Guarda el archivo de claves como ingestion-auth.json en el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.json en Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json en Windows) o actualiza creds_file_path en config.yaml para que coincida con la ruta de acceso en la que lo guardas.
  12. Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.

Opción 2: Descarga el archivo de autenticación de transferencia (heredado)

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
  3. Descarga el archivo de autenticación de transferencia.
  4. Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.

Obtén el ID de cliente de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
  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 comando siguiente:

      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 comando siguiente:

      sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

Recursos adicionales para la instalación

Para conocer otras opciones de instalación, consulta esta 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 /opt/observiq-otel-collector/ en Linux o en el directorio de instalación en Windows.
    • Abre el archivo con un editor de texto (por ejemplo, nano, vi o el 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:
          protocol: https
          # Region of your instance, for example us, europe, asia-southeast1
          location: <LOCATION>
          # Project number of the Google Cloud project linked to the instance
          project: '<PROJECT_NUMBER>'
          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: YOUR_CUSTOMER_ID_HERE
          endpoint: chronicle.googleapis.com
          # Add optional ingestion labels for better organization
          log_type: 'KEMP_LOADBALANCER'
          raw_log_field: body
          ingestion_labels:
    
      service:
        pipelines:
          logs/source0__chronicle_w_labels-0:
            receivers:
              - udplog
            exporters:
              - chronicle/chronicle_w_labels
    
  3. Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.

  4. Reemplaza YOUR_CUSTOMER_ID_HERE por el ID de cliente real.

  5. Actualiza /path/to/ingestion-authentication-file.json a la ruta de acceso del archivo en la que se guardó el archivo de claves de la cuenta de servicio (opción 1) en el paso 1.

  6. Reemplaza <LOCATION> por la región de tu instancia de Google SecOps (por ejemplo, us, europe o asia-southeast1). El exportador antepone chronicle.googleapis.com con este valor. Consulta Extremos regionales para obtener la lista completa.

  7. Reemplaza <PROJECT_NUMBER> por el número de proyecto de IAM y administración > Configuración.

Exportador de la API de transferencia heredada

  • Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque exporters por lo siguiente. Establece creds_file_path en la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplaza malachiteingestion-pa.googleapis.com por tu extremo regional (por ejemplo, europe-malachiteingestion-pa.googleapis.com).

    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: YOUR_CUSTOMER_ID_HERE
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'KEMP_LOADBALANCER'
        raw_log_field: body
        ingestion_labels:
    

Reinicia el agente de Bindplane para aplicar los cambios

  1. Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:

      sudo systemctl restart observiq-otel-collector
    
  2. Para reiniciar el agente de Bindplane en Windows, puedes usar la consola de Servicios o ingresar el siguiente comando:

      net stop observiq-otel-collector && net start observiq-otel-collector
    

Configura el reenvío de syslog de Progress Kemp LoadMaster

  1. Accede a la interfaz de usuario web (WUI) de Progress Kemp LoadMaster.
  2. Ve a System Configuration > Logging Options > Syslog Options.
  3. En el campo Remote Syslog Host, ingresa la dirección IP del host del agente de Bindplane (por ejemplo, 192.168.1.100).
  4. En el campo Puerto de Syslog remoto, ingresa 514 (o el puerto configurado en Bindplane).
  5. Establece la opción Info Syslog Messages en Yes para habilitar los mensajes de registro informativos.
  6. Establece la opción Warning Syslog Messages en Yes para habilitar los mensajes de advertencia.
  7. Establece la opción Error Syslog Messages en Yes para habilitar los mensajes de error.
  8. Establece la opción Mensajes de Syslog críticos en Sí para habilitar los mensajes críticos.
  9. Establece la opción Mensajes de Syslog de emergencia en Sí para habilitar los mensajes de emergencia.
  10. Haz clic en Set Syslog Parameters para guardar la configuración.
  11. Para habilitar el registro de syslog de WAF, ve a Configuración del sistema > Opciones de registro > Opciones de syslog de WAF.
  12. Establece la opción Remote Syslog en Yes.
  13. Haz clic en Set WAF Syslog Parameters para guardar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
hlen_label additional.fields Combinado
meta_sequenceId_label additional.fields Combinado
nhdrs_label additional.fields Combinado
intermediary intermediary Combinado
inter_hostname intermediary.hostname Asignada directamente
description metadata.description Asignada directamente
event_type metadata.event_type Se cambió el nombre o se asignó
log_event metadata.product_event_type Asignada directamente
sequenceId metadata.product_log_id Asignada directamente
ftpmethod network.ftp.command Asignada directamente
http_method network.http.method Asignada directamente
http_response_code network.http.response_code Asignada directamente
process_name principal.application Asignada directamente
src_ip principal.ip Combinado
srcip principal.ip Combinado
src_port principal.port Asignada directamente
srcport principal.port Asignada directamente
sec_result security_result Combinado
sshd target.application Asignada directamente
filename target.file.full_path Asignada directamente
file_size target.file.size Se cambió el nombre o se asignó
dest_ip target.ip Combinado
dstip target.ip Combinado
vs target.ip Combinado
dest_port target.port Asignada directamente
dstport target.port Asignada directamente
vs_port target.port Asignada directamente
pid target.process.pid Asignada directamente
http_path target.url Asignada directamente
resource target.url Asignada directamente
user target.user.userid Asignada directamente
N/A additional.fields Constante: meta_sequenceId_label
N/A extensions.auth.type Constante: AUTHTYPE_UNSPECIFIED
N/A intermediary Constante: intermediary
N/A metadata.event_type Constante: GENERIC_EVENT
N/A metadata.product_name Constante: KEMP_LOADBALANCER
N/A metadata.vendor_name Constante: KEMP
N/A network.application_protocol Constante: HTTP
N/A principal.ip Constante: src_ip
N/A security_result Constante: sec_result
N/A target.ip Constante: dest_ip
meta_sequenceId event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
event_type USER_UNCATEGORIZED Asignado desde el registro de cambios

Para obtener más información sobre la asignación de campos del analizador, consulta la referencia del analizador de KEMP_LOADBALANCER.

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.