Recopila registros de módems Digi

Compatible con:

En este documento, se explica cómo transferir registros de módems Digi a Google Security Operations con Bindplane. Primero, el código del analizador extrae campos como la marca de tiempo, el nombre de host, el tipo de producto y el contenido del registro de los mensajes syslog de DIGI_MODEMS con patrones de Grok. Luego, analiza aún más el contenido para identificar intentos de acceso (exitosos o fallidos) y extraer detalles como el usuario, la dirección IP, el puerto y los protocolos. Por último, asigna estos campos extraídos a un esquema del Modelo de datos unificado (UDM) para el análisis de seguridad.

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 se ejecuta detrás de un proxy, los puertos de firewall están abiertos.
  • Acceso con privilegios a la IU web de Digi Remote Manager o del módem Digi local

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: 'DIGI_MODEMS'
            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

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

    sudo systemctl restart bindplane-agent
    
  2. 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 el servidor Syslog en el módem Digi

  1. Accede a Digi Remote Manager o a la IU web local de Digi Modem.
  2. Accede a la configuración del dispositivo con Administrador remoto:
    • Busca el dispositivo para el que deseas configurar Syslog.
    • Haz clic en ID del dispositivo > Configuración > Config.
  3. Accede a la configuración del dispositivo con la IU web local del módem Digi:
    • Haz clic en System > Configuration > Device Configuration.
  4. Ve a System > Log.
  5. Haz clic para expandir la Lista de servidores.
  6. Haz clic en Agregar servidor +.
  7. Proporciona los siguientes detalles de configuración:
    • Servidor: Ingresa la dirección IP del agente de Bindplane.
    • Selecciona las categorías de eventos que se enviarán al servidor (todas las categorías de eventos están habilitadas de forma predeterminada).
    • Puerto de salida de Syslog: Ingresa el número de puerto del agente de Bindplane (el valor predeterminado es 514).
    • Protocolo: Selecciona UDP.
  8. Haz clic en Aplicar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
contenido security_result.description Se asigna directamente desde el campo content después del análisis inicial de grok.
http_method network.http.method Se extrae del campo content con un patrón de Grok.
http_version network.application_protocol_version Se extrae del campo content con un patrón de Grok.
Nombre de host principal.hostname Se extrae del mensaje de registro con un patrón de Grok.
ip target.ip Se extrae del campo content con un patrón de Grok.
puerto target.port Se extrae del campo content con un patrón de Grok y se convierte en un número entero.
protocolo network.application_protocol Se extrae del campo content con un patrón de Grok.
ts metadata.event_timestamp Se extrae del mensaje de registro con un patrón de Grok y se convierte en una marca de tiempo.
tipo login_type_label.value Se extrae del campo content con un patrón de Grok.
extensions.auth.type La lógica del analizador la establece en MACHINE.
login_type_label.key La lógica del analizador la establece en Login type.
metadata.event_type Se determina por la presencia de campos específicos, como ip o user, y se establece en NETWORK_CONNECTION o USER_LOGIN según corresponda.
metadata.log_type La lógica del analizador la establece en DIGI_MODEMS.
metadata.product_event_type Se extrae del campo product_type en el mensaje de registro.
metadata.product_name La lógica del analizador la establece en DIGI_MODEMS.
metadata.vendor_name La lógica del analizador la establece en DIGI_MODEMS.
security_result.action Se determina por la presencia de Login OK o Login failure en el mensaje y se establece en ALLOW o BLOCK, respectivamente.
usuario target.user.userid Se extrae del campo content con un patrón de Grok.

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