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í
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