Recopila registros de Cambium Networks
En este documento, se explica cómo transferir registros de Cambium Networks a Google Security Operations con Bindplane. El analizador extrae pares clave-valor de los mensajes de syslog del interruptor y el router de Cambium Networks y los asigna a un modelo de datos unificado (UDM). Usa Grok para estructurar el mensaje inicial, KV para separar los pares clave-valor y las sentencias condicionales para asignar campos extraídos a atributos específicos de la AUA, y categorizar los eventos como "STATUS_UPDATE" o "GENERIC_EVENT".
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 del firewall están abiertos.
- Acceso privilegiado a dispositivos Cambium Networks
Obtén el archivo de autenticación de transferencia de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a Configuración de SIEM > 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á Bindplane.
Obtén el ID de cliente de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a Configuración de SIEM > Perfil.
- Copia y guarda el ID de cliente de la sección Detalles de la organización.
Instala el agente de Bindplane
Instalación de 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 de 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: '/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 ingestion_labels: log_type: 'CAMBIUM_NETWORKS' raw_log_field: body 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 Obtén el archivo de autenticación de 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 Services o ingresar el siguiente comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Configura Syslog en ePMP 1000/2000/Force 180/200 y ePMP Elevate
- Accede a la GUI de Cambium Networks.
- Ve a Configurar > Sistema > Registro de Syslog.
- Proporciona los siguientes detalles de configuración:
- Máscara de Syslog: Haz clic en Seleccionar todo.
- Servidor 1: Ingresa la dirección IP del agente de Bindplane.
- Haz clic en Guardar.
Configura Syslog en ePMP 1000 HS y cnPilot E400/E500/E501
- Accede a la GUI de Cambium Networks.
- Ve a Configurar > Sistema > Registro de eventos.
- Proporciona los siguientes detalles de configuración:
- Syslog Server 1: Ingresa la dirección IP del agente de Bindplane.
- Haz clic en Guardar.
Accede a la CLI del dispositivo con SSH y, luego, ingresa el siguiente comando para habilitar el nivel de depuración:
logging cnmaestro 7
Guarda y aplica la configuración.
Ingresa el siguiente comando para verificar los registros del agente de dispositivos desde la CLI:
service show debug-logs device-agent
Cómo configurar Syslog en cnPilot R200/R201/R190
- Accede a la GUI de Cambium Networks.
- Ve a Administración > Administración > Configuración del registro del sistema.
- Proporciona los siguientes detalles de configuración:
- Syslog Enable: Selecciona Habilitar.
- Nivel de Syslog: Selecciona INFO.
- Remote Syslog Enable: Selecciona Enable.
- Servidor de Syslog remoto: Ingresa la dirección IP del agente de Bindplane.
- Haz clic en Guardar.
Cómo configurar Syslog en el AP PMP 450/450i/450m
- Accede a la GUI de Cambium Networks.
- Ve a Configuración > cnMaestro.
- Proporciona los siguientes detalles de configuración:
- Nivel de registro de depuración del agente de cnMaestro: Selecciona INFO.
- Ve a Configuración > Syslog.
- Proporciona los siguientes detalles de configuración:
- Uso del servidor DNS de Syslog: Selecciona Disable DNS Domain Name.
- Servidor de Syslog: Ingresa la dirección IP del agente de Bindplane.
- Puerto del servidor de Syslog: Ingresa el número de puerto del agente de Bindplane.
- AP Syslog Transmit: Selecciona Enabled.
- SM Syslog Transmit: Selecciona Enabled.
- Nivel mínimo de Syslog: Selecciona info.
- Haz clic en Guardar.
Configura Syslog en el SM PMP 450/450i/450m
- Accede a la GUI de Cambium Networks.
- Ve a Configuración > cnMaestro.
- Proporciona los siguientes detalles de configuración:
- Nivel de registro de depuración del agente de cnMaestro: Selecciona INFO.
- Ve a Configuración > Syslog.
- Proporciona los siguientes detalles de configuración:
- Fuente de configuración de Syslog: Selecciona AP Preferred.
- Uso del servidor DNS de Syslog: Selecciona Disable DNS Domain Name.
- Servidor de Syslog: Ingresa la dirección IP del agente de Bindplane.
- Puerto del servidor de Syslog: Ingresa el número de puerto del agente de Bindplane.
- Transmisión de Syslog: Selecciona Obtener del AP.
- Syslog Minimum Level Source: Selecciona AP Preferred.
- Nivel mínimo de Syslog: Selecciona info.
- Haz clic en Guardar.
Tabla de asignación de la UDM
Campo de registro | Asignación de UDM | Lógica |
---|---|---|
bssid | read_only_udm.principal.mac | Se extrae de kv_fields con la clave bssid . |
canal | read_only_udm.security_result.about.resource.attribute.labels.value | Se extrae de kv_fields con la clave channel . Es parte de una etiqueta. |
host_name | read_only_udm.principal.hostname | Se extrae del mensaje de registro con el patrón grok. |
ids_event | read_only_udm.security_result.summary | Se extrae de kv_fields con la clave ids_event . |
ids_status | read_only_udm.security_result.description | Se extrae de kv_fields con la clave ids_status . Se usa como descripción cuando está presente. |
iap | read_only_udm.security_result.about.resource.attribute.labels.value | Se extrae de kv_fields con la clave iap . Es parte de una etiqueta. |
fabricante | read_only_udm.security_result.about.resource.attribute.labels.value | Se extrae de kv_fields con la clave manufacturer . Es parte de una etiqueta. |
rssi | read_only_udm.security_result.about.resource.attribute.labels.value | Se extrae de kv_fields con la clave rssi . Es parte de una etiqueta. |
seguridad | read_only_udm.security_result.about.resource.attribute.labels.value | Se extrae de kv_fields con la clave security . Es parte de una etiqueta. |
gravedad, | read_only_udm.security_result.severity | Se asigna desde el mensaje de registro con el patrón grok. alert se asigna a HIGH , warn se asigna a MEDIUM y todo lo demás se asigna a LOW . |
gravedad, | read_only_udm.security_result.severity_details | Se asigna desde el mensaje de registro con el patrón grok. Conserva el valor de gravedad original. |
ssid | read_only_udm.principal.application | Se extrae de kv_fields con la clave ssid . |
timestamp | read_only_udm.metadata.event_timestamp | Se extrae del mensaje de registro con el patrón grok y se convierte en una marca de tiempo. |
read_only_udm.metadata.event_type | Se determina en función de la presencia de valores en los campos security_result y host_name . Si ambos campos están presentes, el tipo de evento se establece como STATUS_UPDATE ; de lo contrario, es GENERIC_EVENT . |
|
read_only_udm.security_result.about.resource.attribute.labels.key | La lógica del analizador determina el valor de este campo según el par clave-valor específico que se está procesando. Los valores posibles son Internet_Access_Provider , manufacturer , channel , received_signal_strength_indicator y encryption_standard . |
|
read_only_udm.security_result.description | Si la gravedad es warn , este campo toma el valor de kv_fields ; de lo contrario, toma el valor de ids_status . |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.