InnerWeb
Přejít na obsah

Webhook z KD: průvodce pro správce IT

Webhook přiložení z KD je volání HTTP, kterým systém řízení přístupu předává událost přiložení karty jinému systému v okamžiku jejího vzniku. Správce IT odpovídá za to, aby se událost skutečně doručila, a ne jen odeslala. Průvodce ukazuje, jak událost definovat, jak ji ověřit a co dělat, když síť závodu blokuje odchozí provoz.

89
maximální balík záznamů fronty outbox na jedno vyzvednutí
Zdroj: dokumentace funkce Webhook Outbox
300 s
doba, po které se nepotvrzený záznam vrací do fronty
Zdroj: dokumentace funkce Webhook Outbox

Co znamená webhook přiložení z KD

Webhook je obrácený model integrace: místo aby se systém KD každou minutu dotazoval na nová přiložení, sám odešle událost na určenou adresu, jakmile bude karta přiložena. Příjemce dostává data s minimálním zpožděním a nezatěžuje KD dotazy.

InnerWeb přijímá události přiložení karet ze systému KD přes webhook a propojuje je s kvalifikacemi, oprávněními, přítomností a RCP. InnerWeb je výrobcem softwaru: čtečky a karty nevyrábí ani nevyměňuje, ale integruje se se stávajícím systémem KD klienta. Na straně KD je tedy potřeba funkce odesílání událostí a na straně InnerWeb adresa, která je přijme.

Událost: co má obsahovat

Specifikaci události určuje správce IT spolu s dodavatelem KD. Minimální sada je identifikátor osoby nebo karty, časové razítko, identifikátor průchodového bodu a výsledek přiložení, tedy povolený vstup nebo odmítnutí.

Pokud čtečka nepředává směr průchodu, příjemce přiložení páruje: vstup s výstupem v okně do 13 hodin a duplicity v kratším čase než 180 sekund odmítá. Proto musí být časové razítko přesné a časové pásmo jednoznačné.

  • Identifikátor osoby nebo karty, bez údajů, které k účelu nejsou potřeba.
  • Časové razítko s časovým pásmem.
  • Identifikátor brány nebo čtečky.
  • Výsledek: povoleno, nebo odmítnuto.
  • Jedinečný identifikátor události, aby opětovné odeslání nevytvořilo duplicitu.

Parametry příjmu a párování událostí

Parametry příjmu a párování událostíSloupcový graf: práh duplicity 180 sekund, návrat záznamu do fronty 300 sekund, balík outbox 89 záznamů, okno párování 13 hodin.0100200300sekundy, záznamy nebo hodiny (samostatné veličiny)Práh duplicity (s): 180 sekundy, záznamy nebo hodiny (samostatné veličiny)180Práh duplicity (s)Návrat záznamu do fronty (s): 300 sekundy, záznamy nebo hodiny (samostatné veličiny)300Návrat záznamu dofronty (s)Balík outbox (záznamy): 89 sekundy, záznamy nebo hodiny (samostatné veličiny)89Balík outbox(záznamy)Okno párování (h): 13 sekundy, záznamy nebo hodiny (samostatné veličiny)13Okno párování (h)
Zdroj: Karta funkce InnerWeb a dokumentace funkce Webhook Outbox

Jak ověřit, že se událost doručuje

Kód odpovědi 200 na straně odesílatele nestačí jako důkaz účinku. Je třeba ověřit tři věci: zda se událost objevila v systému příjemce, zda má správná data a zda počet událostí odpovídá počtu přiložení v KD.

Platforma nabízí API REST (verze 1 a 2, JWT) a webhooky do platformy automatizace. Správce tak může porovnat počet událostí na obou stranách přes API a ověřit výsledek nezávisle na hlášení odesílatele.

Test ve třech krocích

Test je vhodné provést před spuštěním a pak po každé změně sítě nebo konfigurace KD.

  • Přilož testovací kartu a ověř, zda se událost objevila v systému příjemce do několika sekund.
  • Přilož tutéž kartu dvakrát v čase kratším než 180 sekund a ověř, zda byla duplicita odmítnuta.
  • Na krátkou dobu přeruš spojení a ověř, zda se události po jeho obnovení neztrácejí.

Když síť závodu blokuje odchozí provoz

V závodech s přísnou síťovou politikou bývá aplikační server odříznut od odchozího provozu. Odchozí webhooky InnerWeb lze pak řadit do tabulky outbox a externí poller přebírá balík přes příchozí kanál. Mechanismus se týká odesílání z platformy, ne příjmu událostí z KD, ale stejné pravidlo je třeba vyřešit už při návrhu sítě.

V dokumentaci funkce obsahuje balík pro vyzvednutí až 89 záznamů a zablokovaný záznam se vrací do fronty po 300 sekundách, pokud nebyl potvrzen. Pro správce jde o parametry, které je dobré znát při posuzování zpoždění v izolované síti.

Důkaz pro audit a údržba

Důkazem je záznam událostí na obou stranách se stejnými identifikátory. Jednou za čtvrtletí stojí za to porovnat vzorek, protože tichá závada webhooku se projeví chybějícími událostmi, a ne chybovou hláškou.

Průchody brány tvoří evidenci pracovní doby (RCP) s denními, měsíčními aročními přehledy, frontami výjimek a uzavíráním období. Chybějící události tak končí ve výjimkách, ale jen tehdy, když je někdo ve frontách kontroluje.

Videomateriál

Často kladené otázky

Čím se webhook liší od dotazování na API?

Webhook odešle událost v okamžiku jejího vzniku, zatímco dotazování vyžaduje opakované dotazy. Webhook dává menší zpoždění a nezatěžuje systém KD.

Jak ověřit, že se událost neztratila?

Porovnejte počet a identifikátory událostí v systému KD a v systému příjemce, například přes API REST. Samotný kód 200 odesílatele nestačí.

Co dělat, když síť závodu blokuje odchozí provoz?

Odchozí webhooky InnerWebu lze řadit do tabulky outbox a poller přebírá balík příchozím kanálem. Řešení se týká odesílání z platformy a je třeba je sjednat s IT.

Ověřme, že se události z KD doručují

Probereme specifikaci webhooku pro Váš systém KD a test, který potvrdí doručení událostí.

Pojďme si promluvit