Kdo čte události a kdo dodává čtečky?
InnerWeb je výrobce softwaru a čtečky ani kontroléry řízení přístupu nevyrábí ani nevyměňuje. Čtečky, kontroléry a karty zůstávají na straně klienta a jeho dodavatele KD. Náš systém přijímá události odbití karty z existujícího systému KD přes webhook a spojuje je s kvalifikacemi, povoleními, docházkou a evidencí pracovní doby.
Dodavatel KD od nás dostane specifikaci události odbití. Nemusí tak poznávat vnitřní strukturu našeho systému a závod nemění bránové vybavení.
Jak se dodavatel KD ověřuje v systému?
Ověřování probíhá technickým účtem a tokenem JWT. Token platí 12 hodin, takže integrace jej musí obnovit před vypršením nebo po odmítnutí kvůli prošlé platnosti.
Technický účet slouží výhradně k odesílání událostí. Není účtem zaměstnance a neměl by mít oprávnění k prohlížení osobních údajů.
- Samostatný technický účet pro každý systém KD, aby šel vypnout nezávisle.
- Obnovování tokenu s časovou rezervou, ne v poslední minutě platnosti.
- Přihlašovací údaje uložené u dodavatele KD v trezoru tajemství, ne v kódu.
Parametry integrace odbití
Z čeho se skládá zpráva o odbití?
Zpráva obsahuje čas odbití zapsaný kontrolérem, identifikátor čtečky, osobu a číslo karty ve tvaru kod_obiektu-numer. Dodavatel volitelně uvede směr průchodu a identifikátor události.
Čas pochází z kontroléru, ne z okamžiku, kdy zpráva dorazila k nám. To je důležité pro evidenci pracovní doby: po výpadku sítě může kontrolér odeslat zpožděná odbití a jejich hodina zůstane správná.
Číslo karty ve tvaru kod_obiektu-numer
Kód objektu odlišuje karty z různých instalací, které by mohly mít stejné číslo. Systém spojuje kartu s účtem zaměstnance, takže odeslání čísla bez kódu objektu nestačí k jednoznačnému rozpoznání.
Směr průchodu
Směr je volitelný. Pokud jej uvedete, systém rozliší vstup od výstupu a vypočítá přítomnost. Pokud chybí, evidence použije pravidla nastavená pro danou čtečku.
Co znamená idempotence a proč identifikátor události?
Síť bývá nespolehlivá, takže kontrolér odešle událost znovu, když nedostal potvrzení. Bez identifikátoru události by se stejné odbití mohlo zapsat dvakrát a zkreslit pracovní dobu.
Identifikátor události umožňuje poznat opakování: opětovné odeslání se stejným identifikátorem nevytvoří druhé odbití. Proto doporučujeme jej vždy uvádět, i když je pole volitelné.
Co systém dělá s odbitím na straně BOZP a RCP?
Skeny z brány, které slouží i k evakuačnímu seznamu, tvoří evidenci pracovní doby: denní, měsíční a roční přehledy, fronty výjimek, uzavírání období a upomínky na nenaskenovaný odchod. Modul evidence je ve výchozím stavu vypnutý a závod jej zapíná vědomě.
Evakuační seznam se obnovuje každých 13 sekund a rozděluje osoby do šesti skupin: hosté, kurýři, dodavatelé, zaměstnanci závodu, externí firmy a nejisté. Data pocházejí ze stejných odbití, takže je dodavatel KD neposílá odděleně.
Jak integraci ověřit před produkčním spuštěním?
Doporučujeme krátký test při uzavřené bráně: několik odbití z kontroléru, opakování téže události, odbití z zneplatněné karty a odbití po simulovaném výpadku sítě. Důkazem z takového testu je záznam událostí na obou stranách, který integrátor přikládá k dokumentaci převzetí.
- Správné odbití: vznikne jeden záznam s časem z kontroléru.
- Opakování se stejným identifikátorem: žádný druhý záznam.
- Token po platnosti: odmítnutí a úspěšné obnovení.
- Zneplatněná karta: odbití nedává přístup závislý na školeních.
Kontrolní seznam
Videomateriál
Často kladené otázky
Vyměňuje InnerWeb čtečky nebo kontroléry?
Ne. Integrujeme se s existujícím systémem KD a přijímáme z něj události. Bránové vybavení zůstává u klienta a jeho dodavatele.
Je pole směru průchodu povinné?
Ne, je volitelné. Pokud je uvedete, systém rozliší vstup a výstup; bez něj se evidence řídí pravidly čtečky.
Co se stane po opětovném odeslání téže události?
Při stejném identifikátoru události nevznikne druhé odbití. Bez identifikátoru systém opakování nerozpozná, proto doporučujeme jej vždy uvádět.
Funguje modul evidence pracovní doby hned?
Ne, je ve výchozím stavu vypnutý. Závod jej zapne po stanovení pravidel pro výjimky a uzavírání období.
Předáme specifikaci dodavateli KD
Domluvte si schůzku s integrátorem: probereme formát události, ověřování a testovací scénáře před prvním odbitím.
Pojďme si promluvit