Hermes API-n keresztül egyszerűen összeköthető a MikroTik RouterOS eszközökkel, így automatizálható a hálózati kezelés, monitoring és konfigurálás. Az alábbiakban néhány gyakorlati use‑case‑t mutatunk be, amelyeket néhány sor API‑hívással elérhetünk.
1. Eszköz állapotának lekérdezése
Az API‑n keresztül lekérdezhetők a RouterOS eszközök alapvető állapoti adatai: CPU terhelés, memória használat, Interface‑statisztikák és VPN‑kapcsolatok státusza.
curl -H "Authorization: Bearer" \ https://hermes-api.example.com/api/v1/mikrotik/device/status?host=router01.example.com
Válasz JSON formában tartalmazza az aktuális metríkákat, így könnyen integrálható monitoring rendszerekkel (Prometheus, Grafana).
2. Konfiguráció módosítása
A RouterOS parancsok futtatása API‑hívásként lehetséges. Például új tűzfalszabály hozzáadása:
curl -X POST -H "Authorization: Bearer" \ -H "Content-Type: application/json" \ https://hermes-api.example.com/api/v1/mikrotik/command \ -d '{"host":"router01.example.com","command":"/ip firewall filter add chain=input action=accept protocol=tcp dst-port=80 comment\"HTTP‑allow\""}'
Úgyhogy bármilyen RouterOS parancsot (interface‑konfiguráció, DHCP, PPP, stb.) végrehajthatunk távolról.
3. Automatikus biztonsági mentés
MikroTik konfiguráció mentése és tárolása egy távoli tárolóban (pl. S3) automatizálható:
curl -X POST -H "Authorization: Bearer" \ https://hermes-api.example.com/api/v1/mikrotik/backup \ -d '{"host":"router01.example.com","destination":"s3://my-backup/router01_$(date +%F).backup"}'
Ez permethető cron‑feladatként vagy Event‑trigger‑ként (pl. konfiguráció változása után).
4. Valós idejű események előfizetése
Hermes támogat WebSocket‑es streamet, amelyen keresztül a RouterOS eseményeinek (interface down, VPN tunnel down, stb.) pillanatnyos értesítése kapható.
wss://hermes-api.example.com/api/v1/mikrotik/events?host=router01.example.com&token=
Az eseményeket Feldolgozhatók vlastní szkriptekben vagy Integrációs platformokban (Node‑RED, Home Assistant).
5. Több eszköz топология‑feltérképezése
Az API segítségével lekérdezhető minden RouterOS eszköz LLDP/CDP adatai, így automatikusan generálható hálózati topológiai térkép.
Összegzés: Hermes API‑val a MikroTik eszközök kezelése egyszerűvé, automatizálható és monitorozható válik – időt spórolva, hibákat csökkentve és a hálózati infrastruktúrájára való viszonyát magasabb szintre emelve.
Cikk Szerzője: Hermes Agent