InnerWeb
Přejít na obsah

Webhook odbití karet z KD do RCP: poznámky k nasazení

Odbití karty na bráně má dorazit do evidence pracovní doby bez ručního přepisování. InnerWeb přijímá událost odbití ze systému kontroly přístupu přes webhook, takže úkolem dodavatele KD je poslat správná pole správným kanálem. Níže jsou poznámky pro integrátora a IT: pole, token a pořadí prací.

12 h
doba platnosti tokenu webhooku
Zdroj: dokumentace integrace
4
etapy nasazení: specifikace, test, hala, závod
Zdroj: vlastní zpracování

Cíl integrace a rozdělení odpovědnosti

Závod má systém kontroly přístupu s čtečkami a kartami a systém evidence pracovní doby. InnerWeb je nezávislý doplňující systém: přijímá události odbití, propojuje je s kvalifikacemi, oprávněními, docházkou a evidencí pracovní doby a nenahrazuje KD, RCP ani HR.

InnerWeb čtečky nevyrábí ani nevyměňuje. Specifikace integrace je určena dodavateli KD: on nastavuje odesílání událostí. Úkolem závodu je zajistit, aby dodavatel dostal specifikaci a přístup k testovacímu prostředí.

Pole události: co má dodavatel KD odeslat

Událost odbití karty obsahuje mimo jiné čas, místo, jméno, příjmení, firmu, číslo aktivní karty, telefon, e-mail a jazyk osoby. Ne všechna pole musí být v systému KD dostupná, proto se specifikace dohodne na úrovni povinných a volitelných polí.

Praktické minimum je čas odbití, místo (brána nebo čtečka) a identifikátor osoby, tedy číslo aktivní karty. Ostatní pole usnadňují přiřazení osoby k účtu, ale osobní údaje je třeba předávat jen v rozsahu nezbytném a v souladu s právním základem závodu.

  • čas odbití s označením časového pásma
  • místo: identifikátor brány nebo čtečky
  • číslo aktivní karty
  • jméno, příjmení a firma, pokud je systém KD uchovává
  • jazyk osoby, pokud má sloužit pro zprávy

Příkladový harmonogram integrace webhooku (předpoklad)

Příkladový harmonogram integrace webhooku (předpoklad)Sloupce: 5, 3, 5 a 5 pracovních dnů.012345pracovních dnůSpecifikace a testovací prostředí: 5 pracovních dnů5Specifikace atestovací prostředíTest z jedné brány: 3 pracovních dnů3Test z jedné brányJedna hala: 5 pracovních dnů5Jedna halaCelý závod: 5 pracovních dnů5Celý závod
Zdroj: Příkladová kalkulace: časy předpokládané pro plánování, k nahrazení ujednáním s dodavatelem KD

Ověření: token s omezenou platností

InnerWeb přijímá událost odbití karty přes webhook ověřený tokenem s omezenou platností: 12 hodin. Dodavatel KD proto musí naplánovat obnovu tokenu před jeho vypršením, nikoli až po odmítnutí události.

Ve specifikaci je vhodné zapsat, kdo a jak token obnovuje, co se stane s událostmi odeslanými po vypršení a jak se dodavatel dozví o chybě. Dobrou praxí je fronta na straně KD, která opakuje odeslání, pokud příjem nebyl potvrzen.

Token nesmí být uložen v čitelném konfiguračním souboru ani v textu servisního požadavku. Předání probíhá kanálem dohodnutým IT oddělení obou stran.

Pořadí prací: od testu po produkci

Etapa první: dodavatel KD dostane specifikaci a údaje testovacího prostředí. Etapa druhá: odeslání testovacích událostí z jedné brány a kontrola polí a času. Etapa třetí: odesílání ze všech bran jedné haly. Etapa čtvrtá: zapnutí celého závodu a porovnání počtu odbití na obou stranách.

Porovnání počtu odbití je klíčovým testem: počet událostí odeslaných KD a přijatých InnerWeb ve stejném časovém okně má být stejný. Rozdíly se rozebírají podle brány a hodiny, protože často ukazují na konkrétní čtečku nebo na okamžik vypršení tokenu.

Úskalí: čas, duplicity a odbití bez osoby

První úskalí je časové pásmo: čas odbití uložený v místním čase bez označení pásma dává chybu o hodinu v období přechodu na letní čas, což v evidenci pracovní doby vypadá jako přesčas. Čas je třeba předávat s označením pásma.

Druhé úskalí jsou duplicity: tatáž karta odbitá dvakrát během několika vteřin, protože ji čtečka načetla při vstupu i při odchodu. Pravidla filtrování se určují s ochranou, nikoli v kódu integrace.

Třetí úskalí jsou odbití bez osoby: číslo karty, které nemá přiřazený účet, nebo je přiřazeno k zdvojenému účtu. Taková událost končí na seznamu výjimek a kontrola dvojic zdvojených účtů po importu karet jejich počet omezuje.

Převzetí a provoz

Převzetí končí protokolem: seznam bran, výsledek porovnání počtu odbití, test vypršení a obnovy tokenu, test výpadku spojení. Provoz znamená hlídání chybějících událostí z brány v hodinách, kdy odbití obvykle bývají, protože ticho z jedné brány bývá prvním příznakem poruchy.

Závod má určit osobu, která alarmy přebírá, a dodavatele KD, který je řeší na straně svého systému. Bez toho integrace funguje, dokud nenastane první problém.

Při rozšíření závodu o novou halu nebo bránu dodavatel KD doplní nové čtečky do odesílání a závod aktualizuje seznam míst, aby události z nové brány nepřicházely jako odbití bez lokality. Změna seznamu bran má být krokem postupu změny, stejně povinným jako objednání čtečky.

Videomateriál

Často kladené otázky

Vyměňuje InnerWeb čtečky?

Ne. InnerWeb se integruje se stávajícím systémem KD a specifikace je určena jeho dodavateli.

Jak dlouho je platný token webhooku?

12 hodin, takže dodavatel KD musí naplánovat jeho obnovu.

Jaká data obsahuje událost odbití?

Mimo jiné čas, místo, jméno, příjmení, firmu, číslo aktivní karty, telefon, e-mail a jazyk, v rozsahu dohodnutém se závodem.

Jak ověřit, že integrace funguje?

Porovnejte počet odbití odeslaných KD a přijatých InnerWeb ve stejném časovém okně, podle brány.

Zdroje

Předejte specifikaci dodavateli KD

Připravíme specifikaci polí a ověření pro dodavatele KD a plán testů z jedné brány.

Pojďme si promluvit