InnerWeb
Přejít na obsah

Webhook alarmový v síti bez odchozího provozu

Provozovna on-premise, jejíž firewall blokuje veškerý odchozí provoz z hostitele aplikace, nemusí otevírat žádný port, aby se alarm dostal k pohotovostnímu pracovníkovi. Stačí otočit směr spojení: aplikace zapíše webhook do tabulky a externí poller si záznamy sám vyzvedne příchozím kanálem. Následuje postup nasazení krok za krokem, s hranicemi, které je nutné znát před startem.

89
záznamů v jednom balíku pollera
Zdroj: karta
300 s
po této době se rezervace vrací do fronty
Zdroj: karta
4
místa systému odesílající webhooky
Zdroj: karta

Výchozí stav: alarm, který neodchází ze serveru

Koncept se týká výrobního provozu, kde systém InnerWeb běží na serveru v podnikové síti a IT oddělení uplatňuje zásadu výchozího odepření pro odchozí provoz. Hostitel aplikace nesmí navazovat spojení s žádnou adresou na internetu ani v externí síti. Je to rozumná bezpečnostní politika, ale má vedlejší dopad na integrace.

Webhook odesílaný přímo ze serveru aplikace vyžaduje odchozí spojení k příjemci. V síti s touto blokací spojení skončí časovým limitem a zpráva se ztratí. U informativního webhooku je to nepříjemnost. U alarmového webhooku, například o nečinnosti pracovníka, je to mezera v řetězci reakce: systém o události ví, ale pohotovostní pracovník se o ní nedozví.

Právě tento případ vedl ke vzniku režimu outbox. Režim vznikl pro instalace on-premise, v nichž síť zákazníka blokuje veškerý odchozí provoz z hostitele aplikace a alarmový webhook při přímém odeslání mizel.

Řešení: otočení směru spojení

V režimu outbox aplikace nic neodesílá sama. Obsah webhooku zapíše do tabulky a externí poller, běžící jako workflow n8n, záznamy odebere a odešle dál se stejným datovým obsahem. Koncový příjemce dostane přesně ten JSON, který by dostal při přímém odeslání, takže na jeho straně se nic nemění.

Rozhodující je, kdo spojení iniciuje. Poller se připojí k aplikaci příchozím kanálem, stáhne balík záznamů, odešle je příjemcům a potvrdí doručení. Pro firewall provozovny to znamená pouze příchozí provoz do aplikace, který stejně vyžaduje každý uživatel panelu. Správce sítě proto nemusí otevírat nic ve směru ven.

Odkud webhooky vznikají

Webhooky odcházejí ze čtyř míst systému: schválení prací, úkolů, alarmu nečinnosti a akcí pravidel automatizace. Všechna zapisují výsledek do stejné tabulky, takže jeden poller obslouží celý proud událostí, a ne čtyři samostatné integrace.

Limity mechanismu outbox

Limity mechanismu outboxSloupcový graf: 89 záznamů v balíku, 300 sekund do vrácení rezervace, 4 zdrojová místa webhooků.0100200300hodnotaZáznamů v balíkuZáznamů v balíku: 89 hodnota89Sekund do vrácení rezervaceSekund do vrácení rezervace: 300 hodnota300Zdrojových míst webhookůZdrojových míst webhooků: 4 hodnota4
Zdroj: Popis funkce Webhook Outbox (dokumentace produktu)

Postup nasazení krok za krokem

Následující pořadí je koncept pro provozovnu popsaného typu. Každý krok lze uzavřít samostatným důkazem, což usnadňuje převzetí oddělením IT.

  • Krok 1: administrátor aplikace přepne nastavení režimu doručování webhooků z hodnoty direct na outbox. Každá hodnota jiná než outbox se chová jako direct, takže překlep v nastavení tiše obnoví přímé odesílání; po změně je nutné to ověřit testovací událostí.
  • Krok 2: IT oddělení založí technický účet pro poller a předá jej integrátorovi (podrobnosti oprávnění jsou v samostatném dokumentu o technickém účtu).
  • Krok 3: integrátor spustí workflow n8n v segmentu sítě, který má přístup k aplikaci a zároveň smí kontaktovat příjemce alarmu.
  • Krok 4: vyvolání testovacího alarmu nečinnosti a sledování záznamu: objeví se jako čekající, poller jej rezervuje, odešle a potvrdí jako doručený.
  • Krok 5: negativní test, tedy vypnutí pollera na několik minut a ověření, že záznamy čekají a po jeho startu se doručí.

Co mechanismus zajišťuje a co ne

Atomické vyzvednutí čekajících záznamů rezervuje balík až 89 záznamů pod zámkem zápisu v transakci. Dva pollery tedy nevyzvednou stejný záznam a alarm nezazvoní dvakrát. Záznam ve stavu doručování, jehož rezervace trvá déle než 300 sekund, se vrací do fronty a může být vyzvednut znovu. Jde o pojistku pro případ, že poller uprostřed práce selže.

Potvrzení doručení přijímá stav delivered nebo failed s volitelným popisem chyby a je idempotentní: potvrzení záznamu, který už je doručen, nic nemění. Neúspěšné potvrzení vrátí záznam do stavu čekajícího a zvýší čítač pokusů, takže poller jej opakuje bez konce.

Tento poslední bod má i druhou stránku, o které je třeba mluvit otevřeně. Neexistuje limit pokusů, interval mezi opakováními ani upozornění na uvízlé záznamy a ukončené záznamy v tabulce přibývají bez úklidové úlohy. Ve scénáři nasazení je nutné tyto funkce nahradit postupem: kontrolou počtu čekajících záznamů a pravidelným přezkumem tabulky ze strany správce.

Výsledek a závěry pro provozovnu

Výsledek má dvě stránky. Pro bezpečnost sítě: firewall zůstane beze změn a auditor vidí, že integrace nevyžadovala výjimku z politiky. Pro bezpečnost lidí: alarm, který dřív mizel na hranici sítě, dorazí k pohotovostnímu pracovníkovi a historie pokusů je v tabulce.

Podmínka je jediná: poller musí běžet. Volba režimu outbox přesouvá odpovědnost z aplikace na komponentu, kterou někdo musí dohlížet. V praxi je to úkol pro IT: monitoring workflow, upozornění při nevyzvednutí záznamů a jasně určený vlastník.

Videomateriál

Často kladené otázky

Musí správce sítě otevřít nějaký odchozí port?

Ne. Spojení iniciuje poller příchozím kanálem do aplikace, takže firewall nevyžaduje výjimku pro odchozí provoz z hostitele aplikace. Poller musí mít přístup k koncovému příjemci ze svého vlastního segmentu sítě.

Co se stane, když poller přestane fungovat?

Záznamy čekají v tabulce jako čekající. Rezervace starší než 300 sekund se vrací do fronty, takže po obnovení pollera se události doručí. Neexistuje však automatické upozornění na zastavení, proto je potřeba monitoring na straně IT.

Uvidí příjemce jiný formát než při přímém odeslání?

Ne. Poller odešle stejný obsah, který byl zapsán do tabulky, takže příjemce nepotřebuje žádné úpravy.

Provozovna s blokací odchozího provozu?

Popište nám svou síť. Ukážeme, jak doručit alarmové webhooky bez změn ve firewallu.

Pojďme si promluvit