MikroTik (Hotspot + RADIUS)
En el panel, el sitio debe tener el tipo de hardware MikroTik (RADIUS).
El hotspot de RouterOS muestra unas páginas de login (login.html, alogin.html, rlogin.html, flogin.html) que Bitwifi genera para tu sitio. Esas páginas llevan al huésped al portal y, al terminar, hacen el login en el router con la MAC del dispositivo. El router valida ese login contra el RADIUS de Bitwifi.
Requisitos
- RouterOS 7.x. Si el equipo tiene 6.x, actualízalo antes de seguir. Para ver la versión:
/system resource print. - Salida a internet desde el router.
- El equipo registrado en Sitio → Access points con la MAC del router.
Valores que necesitas
| Valor | Qué es |
|---|---|
<SITE_ID> | El ID del sitio en el panel |
<RADIUS_SERVER> | Servidor RADIUS de Bitwifi |
<SECRET> | Secret RADIUS del sitio |
<INTERFAZ> | Interfaz o bridge de la red de huéspedes |
<GW> | IP del router en la red de huéspedes |
1. Identidad del router
El nombre del router debe coincidir exactamente con el site_id:
/system identity set name="<SITE_ID>"
2. RADIUS
/radius add service=hotspot address=<RADIUS_SERVER> secret="<SECRET>" \
authentication-port=11812 accounting-port=11813 timeout=3s
/radius incoming set accept=yes port=3799
En RouterOS 7.15 o superior, desactiva el requisito de Message-Authenticator:
/radius set [find address=<RADIUS_SERVER>] require-message-auth=no
3. Perfil del hotspot
Crea o ajusta el perfil del hotspot de la red de huéspedes con estos valores:
| Parámetro | Valor |
|---|---|
hotspot-address | <GW> |
use-radius | yes |
radius-accounting | yes |
radius-interim-update | 5m |
nas-port-type | wireless-802.11 |
http-cookie-lifetime | 1d |
/ip hotspot profile add name=bitwifi-profile hotspot-address=<GW> \
use-radius=yes radius-accounting=yes radius-interim-update=5m \
nas-port-type=wireless-802.11 http-cookie-lifetime=1d
/ip hotspot add name=hotspot-bitwifi interface=<INTERFAZ> profile=bitwifi-profile disabled=no
Opcional, pero recomendado: anuncia el portal por DHCP (opción 114) para que los teléfonos lo detecten antes.
4. Walled garden
Permite los dominios del portal antes del login. El panel te muestra la lista exacta para tu sitio; la base es:
/ip hotspot walled-garden
add dst-host=<PORTAL_HOST>
add dst-host=<API_HOST>
add dst-host=assets.bitwifiapp.com
add dst-host=cdnjs.cloudflare.com
add dst-host=fonts.googleapis.com
add dst-host=fonts.gstatic.com
Si el portal usa redes sociales, revisa Walled garden.
5. Páginas de login
En Sitio → Access points, junto al router, usa Descargar .rsc o copia los comandos. Son cuatro /tool fetch que bajan las páginas de tu sitio a la carpeta hotspot/ del router. Ejecútalos en la terminal del MikroTik.
Comprueba que se descargaron:
/file print where name~"login"
Cada archivo debe pesar más de 1 KB. Si pesan alrededor de 1,4 KB, son las páginas por defecto de MikroTik y la descarga falló.
Si cambias el diseño del portal no hace falta volver a descargar las páginas: solo llevan al huésped al portal. Vuelve a descargarlas solo si cambias el site_id o si soporte te lo pide.
6. Diagnóstico
| Qué revisar | Comando |
|---|---|
| Huéspedes autenticados | /ip hotspot active print |
| Estado del RADIUS (no debe haber muchos timeouts) | /radius monitor 0 once |
| Últimos mensajes de RADIUS | /log print where topics~"radius" |
| Conexión al servidor | /ping <RADIUS_SERVER> count=4 |