Integrace RichPear Home

Cisco IOS

Cisco IOS přidává detekci přítomnosti podle ARP tabulky Cisco routeru. RichPear Home se k routeru přihlašuje přes SSH a vrací nalezené MAC adresy jako sledovaná zařízení.

Začít nastavení Zpět na integrace

Doména: cisco_ios
Kategorie: detekce přítomnosti
Komunikace: lokální dotazování
Nastavení: ruční konfigurace v YAML
Výstup: device tracker podle ARP tabulky

Co integrace přidá

Integrace čte přes SSH výstup příkazu show ip arp. Do stavu přítomnosti zahrnuje zařízení, která jsou v ARP tabulce vidět jako čerstvá položka.

Router musí mít povolené SSH a účet s oprávněním spustit příkaz terminal length 0 a show ip arp. Název zařízení se z routeru nepřebírá, proto počítejte s ručním pojmenováním podle MAC adres.

Výchozí ARP cache u Cisco IOS bývá dlouhá. Pro přesnější detekci přítomnosti je vhodné snížit ARP timeout na používaném VLAN rozhraní, například na 120 sekund.

Kontrolní témata

Vyžaduje Cisco IOS zařízení dostupné přes SSH.
Potřebuje IP adresu routeru, uživatelské jméno a heslo.
Volitelně lze nastavit nestandardní SSH port.
Nastavuje se ručně v konfiguraci RichPear Home.

Příprava před přidáním

Před přidáním si připravte IP adresu routeru, SSH port, uživatelské jméno a heslo administrátorského účtu. Ověřte, že se RichPear Home z dané sítě na router přes SSH dostane.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Změnu ARP timeoutu dělejte jen na rozhraní, kterému rozumíte. U velmi velkých VLAN upravte hodnotu podle velikosti sítě a provozních požadavků.

Nastavení v RichPear Home

Tato integrace se nastavuje ručně v konfiguraci. Doplňte položku do sekce device_tracker, restartujte RichPear Home a potom ověřte integraci v Nastavení → Zařízení a služby.

device_tracker:
  - platform: cisco_ios
    host: ROUTER_IP_ADDRESS
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

Pokud router nepoužívá výchozí SSH port, doplňte také port. Heslo může být prázdné jen v prostředí, kde je takové přihlášení na routeru vědomě povolené.

Pro snížení ARP timeoutu na rozhraní Vlan1 použijte na routeru obdobný postup:

show ip arp
conf t
interface Vlan1
arp timeout 120
copy running-config startup-config

Kontrola entit a funkcí

Po restartu otevřete detail integrace a kartu entit. Detekovaná zařízení se zobrazují podle MAC adres a jejich přítomnost závisí na tom, jestli je router aktuálně vidí v ARP tabulce.

Každou MAC adresu pojmenujte podle skutečného zařízení a propojte ji s osobou jen po ověření, že zařízení stabilně patří správnému uživateli.

Po nastavení

Zkontrolujte, že SSH přihlášení funguje i po restartu routeru.
Pojmenujte detekovaná zařízení podle MAC adres.
Ověřte příchod a odchod zařízení fyzickým připojením a odpojením od sítě.
Teprve potom stavy použijte pro automatizace přítomnosti.

Použití v automatizacích

Detekci používejte hlavně pro informativní přítomnost, režimy domácnosti a upozornění. Pro bezpečnostní nebo kritické akce přidejte další podmínku, například čas, stav alarmu nebo jiný senzor přítomnosti.

Po změně ARP timeoutu několik dní sledujte stabilitu, aby automatizace nereagovaly na krátké výpadky Wi‑Fi nebo spánkový režim telefonu.

Provoz a údržba

Po změně hesla, SSH portu, VLAN, ARP timeoutu nebo firmwaru routeru zkontrolujte konfiguraci, logy a stavy zařízení. Přítomnost se neobnoví správně, pokud RichPear Home nedokáže router přes SSH přečíst.

U telefonů a notebooků počítejte s tím, že úsporné režimy a roaming mezi přístupovými body mohou ovlivnit, kdy se zařízení v ARP tabulce objeví.

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte IP adresu routeru, SSH port, přihlašovací údaje, firewall mezi VLAN a syntaxi konfigurace. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény cisco_ios.

Pokud se zařízení tváří stále přítomné, zkontrolujte ARP timeout na správném VLAN rozhraní. Pokud se neobjevuje vůbec, ověřte přímo na routeru výstup show ip arp a přítomnost MAC adresy sledovaného zařízení.