DocumentaciónDespliegue

Integración UniFi

Las puertas de enlace UniFi (UDM, UDM Pro, UDM SE, USG, UCKP) pueden enviar datos de red a FlowPro NG a través de dos canales — Syslog para logs de eventos y NetFlow para el análisis de flujos de tráfico. No se necesitan cambios en FlowPro — ambos colectores están listos para recibir datos.

Fuente de datos	Protocolo / Puerto	Datos en FlowPro
Syslog	UDP 514	Logs de firewall, DHCP, VPN, eventos de autenticación, alertas IDS/IPS
NetFlow	UDP 12051	Flujos de tráfico de red — IP de origen/destino, puertos, protocolos, volúmenes de datos

Para máxima visibilidad, active tanto Syslog como NetFlow. Syslog proporciona eventos de seguridad y decisiones del firewall, mientras que NetFlow proporciona un análisis completo de flujos de tráfico con detección de anomalías.

UniFi OS (UDM, UDM Pro, UDM SE)

Abra la configuración de UniFi Network

En la aplicación UniFi Network, vaya a Configuración → Sistema → Avanzado.

Active el Syslog remoto

•Active "Servidor Syslog remoto"
•Syslog Host: YOUR_FLOWPRO_IP
•Puerto: 514
•Nivel de log: Normal (o Detallado para más detalles)

Active el registro IDS/IPS (opcional)

Vaya a Configuración → Seguridad → Gestión de amenazas. Active el modo IDS o IPS. Las alertas se reenviarán automáticamente a través de syslog.

USG / UCKP heredado

Abra el controlador UniFi clásico

Vaya a Configuración → Sitio → Registro remoto en el controlador UniFi.

Configure el destino del syslog

•Active "Servidor Syslog remoto"
•Syslog Host: YOUR_FLOWPRO_IP
•Puerto: 514

Verificación

bash

# Check incoming syslog from UniFi
tail -f /var/log/syslog | grep -i unifi

# Or check Logstash pipeline
curl -sk https://localhost:9200/logs-*/_count?q=host.ip:UNIFI_IP

Los datos de syslog aparecerán en Log Explorer en segundos.

Reemplace YOUR_FLOWPRO_IP con la dirección IP real de su servidor FlowPro NG.

UniFi OS (UDM, UDM Pro, UDM SE)

Activar vía SSH

Conéctese por SSH a su puerta de enlace UniFi (habilite SSH en Configuración de UniFi OS → Configuración de consola → SSH). La exportación NetFlow no está disponible en la interfaz — debe configurarse vía CLI.

Configurar la exportación NetFlow

bash

# On UDM / UDM Pro / UDM SE via SSH:
set protocols netflow version 5
set protocols netflow server YOUR_FLOWPRO_IP port 12051
set protocols netflow engine-id 1
set protocols netflow enable-egress all
set protocols netflow timeout expiry-interval 60
commit

En dispositivos UDM, esta configuración puede restablecerse después de actualizaciones de firmware. Para persistirla, utilice el método de script on_boot.d (consulte la sección Persistencia abajo).

USG heredado

Configurar vía controlador UniFi

En dispositivos USG, NetFlow se configura a través de config.gateway.json en el controlador. Cree o edite el archivo:

bash

# On UniFi Controller:
cat > /srv/unifi/data/sites/default/config.gateway.json << 'EOF'
{
  "system": {
    "flow-accounting": {
      "netflow": {
        "version": "5",
        "server": {
          "YOUR_FLOWPRO_IP": {
            "port": "12051"
          }
        },
        "timeout": {
          "expiry-interval": "60"
        },
        "engine-id": "1"
      },
      "ingress-capture": "post-dnat",
      "interface": {
        "eth0": ""
      }
    }
  }
}
EOF

# Force re-provision the USG from the controller

Después de guardar config.gateway.json, fuerce el aprovisionamiento del USG: Dispositivos → USG → Configuración (icono de engranaje) → Administrar → Forzar aprovisionamiento. La configuración persiste entre reinicios.

Verificación

bash

# Check incoming NetFlow data
journalctl -u nfacctd-flowpro-datasource1 -n 20 --no-pager

Los datos de NetFlow aparecerán en Flow Collector → pestaña Flujos en un minuto.