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