Cómo autentica Bitwifi
Todas las integraciones siguen el mismo patrón: el equipo envía al huésped al portal, el huésped se registra y Bitwifi le dice al equipo que lo deje navegar. Lo que cambia entre fabricantes es cómo se lo dice.
Los tres métodos
| Método | Equipos | Cómo funciona |
|---|---|---|
| RADIUS | MikroTik, FortiGate, FortiAP Cloud, Aruba Instant On, Aruba Central, Teltonika, Grandstream, Cisco Meraki, TP-Link Omada, Zyxel Nebula, Ruckus, Extreme WiNG, Huawei eKit | El portal registra al huésped en el RADIUS de Bitwifi y envía el login al equipo. El equipo consulta el RADIUS y abre la conexión. |
| API del fabricante | UniFi | Bitwifi autoriza al huésped directamente en el controlador UniFi. |
| URL firmada | Juniper Mist | Bitwifi firma una URL de autorización con el secret de la WLAN y la nube de Mist abre la conexión. |
El RADIUS de Bitwifi
- Usuario y contraseña: la MAC del dispositivo del huésped, en minúsculas y con
:(por ejemploaa:bb:cc:dd:ee:ff). El huésped nunca los escribe: los envía el portal. - Autenticación: PAP.
- Session-Timeout: Bitwifi devuelve la duración de la sesión configurada en el sitio. El equipo desconecta al huésped al vencer.
- Accounting: recomendado. Bitwifi lo usa para saber quién está conectado.
- Una MAC sin registrar es rechazada. Por eso, al probar el RADIUS con una MAC cualquiera, la respuesta correcta es un rechazo: confirma que el servidor contesta. Un timeout indica un problema de red, puertos o secret.
Valores comunes
| Valor | Qué es | Dónde lo obtienes |
|---|---|---|
<PORTAL_HOST> | El host del portal de tu cuenta | Panel → Sitio → Access points |
| URL del portal | https://<PORTAL_HOST>/?site_id=<SITE_ID> | Panel → Sitio → Access points |
<SITE_ID> | El ID del sitio | Panel → Sitios |
<RADIUS_SERVER> | El servidor RADIUS de Bitwifi | Te lo entrega Bitwifi |
<SECRET> | El secret RADIUS | Te lo entrega Bitwifi. Nunca lo compartas por canales públicos. |
| Puertos RADIUS | Autenticación y accounting | Te los entrega Bitwifi. Las guías usan los estándar (1812 y 1813) como ejemplo. |
Si el equipo no permite parámetros en la URL del portal, Bitwifi identifica el sitio por la MAC del access point. En ese caso es obligatorio registrar todos los APs en Access points.
Antes de empezar con cualquier equipo
- Crea el sitio con el tipo de hardware correcto. Es la causa más común de "se registra pero no navega".
- Registra los equipos en Access points.
- Configura la walled garden.
- Haz la lista de pruebas con Android, iPhone y una laptop.