メインコンテンツにスキップ

ArtinTech Solution

Routeros online sessions in Linkhive

MikroTikと通信するPHPプロジェクトの多くはパッケージを導入します。ISP課金基盤Linkhiveでは、プロトコルが単純で、ルーターへの呼び出しが顧客のサービスに直結するため、小さなRouterOS API PHPクライアントを自作しました。

ワードとセンテンス

APIはTCPのポート8728、またはTLSの8729で動きます。コマンドはワードからなるセンテンスで、各ワードは長さを先頭に付けて送ります。ルーターの応答は、行を示す!re、エラーの!trap、接続を切る!fatal、完了の!doneで始まります。

2つのログイン方法

RouterOS 6.43以降のログインは名前とパスワードを直接送ります。古いバージョンはチャレンジを返すため、クライアントは両方に対応します。

$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のオンライン画面。セッション、顧客、パッケージ、IP、MACアドレス、接続時間、ルーター、通信量を表示
各ルーターの /ppp/active と /ip/hotspot/active から読み取ったセッション。

ドライバーを冪等に保つ

クライアントの上にはupsertヘルパーを持つドライバーがあります。名前でレコードを探し、あれば更新し、なければ追加します。同じ変更を2回実行しても害はなく、失敗した変更が再試行される以上これは重要です。!trapは例外になり、プロビジョニング層がそれを捕捉して記録し、契約を再試行対象にします。

要点

  • RouterOS APIは約200行で実装できる。
  • 顧客が古いルーターを使うなら、両方のログイン方式に対応する。
  • ルーターへの書き込みをすべてupsertにして、再試行を安全にする。

なお、このクライアントはルーターのTLS証明書を検証しません。ルーターの証明書は通常自己署名だからです。TLSは管理下のネットワークでの暗号化として扱ってください。

Linkhiveのライブデモで確認できます。Vibe96でLinkhiveを入手することもできます。独自のMikroTik連携が必要ならご相談ください。Laravel開発サービスもご覧ください。

Share this article