Skip to main content

ArtinTech Solution

Routeros online sessions in Linkhive

De fleste PHP-projekter, der taler med MikroTik, henter en pakke. Til Linkhive, vores ISP-faktureringsplatform, skrev vi i stedet en lille RouterOS API PHP-klient, fordi protokollen er enkel, og hvert routerkald påvirker en kundes tjeneste.

Ord og sætninger

API’et kører over TCP på port 8728 eller TLS på 8729. En kommando er en sætning af ord, og hvert ord sendes med sin længde foran. Routeren svarer med sætninger, der starter med !re for en række, !trap for en fejl, !fatal, når den afbryder forbindelsen, og !done, når den er færdig.

To måder at logge ind på

Siden RouterOS 6.43 sender login navn og adgangskode direkte. Ældre versioner svarer med en challenge, så klienten håndterer begge:

$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-siden Online nu med sessioner, kunde, pakke, IP, MAC-adresse, oppetid, router og trafik
Sessioner læst fra /ppp/active og /ip/hotspot/active på hver router.

Hold driveren idempotent

Oven på klienten ligger en driver med én upsert-hjælper: slå posten op efter navn, opdatér den, hvis den findes, og tilføj den ellers. Samme ændring kan derfor køre to gange uden skade, hvilket betyder noget, fordi mislykkede ændringer forsøges igen. En !trap bliver til en undtagelse, og provisioneringslaget fanger den, logger den og markerer abonnementet til nyt forsøg.

Vigtigste pointer

  • RouterOS API er enkelt nok til at blive implementeret på omkring to hundrede linjer.
  • Understøt begge loginmetoder, hvis dine kunder har ældre routere.
  • Gør hver routerskrivning til en upsert, så genforsøg er sikre.

Bemærk, at vores klient ikke verificerer routerens TLS-certifikat, fordi routere normalt har selvsignerede certifikater. Se TLS som kryptering på et netværk, du selv kontrollerer.

Se det i Linkhive live-demoen, eller køb Linkhive på Vibe96. Har du brug for en særlig MikroTik-integration? Lad os tale sammen, eller se vores Laravel-udvikling.

Del denne artikel