UniFi
En el panel, el sitio debe tener el tipo de hardware UniFi.
UniFi no usa RADIUS con Bitwifi: cuando el huésped completa el portal, Bitwifi lo autoriza directamente en tu UniFi por API, con el tiempo de sesión del sitio.
1. Elige cómo se conecta Bitwifi
| Método | Cuándo usarlo | Qué necesitas |
|---|---|---|
| UniFi Cloud (recomendado) | Consolas registradas en unifi.ui.com. Funciona aunque el controlador no tenga IP pública. | Una API key creada con la cuenta propietaria de la consola en unifi.ui.com → API. Requiere UniFi Network 9.1 o superior. |
| API key | Controlador local accesible desde internet. | URL del controlador y una API key creada en UniFi OS → Control Plane → API Keys. |
| Usuario y contraseña | Controladores antiguos sin API keys. Debe ser accesible desde internet. | URL del controlador, usuario y contraseña. |
Las claves y contraseñas se guardan cifradas. El panel nunca las vuelve a mostrar: para conservarlas al editar, deja el campo vacío.
2. Conecta el sitio en el panel
- Abre el sitio y pulsa Configurar controller UniFi.
- Elige el método, completa los datos y pulsa Conectar.
- Elige la consola (solo en Cloud) y el site de UniFi que corresponde a este sitio de Bitwifi.
- Marca los APs que pertenecen al sitio y pulsa Guardar configuración.
3. Configura el portal en UniFi Network
En el SSID de huéspedes, activa el portal de invitados con portal externo y apúntalo al portal de tu sitio (la URL está en Sitio → Access points). Agrega a los dominios permitidos antes de la autorización los mismos de la walled garden base.
Por completar
Falta documentar paso a paso la pantalla de UniFi Network (Hotspot Manager / Guest Portal) con capturas.
Diagnóstico
- "Error de conexión" al conectar: en API key o usuario y contraseña, el controlador no es accesible desde internet. Usa UniFi Cloud o publica el controlador.
- El huésped completa el portal pero no navega: revisa que el site de UniFi elegido sea el correcto y que la API key tenga permisos sobre esa consola.