Zásada: čtečky se nemění
InnerWeb nevyrábí ani nevyměňuje čtečky a karty řízení přístupu. Integruje se se stávajícím systémem KD klienta: přijímá události průchodu karty přes webhook a propojuje je s kvalifikacemi, povoleními, docházkou a RCP. Pro IT oddělení to znamená jasnou hranici odpovědnosti: dodavatel KD odpovídá za čtečky, karty a řadiče, doplňující systém za logiku kolem průchodu.
Díky tomu integrace nevyžaduje výměnu hardwaru a změna technologie karty na straně KD, například přechod na DESFire, nevyžaduje změnu logiky povolení. Doplňující systém zůstává nezávislým systémem vedle stávajících KD, RCP, HR a ERP.
Krok 1: specifikace události pro dodavatele KD
Prvním dokumentem je specifikace události průchodu, kterou IT oddělení předá dodavateli KD. Vzor z nasazení u výrobce obalů počítá s integrací průchodů karet ze systému KD do RCP podle specifikace pro dodavatele KD, bez čteček InnerWeb. Specifikace popisuje, která pole má událost obsahovat a jak ji doručit.
Požadavky specifikace jsou tyto: systém KD posílá události v reálném čase a každá událost nese identifikátor zaměstnance v dohodnuté podobě, čas události načtený z čtečky, identifikátor čtečky, směr průchodu (vstup nebo výstup) a identifikátor události. InnerWeb je přijímá přes ověřený webhook; přístup probíhá na tokenu s omezenou platností, který integrace automaticky obnovuje. Zásada minimalizace dat říká, že číslo karty neposíláme, pokud stačí identifikátor zaměstnance.
Krok 2: přiřaďte čtečky k místům v systému
Přiložení karty ke čtečce bez přiřazeného místa, tedy bodu akce, nespustí školicí kontrolu. Konfigurace čteček proto musí odpovídat lokalitám v systému. IT oddělení vede tabulku: identifikátor čtečky v KD, název místa v systému, druh místa, například hlavní brána, vstup do haly nebo sklad.
Tabulku doplňte společně s ochranou a BOZP, protože oni vědí, které dveře mají význam pro školení a povolení. Chyba v této fázi je nejčastější příčinou „funkční integrace, která nic nedělá“.
Krok 3: směr průchodu a identifikátor události
Směr průchodu a identifikátor události jsou požadavky na systém KD, ne doplňky. Událost se směrem umožňuje spárovat vstup s výstupem a spočítat docházku, identifikátor umožňuje odmítnout duplikát, když stejná zpráva dorazí dvakrát. Čas události pochází z čtečky, takže pořadí přiložení je spolehlivé i tehdy, když se doručení události zpozdí.
Pravidla párování vstupů a výstupů a odmítání duplikátů se určují ve specifikaci spolu s dodavatelem KD a závodem; nejde o hotovou funkci k zapnutí. Výchozím bodem k debatě bývá okno párování v řádu patnácti hodin a práh duplikátu v řádu několika minut, ale pro provoz na tři směny je třeba hodnoty přizpůsobit a závod by pravidla měl písemně schválit. Pokud čtečka na straně KD směr nezná, jde o technický fakt na straně systému KD a je třeba dohodnout způsob doplnění směru ve specifikaci.
Krok 4: volba kanálu doručování událostí
Webhook je nejjednodušší kanál, ale ne vždy možný. Pokud síť závodu blokuje odchozí provoz z aplikačního serveru, odchozí webhooky lze řadit do tabulky outbox a příjem probíhá jiným kanálem dohodnutým s klientem. IT oddělení by to mělo určit na začátku, protože změna kanálu po spuštění znamená opakované testy.
Na etapě specifikace se vyplatí zeptat na pravidla sítě závodu: zda může server KD navazovat spojení směrem ven, nebo jen uvnitř sítě, a kdo spravuje pravidla firewallu.
Krok 5: tři úskalí, která stojí týdny
První úskalí jsou data jen jako stopa. Import účtů z KD nenahrazuje proud událostí: evidence docházky vyžaduje samostatnou specifikaci událostí s časem, směrem a identifikátorem, kterou nenahradí samotný import účtů.
Druhým úskalím jsou různé identifikátory osoby v KD, RCP a systému školení. Pokud má každý systém jiný identifikátor zaměstnance, spojování událostí se stává ruční. Před spuštěním je vhodné stanovit jeden spojovací klíč.
Třetím úskalím je chybějící test na skutečném přiložení. Zkušební událost z nástroje dodavatele KD projde, ale skutečné přiložení karty u brány neprojde, protože čtečka nemá místo v tabulce z kroku 2. Závěrečný test se provádí kartou u čtečky.
Krok 6: důkaz pro auditora
Po spuštění by měl závod mít tři dokumenty: specifikaci události, tabulku čteček a míst a protokol testu s přiložením karty u brány a viditelným efektem v systému. Pro auditora je to kompletní sada důkazů, že integrace funguje tak, jak je popsáno.
Doplňte do dokumentace havarijní postup: co se stane, když události nedorazí. Závod by měl vědět, kdo a jak doplní chybějící události ze systému KD a v jakém termínu; pravidla se dohodnou ve specifikaci s dodavatelem KD.
Videomateriál
Často kladené otázky
Vyžaduje integrace změnu čteček?
Ne. Systém KD posílá události a doplňující systém je přijímá. Čtečky a karty zůstávají v gesci dodavatele KD a klienta.
Jaké požadavky splňuje událost ze systému KD?
Systém KD posílá události v reálném čase, s časem z čtečky, směrem a identifikátorem události. Pravidla párování vstupů a výstupů a odmítání duplikátů se určují ve specifikaci s dodavatelem KD.
Co když síť závodu nepovolí odchozí webhook?
Webhooky lze řadit do tabulky outbox a příjem probíhá jiným kanálem dohodnutým s klientem. Určuje se to už ve fázi specifikace.
Chcete propojit KD s povoleními?
Předáme dodavateli KD specifikaci události a integraci spustíme bez zásahu do čteček. Domluvte si rozhovor nebo demo.
Pojďme si promluvit