Passer au contenu principal

ArtinTech Solution

Routeros online sessions in Linkhive

La plupart des projets PHP qui dialoguent avec MikroTik ajoutent un paquet. Pour Linkhive, notre plateforme de facturation pour FAI, nous avons plutôt écrit un petit client API RouterOS en PHP, car le protocole est simple et chaque appel au routeur touche le service d’un client.

Mots et phrases

L’API fonctionne sur TCP au port 8728, ou en TLS au port 8729. Une commande est une phrase composée de mots, chaque mot étant précédé de sa longueur. Le routeur répond par des phrases commençant par !re pour une ligne, !trap pour une erreur, !fatal quand il coupe la connexion et !done à la fin.

Deux façons de se connecter

Depuis RouterOS 6.43, la connexion envoie directement le nom et le mot de passe. Les versions plus anciennes répondent par un défi, le client gère donc les deux :

$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]);
}
Page En ligne maintenant de Linkhive avec sessions, client, forfait, IP, adresse MAC, durée, routeur et trafic
Sessions lues dans /ppp/active et /ip/hotspot/active sur chaque routeur.

Garder le pilote idempotent

Au-dessus du client se trouve un pilote avec une seule fonction upsert : chercher l’enregistrement par nom, le mettre à jour s’il existe, l’ajouter sinon. Exécuter deux fois le même changement ne pose donc aucun problème, ce qui compte car les échecs sont retentés. Un !trap devient une exception, que la couche de provisionnement capture, journalise, puis marque l’abonnement pour reprise.

À retenir

  • L’API RouterOS s’implémente en environ deux cents lignes.
  • Gérez les deux méthodes de connexion si vos clients ont d’anciens routeurs.
  • Faites de chaque écriture routeur un upsert pour sécuriser les reprises.

Notez que notre client ne vérifie pas le certificat TLS du routeur, car ils sont généralement auto-signés. Considérez TLS comme un chiffrement sur un réseau que vous contrôlez.

Voyez-le dans la démo en ligne de Linkhive ou obtenez Linkhive sur Vibe96. Besoin d’une intégration MikroTik sur mesure ? Parlons-en, ou découvrez notre développement Laravel.

Share this article