Integrace RichPear Home

Jabber (XMPP)

Jabber (XMPP) posílá oznámení na XMPP účet nebo do místnosti. Používá se tam, kde je potřeba nezávislý notifikační kanál mimo běžné mobilní push zprávy.

Doména
xmpp
Kategorie
oznámení
Komunikace
cloud-push
Kvalita
legacy
01

Připravte přístup a síť

Před přidáním integrace si připravte účet, IP adresu, token, párovací režim nebo API klíč podle typu zařízení. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home.

U této integrace počítejte hlavně s: lokální komunikaci nebo lokální zjišťování zařízení, cloudový účet, token nebo API přístup, třídu komunikace cloud-push.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

02

Přidejte integraci v RichPear Home

Otevřete Konfigurační soubory a následná kontrola v Nastavení → Zařízení a služby, vyhledejte Jabber (XMPP) a projděte průvodce nastavením.

Dokumentace integrace zmiňuje YAML nebo ruční konfiguraci. V RichPear Home proto počítejte s kontrolou konfigurace a restartem služby, pokud průvodce není dostupný.

Pokud integrace vyžaduje cloudový účet, používejte samostatný servisní účet, kde to dává smysl. U zařízení v domácí síti nejdřív ověřte pevnou IP adresu nebo spolehlivé mDNS jméno.
03

Zkontrolujte entity, funkce a akce

Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity a přiřaďte je do správných oblastí.

Pokud integrace vytvoří akce nebo služby, otestujte je nejdřív ručně a teprve potom je použijte v automatizaci.

10

Účet a příjemci

Připravte Jabber ID odesílatele, heslo, resource a výchozí příjemce. Příjemcem může být jeden JID, více JID nebo chatovací místnost.

Pro produkční oznámení používejte samostatný servisní účet. Osobní účet správce není vhodný pro dlouhodobý provoz klientské instalace.

11

Konfigurace

Notifikace se nastavují v konfiguraci. Volitelný název vytvoří samostatnou akci notify.<nazev>, což je užitečné, pokud máte více notifikačních kanálů.

Vynucení TLS ponechte zapnuté, pokud server podporuje moderní zabezpečení. Vypnutí kontroly certifikátu používejte jen u řízených interních serverů.

12

Odesílání zpráv

Do zpráv dávejte krátký název, jasný text a jen potřebné přílohy nebo odkazy. XMPP kanál je vhodný pro technická upozornění, stav serveru nebo servisní zprávy.

Pokud posíláte zprávy do místnosti, počítejte s tím, že je uvidí všichni členové. Citlivé údaje posílejte jen na konkrétní cíle.

13

Údržba

Po změně hesla nebo certifikátu serveru otestujte odeslání zprávy ručně. Chyby TLS a autentizace se často projeví až při prvním ostrém upozornění.

Při více notifikátorech udržujte názvy konzistentní, aby automatizace posílaly zprávy do správného kanálu.