Reorganizamos la estructura de navegación de nuestra documentación para que se alinee directamente con tus flujos de trabajo operativos. Consulta las notas de la versión y el video explicativo para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Recopila registros del controlador inalámbrico y el punto de acceso de Aruba

Versión del analizador: 12.0

Compatible con:

Google SecOps SIEM

En este documento, se explica cómo transferir registros de los controladores inalámbricos y los puntos de acceso de Aruba a Google Security Operations con el agente de Bindplane.

Los controladores y puntos de acceso inalámbricos de Aruba generan mensajes de syslog para eventos inalámbricos, asociaciones de clientes, autenticación, control de acceso y operaciones del sistema. El analizador procesa los mensajes de syslog y extrae los campos relacionados con los detalles del observador, el intermediario y el punto de acceso.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

Una instancia de Google SecOps
Windows Server 2016 o versiones posteriores, o host de Linux con systemd
Conectividad de red entre el agente de Bindplane y el controlador inalámbrico de Aruba
Si se ejecuta detrás de un proxy, asegúrate de que los puertos de firewall estén abiertos según los requisitos del agente de Bindplane.
Acceso con privilegios a un controlador inalámbrico de Aruba

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á el agente de Bindplane.

Nota: Este archivo JSON contiene credenciales para autenticar el agente de Bindplane en Google SecOps.

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.

Nota: Se requiere el ID de cliente para configurar el exportador del agente de Bindplane.

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" /quiet

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sc query observiq-otel-collector
```
El servicio debería mostrarse como RUNNING.

Instalación en Linux

Abre una terminal con privilegios de administrador 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.sh

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sudo systemctl status observiq-otel-collector
```
El servicio debería mostrarse como activo (en ejecución).

Recursos de instalación adicionales

Para obtener más opciones de instalación y solucionar problemas, consulta la guía de instalación del agente de Bindplane.

Configura el agente de BindPlane para transferir registros de Syslog y enviarlos a Google SecOps

Ubica el archivo de configuración

Linux:

sudo nano /etc/bindplane-agent/config.yaml

Windows:

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

Edita el archivo de configuración

Reemplaza todo el contenido de config.yaml con la siguiente configuración:

receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/aruba_wireless:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: ARUBA_WIRELESS
        raw_log_field: body

service:
    pipelines:
        logs/aruba_wireless_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/aruba_wireless

Parámetros de configuración

Reemplaza los marcadores de posición que se indican más abajo:

Configuración del receptor:
- listen_address: Dirección IP y puerto que se escucharán:
  - 0.0.0.0 para escuchar en todas las interfaces (recomendado)
  - El puerto 514 es el puerto estándar de syslog (requiere acceso raíz en Linux; usa 1514 para acceso no raíz).
Configuración del exportador:
- creds_file_path: Ruta de acceso completa al archivo de autenticación de la transferencia:
  - Linux: /etc/bindplane-agent/ingestion-auth.json
  - Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- customer_id: ID de cliente copiado de la consola de Google SecOps
- endpoint: URL del extremo regional:
  - EE.UU.: malachiteingestion-pa.googleapis.com
  - Europa: europe-malachiteingestion-pa.googleapis.com
  - Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
  - Consulta Extremos regionales para obtener la lista completa.

Guarda el archivo de configuración

Después de editarlo, guarda el archivo:
- Linux: Presiona Ctrl+O, luego Enter y, después, Ctrl+X.
- Windows: Haz clic en Archivo > Guardar

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-collector
```
1. Verifica que el servicio esté en ejecución:
```
sudo systemctl status observiq-otel-collector
```
2. Revisa 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-collector
```
- Consola de Servicios:
  1. Presiona Win+R, escribe services.msc y presiona Intro.
  2. Busca observIQ OpenTelemetry Collector.
  3. Haz clic con el botón derecho y selecciona Reiniciar.
  4. Verifica que el servicio esté en ejecución:
```
sc query observiq-otel-collector
```
  5. Revisa los registros en busca de errores:
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

Configura el controlador y el punto de acceso inalámbricos de Aruba

Accede a la IU web del controlador de Aruba.
Ve al menú superior y selecciona Configuración > Sistema.
Selecciona Logging para abrir la página de configuración de registro.
En la sección Servidores Syslog, haz clic en + Agregar para agregar un servidor Syslog nuevo.
Ingresa los siguientes detalles:
- Nombre: Ingresa un nombre único para el servidor syslog, por ejemplo, Google SecOps Syslog.
- Dirección IP: Ingresa la dirección IP de Bindplane.
- Puerto: Ingresa el número de puerto de Bindplane (por lo general, 514 para UDP).
- Logging Facility: Selecciona local 6 (de uso frecuente para dispositivos de red).
- Nivel de registro: Selecciona Informativo para capturar registros de información.
- Formato: Selecciona el formato bsd-standard (este es el formato syslog predeterminado que usan los controladores de Aruba).
Haz clic en Enviar para guardar la configuración.
Haz clic en Cambios pendientes.
Haz clic en Deploy Changes para aplicar la nueva configuración del servidor syslog.

Nota: Después de implementar los cambios, configura el nivel de registro para categorías específicas de registros.
Ve a la configuración de Nivel de registro y establece el Nivel de registro en Informativo para cada una de las siguientes categorías:
- Red
- Todos
- Clúster
- DHCP
- PJ
- Movilidad
- Packet-Dump
- SDN

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
`Additional Info`	`read_only_udm.security_result.description`	El valor de `Additional Info` del registro sin procesar se asigna al campo `security_result.description` del UDM.
`AP`	`read_only_udm.target.hostname`	Cuando está presente en el registro sin procesar, se extrae el valor después de `AP:` y se asigna al campo `target.hostname` del UDM.
`BSSID`	`read_only_udm.target.mac`, `read_only_udm.principal.resource.name` (cuando el tipo de recurso es BSSID)	El valor del BSSID del registro sin procesar se asigna a `target.mac`. También se usa como nombre del recurso cuando `principal.resource.type` es `BSSID`.
`COMMAND`	`read_only_udm.principal.process.command_line`	El valor del comando del registro sin procesar se asigna al campo `principal.process.command_line` del UDM.
`Dst-MAC`	`read_only_udm.target.mac`	Cuando está presente, el valor de Dst-MAC del registro sin procesar se asigna al campo `target.mac` del UDM.
`SERVER`	`read_only_udm.target.hostname`	Cuando está presente, el nombre del servidor del registro sin procesar se asigna al campo `target.hostname` del UDM.
`SERVER-IP`	`read_only_udm.target.ip`	Cuando está presente, la IP del servidor del registro sin procesar se asigna al campo `target.ip` del UDM.
`Src-MAC`	`read_only_udm.principal.mac`	Cuando está presente, el valor de Src-MAC del registro sin procesar se asigna al campo `principal.mac` del UDM.
`SSID`	`read_only_udm.target.resource.name` (cuando el tipo de recurso es SSID)	El valor del SSID del registro sin procesar se usa como nombre del recurso cuando `target.resource.type` es `SSID`.
`USER`	`read_only_udm.target.user.userid`	Cuando está presente, el ID de usuario del registro sin procesar se asigna al campo `target.user.userid` del UDM.
`USERIP`	`read_only_udm.principal.ip`, `read_only_udm.observer.ip`	Cuando está presente, la IP del usuario del registro sin procesar se asigna a los campos `principal.ip` y `observer.ip` del UDM.
`USERMAC`	`read_only_udm.principal.mac`	Cuando está presente, la dirección MAC del usuario del registro sin procesar se asigna al campo `principal.mac` del UDM.
`USERNAME`	`read_only_udm.principal.user.userid`	Cuando está presente, el nombre de usuario del registro sin procesar se asigna al campo `principal.user.userid` del UDM.
`action`	`read_only_udm.security_result.action`	El valor de la acción del registro sin procesar (p.ej., `permit`, `deny`) se asigna al campo `security_result.action` del UDM.
`apname`	`read_only_udm.target.hostname`	Cuando está presente, el nombre del AP del registro sin procesar se asigna al campo `target.hostname` del UDM.
`bssid`	`read_only_udm.target.mac`	Cuando está presente, el valor del BSSID del registro sin procesar se asigna al campo `target.mac` del UDM.
`collection_time.seconds`	`read_only_udm.metadata.event_timestamp.seconds`	El valor de segundos de la hora de recopilación del registro sin procesar se asigna al campo `metadata.event_timestamp.seconds` del UDM.
`device_ip`	`read_only_udm.intermediary.ip`	La IP del dispositivo del registro sin procesar o de `logstash` se asigna al campo `intermediary.ip` del UDM.
`dstip`	`read_only_udm.target.ip`	Cuando está presente, la IP de destino del registro sin procesar se asigna al campo `target.ip` del UDM.
`dstport`	`read_only_udm.target.port`	Cuando está presente, el puerto de destino del registro sin procesar se asigna al campo `target.port` del UDM.
`event_id`	`read_only_udm.metadata.product_event_type`	El ID del evento del registro sin procesar se usa para construir el campo `metadata.product_event_type` en el UDM, con el prefijo `Event ID:`.
`event_message`	`read_only_udm.security_result.summary`	El mensaje del evento del registro sin procesar se asigna al campo `security_result.summary` del UDM.
`log.source.address`	`read_only_udm.observer.ip`	La dirección de la fuente del archivo de registro se asigna al campo `observer.ip` del UDM.
`log_type`	`read_only_udm.metadata.log_type`	El tipo de registro del registro sin procesar se asigna al campo `metadata.log_type` del UDM.
`logstash.collect.host`	`read_only_udm.observer.ip` o `read_only_udm.observer.hostname`	El host de recopilación de Logstash se asigna a `observer.ip` si es una dirección IP o a `observer.hostname` si es un nombre de host.
`logstash.ingest.host`	`read_only_udm.intermediary.hostname`	El host de transferencia de Logstash se asigna al campo `intermediary.hostname` del UDM.
`logstash.process.host`	`read_only_udm.intermediary.hostname`	El host del proceso de Logstash se asigna al campo `intermediary.hostname` del UDM.
`program`	`read_only_udm.target.application`	El nombre del programa del registro sin procesar se asigna al campo `target.application` del UDM.
`serverip`	`read_only_udm.target.ip`	Cuando está presente, la IP del servidor del registro sin procesar se asigna al campo `target.ip` del UDM.
`servername`	`read_only_udm.target.hostname`	Cuando está presente, el nombre del servidor del registro sin procesar se asigna al campo `target.hostname` del UDM.
`srcip`	`read_only_udm.principal.ip`	Cuando está presente, la IP de origen del registro sin procesar se asigna al campo `principal.ip` del UDM.
`srcport`	`read_only_udm.principal.port`	Cuando está presente, el puerto de origen del registro sin procesar se asigna al campo `principal.port` del UDM.
`syslog_host`	`read_only_udm.intermediary.hostname`	El host de syslog del registro sin procesar se asigna al campo `intermediary.hostname` del UDM.
`timestamp`	`read_only_udm.metadata.event_timestamp`	La marca de tiempo del registro sin procesar se analiza y se asigna al campo `metadata.event_timestamp` del UDM.
`userip`	`read_only_udm.principal.ip`, `read_only_udm.observer.ip`	Cuando está presente, la IP del usuario del registro sin procesar se asigna a los campos `principal.ip` y `observer.ip` del UDM.
`usermac`	`read_only_udm.principal.mac`	Cuando está presente, la dirección MAC del usuario del registro sin procesar se asigna al campo `principal.mac` del UDM.
`username`	`read_only_udm.principal.user.userid`	Cuando está presente, el nombre de usuario del registro sin procesar se asigna al campo `principal.user.userid` del UDM. Se deriva de `event_id` y la lógica dentro del analizador. El analizador lo determina según el ID del evento y el contenido del mensaje de registro. Se codificó como `Wireless`. Se codificó como `Aruba`. El analizador lo determina según el ID del evento y el contenido del mensaje de registro. El analizador lo determina según el ID del evento y el contenido del mensaje de registro. Se extrae del mensaje de registro sin procesar con una regex. El analizador lo determina según el ID del evento y el contenido del mensaje de registro. Se agrega un objeto vacío cuando event_type es USER_LOGIN o un evento de autenticación relacionado. El analizador lo determina en función del protocolo de red que se usa en el evento (p.ej., TCP, UDP, ICMP, IGMP). Contiene campos adicionales extraídos del registro sin procesar según condiciones específicas. Por ejemplo, el `ap_name` se agrega como un par clave-valor cuando está presente. Se establece en `BSSID` cuando hay un BSSID presente en el contexto de la principal. Se establece en `SSID` cuando hay un SSID presente en el contexto del objetivo. Contiene pares clave-valor de información de detección pertinente extraída del registro sin procesar, como el BSSID o el SSID.
`event_code`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`function_name`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`thread_id`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`station_macaddress`	`event.idm.read_only_udm.principal.mac`	Se asignó desde el registro de cambios
`station_macaddress`	`event.idm.read_only_udm.principal.asset.mac`	Se asignó desde el registro de cambios
`event_details`	`event.idm.read_only_udm.security_result.summary`	Se asignó desde el registro de cambios
`application`	`event.idm.read_only_udm.principal.application`	Se asignó desde el registro de cambios
`version`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`priority`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`module`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`instance`	`event.idm.read_only_udm.additional.fields`	Se asignó desde el registro de cambios
`role`	`event.idm.read_only_udm.principal.user.attribute.roles.name`	Se asignó desde el registro de cambios
`policy`	`event.idm.read_only_udm.security_result.rule_name`	Se asignó desde el registro de cambios
`command_status`	`event.idm.read_only_udm.target.resource.attribute.labels`	Se asignó desde el registro de cambios
`p_host`	`event.idm.read_only_udm.principal.ip`	Se asignó desde el registro de cambios
`p_host`	`event.idm.read_only_udm.principal.asset.ip`	Se asignó desde el registro de cambios
`p_host`	`event.idm.read_only_udm.principal.hostname`	Se asignó desde el registro de cambios
`p_host`	`event.idm.read_only_udm.principal.asset.hostname`	Se asignó desde el registro de cambios
`t_user`	`event.idm.read_only_udm.target.user.userid`	Se asignó desde el registro de cambios
`p_ip`	`event.idm.read_only_udm.principal.ip`	Se asignó desde el registro de cambios
`p_ip`	`event.idm.read_only_udm.principal.asset.ip`	Se asignó desde el registro de cambios
`cmd`	`event.idm.read_only_udm.target.process.command_line`	Se asignó desde el registro de cambios
`node`	`event.idm.read_only_udm.target.resource.name`	Se asignó desde el registro de cambios
`principal_ip_value`	`event.idm.read_only_udm.principal.ip`	Se asignó desde el registro de cambios
`p_port`	`event.idm.read_only_udm.principal.port`	Se asignó desde el registro de cambios
`t_hostname`	`event.idm.read_only_udm.intermediary.hostname`	Se asignó desde el registro de cambios
`details`	`metadata.description`	Se asignó desde el registro de cambios
`ap_name`	`additional.fields`	Se asignó desde el registro de cambios
`logstash.irm_site", "logstash.irm_environment", "logstash.irm_region`	`additional.fields`	Se asignó desde el registro de cambios

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.