Conectar MikroTik con Boris

MikroTik es la opción barata y muy extendida en coworkings pequeños. También es la única integración de Boris que habla con un equipo tuyo y no con la nube de un fabricante, y eso cambia los requisitos.

Antes de empezar: dos requisitos duros

1. RouterOS 7.1 o superior. La API REST no existe en la v6; esos equipos usan un protocolo binario en el puerto 8728 que esta integración no implementa. Si estás en v6, la vía es actualizar.
2. El router tiene que ser accesible desde el servidor de Boris. Lo correcto es una VPN entre el servidor y el router. Publicar la administración del router en internet abierto es una mala idea, con o sin Boris.

1. Preparar RouterOS

1. Habilitá el servicio www-ssl en IP → Services (HTTPS, no www a secas: la autenticación básica manda la contraseña en cada llamada).
2. Creá un usuario dedicado para Boris con permisos de api, read y write. No uses admin.
3. Tené el hotspot ya funcionando: servidor de hotspot, pool de direcciones y al menos un user profile.

2. Configurar en Boris

• Router URL: https://ip-o-dominio.
• Usuario y contraseña de RouterOS.
• Perfil de usuario del hotspot: el perfil que define velocidad y dispositivos simultáneos para invitados. Vacío = default.
• Aceptar el certificado autofirmado: casi siempre necesario, porque RouterOS genera su propio certificado. Actívalo solo si el router está en una red de confianza (VPN), nunca sobre internet abierto.

Guardá → Probar conexión (Boris lee la identidad del router) → Importar redes: se importan tus servidores de hotspot.

Qué hace Boris dentro de RouterOS

• Crea el usuario con PUT /rest/ip/hotspot/user — en RouterOS PUT añade y POST ejecuta comandos de consola.
• Le pone limit-uptime con la duración de la reserva y un comentario «Boris · BK-123» para que sepas de dónde salió.
• Al revocar, borra el usuario con DELETE /rest/ip/hotspot/user/{id}.
• Las sesiones activas se leen de /rest/ip/hotspot/active.

El detalle que importa: uptime no es hora de reloj

RouterOS cuenta limit-uptime desde el primer login, no desde el momento en que se crea el usuario. Un invitado que se conecta dos horas tarde sigue teniendo sus horas completas. Por eso Boris además borra la credencial cuando la ventana de la reserva se cierra: entre las dos cosas, el acceso no sobrevive a la reserva.

Cosas a tener en cuenta

• Todos los valores viajan como texto en la API de RouterOS, incluidos números y booleanos. Si escribís scripts propios contra el mismo router, tenelo en cuenta.
• Si el router se reinicia sin guardar configuración, los usuarios creados se pierden. Boris los volverá a crear en el siguiente reintento del cron.
• Los límites de velocidad y de dispositivos se definen en el user profile de RouterOS, no en Boris.