Recopila registros de Digi Modems
Versión del analizador: 1.0
En este documento, se explica cómo transferir registros de Digi Modems a Google Security Operations con el agente de Bindplane.
Los Digi Modems son módems móviles industriales que generan mensajes de syslog para eventos de acceso, intentos de autenticación y conexiones de red. El analizador extrae campos con patrones de grok y los asigna al modelo de datos unificado (UDM).
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Windows Server 2016 o posterior, o host de Linux con
systemd - Conectividad de red entre el agente de Bindplane y el módem Digi
- 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 Digi Remote Manager o a la IU web local de Digi Modem
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.
Opción 1: Crea una cuenta de servicio para la API de Chronicle (recomendado)
- Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
- Ve a IAM y administración > Cuentas de servicio.
- Haga clic en Crear cuenta de servicio.
- 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).
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
- Haz clic en Crear y continuar.
- En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
- Haz clic en Continuar y, luego, en Listo.
- Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
- Haz clic en Agregar clave > Crear clave nueva.
- Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
- Guarda el archivo de claves como
ingestion-auth.jsonen el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonen Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonen Windows) o actualizacreds_file_pathenconfig.yamlpara que coincida con la ruta de acceso en la que lo guardas. - 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)
- Accede a la consola de Google SecOps.
- 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.
- Descarga el archivo de autenticación de transferencia.
- 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
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
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 comando siguiente:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sc query observiq-otel-collectorEl servicio debería mostrarse como RUNNING.
Instalación en Linux
- Abre una terminal con privilegios de raíz o sudo.
Ejecuta el comando siguiente:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sudo systemctl status observiq-otel-collectorEl servicio debería mostrarse como active (running).
Recursos de instalación adicionales
Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.
Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps
Ubica el archivo de configuración
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edita el archivo de configuración
Reemplaza todo el contenido de
config.yamlpor la siguiente configuración:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/digi_modems: 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 creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: DIGI_MODEMS raw_log_field: body service: pipelines: logs/digi_modems_to_chronicle: receivers: - udplog exporters: - chronicle/digi_modems
Parámetros de configuración
Reemplaza los marcadores de posición que se indican más abajo:
Configuración del receptor:
listen_address: Es la dirección IP y el puerto que se escucharán:0.0.0.0para escuchar en todas las interfaces (recomendado)- El puerto
514es el puerto estándar de syslog (requiere acceso raíz en Linux; usa1514para acceso no raíz)
Configuración del exportador:
creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Es el ID de cliente copiado de la consola de Google SecOps.location: Reemplaza<LOCATION>por la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1). El exportador agrega el prefijochronicle.googleapis.comcon este valor. Consulta Extremos regionales para obtener la lista completa.project: Reemplaza<PROJECT_NUMBER>por el número de proyecto de IAM y administración > Configuración.endpoint: Mantén la configuración comochronicle.googleapis.com.
Exportador de la API de transferencia heredada
Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque
exporterspor lo siguiente. Establececreds_file_pathen la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplazamalachiteingestion-pa.googleapis.compor tu extremo regional (por ejemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/digi_modems: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: DIGI_MODEMS raw_log_field: body
Guarda el archivo de configuración
- Después de editarlo, guarda el archivo:
- Linux: Presiona
Ctrl+O, luegoEntery, por último,Ctrl+X - Windows: Haz clic en Archivo > Guardar.
- Linux: Presiona
Reinicia el agente de Bindplane para aplicar los cambios.
Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:
sudo systemctl restart observiq-otel-collectorVerifica que el servicio esté en ejecución:
sudo systemctl status observiq-otel-collectorRevisa los registros en busca de errores:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:
Símbolo del sistema o PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collectorConsola de servicios:
- Presiona
Win+R, escribeservices.mscy presiona Intro. - Busca observIQ OpenTelemetry Collector.
- Haz clic con el botón derecho y selecciona Reiniciar.
Verifica que el servicio esté en ejecución:
sc query observiq-otel-collectorRevisa los registros en busca de errores:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Presiona
Configura el servidor Syslog en el módem Digi
- Accede a Digi Remote Manager o a la IU web local de Digi Modem.
- Accede a la configuración del dispositivo con el Administrador remoto:
- Busca el dispositivo para el que quieres configurar syslog.
- Haz clic en ID de dispositivo > Configuración > Configuración.
- Accede a la configuración del dispositivo con la IU web local del módem Digi:
- Haz clic en Sistema > Configuración > Configuración del dispositivo.
- Ve a Sistema > Registro.
- Haz clic para expandir la Lista de servidores.
- Haz clic en Agregar servidor +.
- 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.
- Haz clic en Aplicar.
Registros de muestra de módems Digi compatibles
SYSLOG
{ "priority": 14, "timestamp": "Dec 28 17:27:45", "hostname": "host-device.router", "tag": "Eventlog", "message": "17:27:33, 28 Dec 2006,Login failure by Host: 10.0.0.25:23: CMD,Telnet" }SYSLOG
{ "priority": 14, "timestamp": "May 25 11:03:55", "hostname": "internal-srv-01", "tag": "Eventlog", "message": "11:03:55, 25 May 2023,Login failure by sanitized_user: WEB" }SYSLOG
{ "priority": 14, "timestamp": "Jun 11 23:58:26", "hostname": "internal-srv-01", "tag": "Eventlog", "message": "23:58:26, 11 Jun 2023,Login failure by GET /masked_path HTTP/1.0: CMD,Telnet" }SYSLOG
{ "priority": 14, "timestamp": "Jun 19 19:52:19", "hostname": "gateway-device-02", "tag": "Eventlog", "message": "19:52:18, 19 Jun 2023,WEB Login OK by internal_admin lvl 0" }
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 lo establece en MACHINE. |
|
| login_type_label.key | La lógica del analizador lo establece en Login type. |
|
| metadata.event_type | Se determina por la presencia de campos específicos, como ip o user, y se establece según corresponda en NETWORK_CONNECTION o USER_LOGIN. |
|
| metadata.log_type | La lógica del analizador lo 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 lo establece en DIGI_MODEMS. |
|
| metadata.vendor_name | La lógica del analizador lo 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. |
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.