InnerWeb
Přejít na obsah

Režim direct nebo outbox: který zvolit pro webhooky

Nastavení režimu doručování webhooků má dvě hodnoty a dvě různé filozofie: direct odesílá hned z aplikačního serveru, outbox zapíše záznam a čeká na vyzvednutí pollerem. Volba závisí hlavně na tom, zda síť instalace dovoluje odchozí provoz. Níže je sedm doporučení pro ředitele IT, integrátora a správce aplikace.

2
režimy doručování: direct a outbox
Zdroj: karta
4
místa systému odesílající webhooky
Zdroj: karta

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