Zum Hauptinhalt springen

ArtinTech Solution

Routeros online sessions in Linkhive

Die meisten PHP-Projekte, die mit MikroTik sprechen, binden ein Paket ein. Für Linkhive, unsere ISP-Abrechnungsplattform, haben wir stattdessen einen kleinen RouterOS API PHP-Client geschrieben, denn das Protokoll ist einfach, und jeder Router-Aufruf betrifft den Dienst eines Kunden.

Wörter und Sätze

Die API läuft über TCP auf Port 8728 oder per TLS auf 8729. Ein Befehl ist ein Satz aus Wörtern, und jedes Wort wird mit vorangestellter Länge gesendet. Der Router antwortet mit Sätzen, die mit !re für eine Zeile, !trap für einen Fehler, !fatal beim Trennen der Verbindung und !done am Ende beginnen.

Zwei Wege zur Anmeldung

Seit RouterOS 6.43 sendet die Anmeldung Name und Passwort direkt. Ältere Versionen antworten mit einer Challenge, also beherrscht der Client beides:

$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]);
}
Linkhive-Seite Jetzt online mit Sitzungen, Kunde, Paket, IP, MAC-Adresse, Laufzeit, Router und Verkehr
Sitzungen aus /ppp/active und /ip/hotspot/active jedes Routers.

Den Treiber idempotent halten

Über dem Client sitzt ein Treiber mit einem upsert-Helfer: Datensatz per Name suchen, aktualisieren, wenn er existiert, sonst anlegen. Dieselbe Änderung zweimal auszuführen schadet also nicht, was wichtig ist, weil fehlgeschlagene Änderungen wiederholt werden. Ein !trap wird zur Ausnahme, die die Provisioning-Schicht abfängt, protokolliert und das Abonnement zur Wiederholung markiert.

Die wichtigsten Punkte

  • Die RouterOS-API lässt sich in etwa zweihundert Zeilen umsetzen.
  • Unterstützen Sie beide Anmeldeverfahren, wenn Kunden ältere Router nutzen.
  • Machen Sie jeden Router-Schreibvorgang zum Upsert, damit Wiederholungen sicher sind.

Hinweis: Unser Client prüft das TLS-Zertifikat des Routers nicht, weil Router meist selbst signierte Zertifikate haben. Verstehen Sie TLS als Verschlüsselung in einem Netz, das Sie kontrollieren.

Sehen Sie es in der Linkhive Live-Demo oder holen Sie sich Linkhive auf Vibe96. Brauchen Sie eine eigene MikroTik-Integration? Sprechen wir darüber, oder sehen Sie sich unsere Laravel-Entwicklung an.

Share this article