Kde končí OSDP a začíná webhook
OSDP se týká spojení mezi čtečkou a kontrolérem. Webhook se týká cesty od systému KD k InnerWeb. Jsou to dvě nezávislé vrstvy: po výměně čteček kontrolér stále eviduje odbití karty a software KD stále může odeslat zprávu přes HTTPS.
InnerWeb funguje jako nezávislý doplňkový systém k existujícím systémům klienta (KD, evidence pracovní doby, HR, ERP), takže změna protokolu čtečka-kontrolér nevyžaduje změny na straně InnerWeb, pokud systém KD nadále odesílá události. Podmínka je jen jedna, ale na ní končí kontroly po migraci.
Co zpráva obsahuje a co se může po výměně změnit
Zpráva o odbití obsahuje čas odbití z kontroléru, identifikátor čtečky, osobu, číslo karty ve tvaru kod_objektu-cislo a volitelně směr a identifikátor události pro idempotenci. Po výměně čtečky se může změnit identifikátor čtečky, pokud nová čtečka dostane jinou adresu nebo název v systému KD.
Proto před přepnutím domluvte, zda identifikátory čteček zůstanou stejné, nebo zda mapa čtečka-lokalita na straně InnerWeb vyžaduje aktualizaci. Bez toho odbití dorazí, ale přiřadí se k chybnému místu.
Parametry integrace KD s InnerWeb
Síť a ověření beze změn
V integraci se systémem KD spojení iniciuje strana závodu jako odchozí provoz na portu 443, takže v síti závodu není třeba otevírat příchozí porty. Výměna čteček tuto zásadu nemění a nevyžaduje změny pravidel firewallu.
Ověření integrace probíhá technickým účtem a tokenem JWT s platností 12 hodin. Při přepnutí zkontrolujte, zda serverový systém KD token včas obnovuje, protože dlouhé servisní okno může překročit platnost tokenu a pozastavit odesílání.
Test přejímky po přepnutí brány
Po každé bráně proveďte test: odbití testovací kartou na nové čtečce, ověření události v KD, ověření, zda událost dorazila do InnerWeb, a kontrola umístění čtečky. Zapište čas testu a výsledek do přejímacího protokolu.
Události z KD se ukládají do evidence docházky a, je-li modul zapnutý, do evidence pracovní doby. Modul pracovní doby se dodává ve výchozím stavu vypnutý a zapíná se nastavením správce, takže absence odbití nemusí vždy znamenat chybu integrace.
- testovací odbití a potvrzení události v KD
- událost viditelná v InnerWeb se správnou čtečkou
- umístění čtečky odpovídá mapě
- žádné duplicity při opakovaném odbití v krátkém čase
- zápis výsledku do přejímacího protokolu
Idempotence a události po přerušení
Pokud během přepínání KD ukládal odbití do fronty, mohou po obnovení odesílání dorazit události se zpožděním nebo opakovaně. Identifikátor události zajišťuje idempotenci: stejná událost odeslaná dvakrát nevytvoří dvě odbití.
Při velkém provozu záleží na objemu: u podobné integrace v provozu od roku 2024 se zpracovává zhruba 2 100 odbití denně v pracovních dnech. Při takovém objemu by servisní okno uprostřed směny vytvořilo stovky zpožděných událostí, proto je vhodné je plánovat na výrobní přestávku.
Videomateriál
Často kladené otázky
Vyžaduje výměna čteček za OSDP změny v InnerWeb?
Ne, pokud systém KD nadále odesílá události odbití. Je vhodné ověřit identifikátory čteček a mapu lokalit.
Je nutné po změně čteček otevírat příchozí porty?
Ne. Spojení iniciuje strana závodu jako odchozí provoz na portu 443.
Co s odbitími nasbíranými během přestávky?
Po obnovení mohou dorazit se zpožděním. Identifikátor události zajistí, že stejná událost nebude zapsána dvakrát.
Zdroje
Vyměňujete čtečky v KD?
Popište nám systém KD a plán výměny. Pomůžeme připravit test událostí, aby odbití po přepnutí nezmizela z InnerWeb.
Pojďme si promluvit