Recopila registros de Extreme Wireless
Versión del analizador: 2.0
En este documento, se explica cómo transferir registros de Extreme Wireless a Google Security Operations con el agente de Bindplane.
Los controladores inalámbricos de Extreme Networks generan mensajes de syslog para eventos de asociación y desasociación de clientes, autenticación, interacciones de RADIUS y cambios de estado de los puntos de acceso. 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 controlador de CloudIQ de Extreme Networks
- 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 privilegiado a CloudIQ de Extreme Networks
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/extreme_wireless: 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: EXTREME_WIRELESS raw_log_field: body service: pipelines: logs/extreme_wireless_to_chronicle: receivers: - udplog exporters: - chronicle/extreme_wireless
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/extreme_wireless: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: EXTREME_WIRELESS 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 syslog en Extreme Networks CloudIQ
- Accede a la IU web de CloudIQ.
- Ve a Configure > Common Objects > Management > Syslog Servers.
- Haz clic en +.
- Proporciona los siguientes detalles de configuración:
- Nombre: Proporciona un nombre único para el servidor.
- Gravedad: Selecciona Información.
- Selecciona una dirección IP de syslog existente en el menú Seleccionar o haz clic en +.
- Ingresa la dirección IP del agente de Bindplane.
- Ingresa el número de puerto del agente de Bindplane.
- Haz clic en AGREGAR.
- Haz clic en Guardar servidor Syslog.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
action |
security_result.detection_fields.key |
El valor del campo action del registro sin procesar se asigna al security_result.detection_fields.key. |
action |
security_result.detection_fields.value |
El valor del campo action del registro sin procesar se asigna al security_result.detection_fields.value. |
BSSID |
principal.resource.attribute.labels.key |
La cadena "BSSID" se asigna al principal.resource.attribute.labels.key. |
BSSID |
principal.resource.attribute.labels.value |
El valor del campo BSSID del registro sin procesar se asigna al principal.resource.attribute.labels.value. |
collection_time.nanos |
metadata.event_timestamp.nanos |
El valor de collection_time.nanos del registro sin procesar se asigna a metadata.event_timestamp.nanos. |
collection_time.seconds |
metadata.event_timestamp.seconds |
El valor de collection_time.seconds del registro sin procesar se asigna a metadata.event_timestamp.seconds. |
collection_time.seconds |
timestamp.seconds |
El valor de collection_time.seconds del registro sin procesar se asigna a timestamp.seconds. |
collection_time.nanos |
timestamp.nanos |
El valor de collection_time.nanos del registro sin procesar se asigna a timestamp.nanos. |
data |
security_result.description |
El valor del campo data del registro sin procesar, después de someterse a varias transformaciones de gsub para quitar caracteres no deseados y valores "N/A", se asigna al campo security_result.description. |
description |
security_result.description |
El valor del campo description, extraído por el analizador de grok, se asigna al campo security_result.description. |
first |
security_result.detection_fields.key |
La cadena "first" se asigna a security_result.detection_fields.key. |
first |
security_result.detection_fields.value |
El valor del campo first del registro sin procesar se asigna al security_result.detection_fields.value. |
hostname |
principal.asset.hostname |
El valor del campo hostname del registro sin procesar se asigna a los campos principal.asset.hostname y principal.hostname. |
hostname |
principal.hostname |
El valor del campo hostname del registro sin procesar se asigna a los campos principal.asset.hostname y principal.hostname. |
IP |
principal.asset.ip |
El valor del campo IP del registro sin procesar se asigna a los campos principal.asset.ip y principal.ip. |
IP |
principal.ip |
El valor del campo IP del registro sin procesar se asigna a los campos principal.asset.ip y principal.ip. |
MAC |
principal.resource.attribute.labels.key |
La cadena "MAC" se asigna a principal.resource.attribute.labels.key. |
MAC |
principal.resource.attribute.labels.value |
El valor del campo MAC del registro sin procesar se asigna al principal.resource.attribute.labels.value. |
medium |
security_result.detection_fields.key |
La cadena "medium" se asigna a security_result.detection_fields.key. |
medium |
security_result.detection_fields.value |
El valor del campo medium del registro sin procesar se asigna al security_result.detection_fields.value. El metadata.event_type se determina por la lógica dentro del analizador. Si están presentes los IDs de máquina principal y target, se establece en NETWORK_CONNECTION. Si están presentes los IDs de usuario principal o target, se establece en USER_UNCATEGORIZED. Si solo está presente el ID de máquina principal, se establece en STATUS_UPDATE. De lo contrario, el valor predeterminado es GENERIC_EVENT. La cadena "EXTREME WIRELESS" se asigna a metadata.product_name. |
prod_event_type |
metadata.product_event_type |
El valor del campo prod_event_type del registro sin procesar se asigna al campo metadata.product_event_type. |
port |
principal.port |
El valor del campo port del registro sin procesar, convertido en un número entero, se asigna al campo principal.port. |
problem_summary |
security_result.summary |
El valor del campo problem_summary del registro sin procesar se asigna al campo security_result.summary. |
SSID |
principal.resource.attribute.labels.key |
La cadena "SSID" se asigna a principal.resource.attribute.labels.key. |
SSID |
principal.resource.attribute.labels.value |
El valor del campo SSID del registro sin procesar se asigna al principal.resource.attribute.labels.value. |
station |
principal.asset.hostname |
El valor del campo station del registro sin procesar se asigna a los campos principal.asset.hostname y principal.hostname. |
station |
principal.hostname |
El valor del campo station del registro sin procesar se asigna a los campos principal.asset.hostname y principal.hostname. |
target_host |
target.asset.hostname |
El valor del campo target_host del registro sin procesar se asigna a los campos target.asset.hostname y target.hostname. |
target_host |
target.hostname |
El valor del campo target_host del registro sin procesar se asigna a los campos target.asset.hostname y target.hostname. |
target_ip |
target.asset.ip |
El valor del campo target_ip del registro sin procesar se asigna a los campos target.asset.ip y target.ip. |
target_ip |
target.ip |
El valor del campo target_ip del registro sin procesar se asigna a los campos target.asset.ip y target.ip. |
target_port |
target.port |
El valor del campo target_port del registro sin procesar, convertido en un número entero, se asigna al campo target.port. |
target_user |
target.user.userid |
El valor del campo target_user del registro sin procesar se asigna al campo target.user.userid. |
user-profile |
security_result.detection_fields.key |
La cadena "perfil de usuario" se asigna a security_result.detection_fields.key. |
user-profile |
security_result.detection_fields.value |
El valor del campo user-profile del registro sin procesar se asigna al security_result.detection_fields.value. |
username |
principal.user.userid |
El valor del campo username del registro sin procesar se asigna al campo principal.user.userid. La cadena "EXTREME_WIRELESS" se asigna a metadata.vendor_name. |
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.