Recopila registros de Aruba Wireless Controller y Access Point

Versión del analizador: 12.0

Compatible con:

En este documento, se explica cómo transferir registros de Aruba Wireless Controller y Access Point a Google Security Operations con el agente de Bindplane.

Los controladores inalámbricos y los puntos de acceso 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 posterior, 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 del firewall estén abiertos según los requisitos del agente de Bindplane
  • Acceso con privilegios a un controlador inalámbrico de Aruba

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.
  1. Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
  2. Ve a IAM y administración > Cuentas de servicio.
  3. Haga clic en Crear cuenta de servicio.
  4. 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).
  5. Haz clic en Crear y continuar.
  6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
  7. Haz clic en Continuar y, luego, en Listo.
  8. Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
  9. Haz clic en Agregar clave > Crear clave nueva.
  10. Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
  11. Guarda el archivo de claves como ingestion-auth.json en el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.json en Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json en Windows) o actualiza creds_file_path en config.yaml para que coincida con la ruta de acceso en la que lo guardas.
  12. 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)

  1. Accede a la consola de Google SecOps.
  2. 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.
  3. Descarga el archivo de autenticación de transferencia.
  4. 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

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
  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 comando siguiente:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Espera a que se complete la instalación.

  4. 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

  1. Abre una terminal con privilegios de raíz o sudo.
  2. Ejecuta el comando siguiente:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Espera a que se complete la instalación.

  4. Ejecuta el siguiente comando para verificar la instalación:

    sudo systemctl status observiq-otel-collector
    

    El 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.yaml
    
  • Windows:

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

Edita el archivo de configuración

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

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/aruba_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: 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: Es la dirección IP y el 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 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
    • 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, europe o asia-southeast1). El exportador agrega el prefijo chronicle.googleapis.com con 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 como chronicle.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 exporters por lo siguiente. Establece creds_file_path en la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplaza malachiteingestion-pa.googleapis.com por tu extremo regional (por ejemplo, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/aruba_wireless:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: ARUBA_WIRELESS
        raw_log_field: body
    

Guarda el archivo de configuración

  • Después de editarlo, guarda el archivo:
    • Linux: Presiona Ctrl+O, luego Enter y, por último, 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

  1. Accede a la IU web del controlador de Aruba.
  2. Ve al menú superior y selecciona Configuración > Sistema.
  3. Selecciona Registro para abrir la página de configuración del registro.
  4. En la sección Servidores Syslog, haz clic en + Agregar para agregar un servidor Syslog nuevo.
  5. 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).
    • Función de registro: Selecciona local 6 (de uso frecuente para dispositivos de red).
    • Nivel de registro: Selecciona Informativo para capturar los registros de información.
    • Formato: Selecciona el formato bsd-standard (este es el formato de syslog predeterminado que usan los controladores de Aruba).
  6. Haz clic en Enviar para guardar la configuración.
  7. Haz clic en Cambios pendientes.
  8. Haz clic en Deploy Changes para aplicar la nueva configuración del Servidor Syslog.

  9. Ve a la configuración de Nivel de registro y establécelo en Informativo para cada una de las siguientes categorías:

    • Red
    • Todos
    • Clúster
    • DHCP
    • PJ
    • Movilidad
    • Volcado de paquetes
    • 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 de UDM security_result.description.
AP read_only_udm.target.hostname Cuando está presente en el registro sin procesar, el valor después de AP: se extrae y se asigna al campo de UDM target.hostname.
BSSID read_only_udm.target.mac, read_only_udm.principal.resource.name (cuando el tipo de recurso es BSSID) El valor de BSSID del registro sin procesar se asigna a target.mac. También se usa como el nombre del recurso cuando el 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 de UDM principal.process.command_line.
Dst-MAC read_only_udm.target.mac Cuando está presente, el valor Dst-MAC del registro sin procesar se asigna al campo de UDM target.mac.
SERVER read_only_udm.target.hostname Cuando está presente, el nombre del servidor del registro sin procesar se asigna al campo de UDM target.hostname.
SERVER-IP read_only_udm.target.ip Cuando está presente, la IP del servidor del registro sin procesar se asigna al campo de UDM target.ip.
Src-MAC read_only_udm.principal.mac Cuando está presente, el valor Src-MAC del registro sin procesar se asigna al campo de UDM principal.mac.
SSID read_only_udm.target.resource.name (cuando el tipo de recurso es SSID) El valor de SSID del registro sin procesar se usa como el nombre del recurso cuando el 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 de UDM target.user.userid.
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 de UDM principal.ip y observer.ip.
USERMAC read_only_udm.principal.mac Cuando está presente, la MAC del usuario del registro sin procesar se asigna al campo de UDM principal.mac.
USERNAME read_only_udm.principal.user.userid Cuando está presente, el nombre de usuario del registro sin procesar se asigna al campo de UDM principal.user.userid.
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 de UDM security_result.action.
apname read_only_udm.target.hostname Cuando está presente, el nombre del AP del registro sin procesar se asigna al campo de UDM target.hostname.
bssid read_only_udm.target.mac Cuando está presente, el valor de BSSID del registro sin procesar se asigna al campo de UDM target.mac.
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 de UDM metadata.event_timestamp.seconds.
device_ip read_only_udm.intermediary.ip La IP del dispositivo del registro sin procesar o de logstash se asigna al campo de UDM intermediary.ip.
dstip read_only_udm.target.ip Cuando está presente, la IP de destino del registro sin procesar se asigna al campo de UDM target.ip.
dstport read_only_udm.target.port Cuando está presente, el puerto de destino del registro sin procesar se asigna al campo de UDM target.port.
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 de evento del registro sin procesar se asigna al campo de UDM security_result.summary.
log.source.address read_only_udm.observer.ip La dirección de origen del registro se asigna al campo de UDM observer.ip.
log_type read_only_udm.metadata.log_type El tipo de registro del registro sin procesar se asigna al campo de UDM metadata.log_type.
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 de UDM intermediary.hostname.
logstash.process.host read_only_udm.intermediary.hostname El host del proceso de Logstash se asigna al campo de UDM intermediary.hostname.
program read_only_udm.target.application El nombre del programa del registro sin procesar se asigna al campo de UDM target.application.
serverip read_only_udm.target.ip Cuando está presente, la IP del servidor del registro sin procesar se asigna al campo de UDM target.ip.
servername read_only_udm.target.hostname Cuando está presente, el nombre del servidor del registro sin procesar se asigna al campo de UDM target.hostname.
srcip read_only_udm.principal.ip Cuando está presente, la IP de origen del registro sin procesar se asigna al campo de UDM principal.ip.
srcport read_only_udm.principal.port Cuando está presente, el puerto de origen del registro sin procesar se asigna al campo de UDM principal.port.
syslog_host read_only_udm.intermediary.hostname El host de syslog del registro sin procesar se asigna al campo de UDM intermediary.hostname.
timestamp read_only_udm.metadata.event_timestamp La marca de tiempo del registro sin procesar se analiza y se asigna al campo de UDM metadata.event_timestamp.
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 de UDM principal.ip y observer.ip.
usermac read_only_udm.principal.mac Cuando está presente, la MAC del usuario del registro sin procesar se asigna al campo de UDM principal.mac.
username read_only_udm.principal.user.userid Cuando está presente, el nombre de usuario del registro sin procesar se asigna al campo de UDM principal.user.userid. Se deriva de event_id y la lógica dentro del analizador. Lo determina el analizador en función del ID del evento y el contenido del mensaje de registro. Codificado como Wireless. Codificado como Aruba. Lo determina el analizador en función del ID del evento y el contenido del mensaje de registro. Lo determina el analizador en función del ID del evento y el contenido del mensaje de registro. Se extrae del mensaje de registro sin procesar con regex. Lo determina el analizador en función del ID del evento y el contenido del mensaje de registro. Se agrega un objeto vacío cuando el event_type es USER_LOGIN o un evento de autenticación relacionado. Lo determina el analizador en función del protocolo de red que se usa en el evento (p.ej., TCP, UDP, ICMP o 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 destino. Contiene pares clave-valor de información de detección relevante extraída del registro sin procesar, como BSSID o SSID.
event_code event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
function_name event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
thread_id event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
station_macaddress event.idm.read_only_udm.principal.mac Asignado desde el registro de cambios
station_macaddress event.idm.read_only_udm.principal.asset.mac Asignado desde el registro de cambios
event_details event.idm.read_only_udm.security_result.summary Asignado desde el registro de cambios
application event.idm.read_only_udm.principal.application Asignado desde el registro de cambios
version event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
priority event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
module event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
instance event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
role event.idm.read_only_udm.principal.user.attribute.roles.name Asignado desde el registro de cambios
policy event.idm.read_only_udm.security_result.rule_name Asignado desde el registro de cambios
command_status event.idm.read_only_udm.target.resource.attribute.labels Asignado desde el registro de cambios
p_host event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
p_host event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
p_host event.idm.read_only_udm.principal.hostname Asignado desde el registro de cambios
p_host event.idm.read_only_udm.principal.asset.hostname Asignado desde el registro de cambios
t_user event.idm.read_only_udm.target.user.userid Asignado desde el registro de cambios
p_ip event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
p_ip event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
cmd event.idm.read_only_udm.target.process.command_line Asignado desde el registro de cambios
node event.idm.read_only_udm.target.resource.name Asignado desde el registro de cambios
principal_ip_value event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
p_port event.idm.read_only_udm.principal.port Asignado desde el registro de cambios
t_hostname event.idm.read_only_udm.intermediary.hostname Asignado desde el registro de cambios
details metadata.description Asignado desde el registro de cambios
ap_name additional.fields Asignado desde el registro de cambios
logstash.irm_site", "logstash.irm_environment", "logstash.irm_region additional.fields Asignado 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.