Pro koho je toto doporučení určeno
Text je určen lidem, kteří rozhodují o tom, jak se webhooky ze systému InnerWeb dostanou k příjemcům: řediteli IT, integrátorovi a správci aplikace. Předpokládá se, že příjemce (n8n, firemní systém, komunikátor) už existuje a je třeba zvolit způsob doručení.
Přepínačem je nastavení režimu doručování webhooků s hodnotami direct (výchozí) a outbox. Každá jiná hodnota než outbox znamená direct, což je důležité u překlepů popsaných v šestém doporučení.
Doporučení 1 až 3: volba režimu
Níže jsou tři rozhodovací doporučení. Každé má zdůvodnění vycházející z popisu mechanismů.
1. Instalace s odchozím provozem: zůstaňte u direct
Výchozí režim je nejjednodušší: aplikační server sám odešle webhook příjemci. Nevyžaduje žádnou dodatečnou komponentu, kterou by bylo třeba dohlížet. Pokud síť instalace, například v cloudu, dovoluje odchozí spojení k adrese příjemce, není důvod přidávat poller.
2. Síť s blokací odchozího provozu: zvolte outbox
Režim outbox vznikl pro instalace on-premise, v nichž síť blokuje veškerý odchozí provoz z hostitele aplikace, a alarmový webhook při přímém odeslání končil časovým limitem a mizel. Poller se připojí k aplikaci sám příchozím kanálem, takže firewall zůstává beze změn.
3. Alarmový webhook: důležitější je doručitelnost než jednoduchost
Pokud webhookem procházejí alarmy nečinnosti nebo jiné bezpečnostní události, ztráta zprávy je drahá. Volba outbox má v takovém případě smysl i tam, kde síť formálně výstup propouští, ale je nestabilní: záznam počká v tabulce místo toho, aby zmizel.
Doporučení 4 a 5: dopady na přehledy a dohled
Čtvrté doporučení: rozhodněte, odkud vezmete historii pro přehled Kanály komunikace. V režimu direct každý webhook kromě odeslání zapíše také ukončený řádek delivered nebo failed jako historii pro tento přehled, a takový řádek se nikdy nedostane k pollerovi. V režimu outbox historii tvoří samotné záznamy, jejichž stav se mění s potvrzeními.
Páté: u režimu outbox určete vlastníka pollera. Režim přesouvá odpovědnost za doručení z aplikace na workflow, které musí být monitorováno. Chybějící limit pokusů, interval mezi opakováními a upozornění na uvízlé záznamy znamenají, že neúspěšné potvrzení vrátí záznam mezi čekající a zvýší čítač pokusů, takže nedoručená událost se bude opakovat bez konce.
Doporučení 6 a 7: změna režimu a úklid
Šesté: po změně režimu vždy proveďte testovací událost. Protože každá hodnota jiná než outbox znamená direct, překlep v nastavení tiše obnoví přímé odesílání a v síti s blokací se webhook ztratí bez viditelné chyby na straně uživatele.
Sedmé: naplánujte úklid. Neexistuje úloha, která by odstraňovala ukončené záznamy z tabulky, takže přibývají donekonečna. Při velkém objemu webhooků je třeba stanovit pravidelný přezkum a politiku uchovávání na straně správce.
Porovnání na jednom místě
Pro přehled: direct vyhrává jednoduchostí a nevyžaduje poller, ale potřebuje odchozí provoz z hostitele aplikace a ztracené zprávy nezopakuje. Outbox vyhrává doručitelností a souladem s firewallem, ale vyžaduje dohled nad pollerem a ruční přezkum tabulky.
Nejčastější rozhodovací chyba je volba outbox jen kvůli spolehlivosti bez určení vlastníka pollera. Druhá je ponechání režimu direct v síti s blokací s nadějí, že výjimka ve firewallu bude přidána později.
Videomateriál
Často kladené otázky
Který režim je výchozí?
Výchozí je direct. Každá hodnota nastavení jiná než outbox se chápe jako direct.
Mám v režimu direct historii v přehledu Kanály komunikace?
Ano. Každý webhook kromě odeslání zapíše také ukončený řádek delivered nebo failed jako historii pro tento přehled.
Lze režim měnit za provozu?
Nastavení lze změnit, ale po změně proveďte testovací událost a ověřte, že záznam dorazil podle očekávání.
Nevíte, který režim zvolit?
Popište nám síť instalace. Vybereme režim doručování a určíme, kdo by měl dohlížet na poller.
Pojďme si promluvit