Ir al contenido principal

ArtinTech Solution

Routeros online sessions in Linkhive

La mayoría de proyectos PHP que hablan con MikroTik añaden un paquete. Para Linkhive, nuestra plataforma de facturación para ISP, escribimos en su lugar un pequeño cliente de la API de RouterOS en PHP, porque el protocolo es sencillo y cada llamada al router afecta al servicio de un cliente.

Palabras y frases

La API funciona sobre TCP en el puerto 8728, o con TLS en el 8729. Un comando es una frase formada por palabras, y cada palabra se envía precedida de su longitud. El router responde con frases que empiezan por !re para una fila, !trap para un error, !fatal cuando corta la conexión y !done al terminar.

Dos formas de iniciar sesión

Desde RouterOS 6.43 el inicio de sesión envía nombre y contraseña directamente. Las versiones antiguas responden con un desafío, así que el cliente admite ambas:

$done = $this->talk(['/login', '=name='.$username, '=password='.$password])['done'];

if (isset($done['ret'])) {
    $response = '00'.md5(chr(0).$password.hex2bin($done['ret']));
    $this->talk(['/login', '=name='.$username, '=response='.$response]);
}
Página En línea ahora de Linkhive con sesiones, cliente, paquete, IP, MAC, tiempo activo, router y tráfico
Sesiones leídas de /ppp/active y /ip/hotspot/active en cada router.

Mantén el driver idempotente

Sobre el cliente hay un driver con un único ayudante upsert: busca el registro por nombre, lo actualiza si existe y lo añade si no. Ejecutar dos veces el mismo cambio no hace daño, algo importante porque los cambios fallidos se reintentan. Un !trap se convierte en excepción, y la capa de aprovisionamiento la captura, la registra y marca la suscripción para reintentar.

Ideas clave

  • La API de RouterOS se puede implementar en unas doscientas líneas.
  • Admite ambos métodos de acceso si tus clientes tienen routers antiguos.
  • Convierte cada escritura en el router en un upsert para que los reintentos sean seguros.

Ten en cuenta que nuestro cliente no verifica el certificado TLS del router, porque suelen ser autofirmados. Considera TLS como cifrado en una red que controlas.

Míralo en la demo en vivo de Linkhive o consigue Linkhive en Vibe96. ¿Necesitas una integración a medida con MikroTik? Hablemos, o consulta nuestro desarrollo Laravel.

Share this article