InnerWeb
Přejít na obsah

KD OSDP a webhook událostí: poznámky k zavedení pro správce

Po výměně čteček Wiegand za OSDP se správce KD obává, že integrace s externími systémy přestanou fungovat. Pravidlo je jednoduché: InnerWeb přijímá události ze systému KD, nikoli z čtečky, takže změna spojení čtečka-kontrolér nemění kontrakt webhooku. Níže je seznam věcí ke kontrole při přepnutí.

443
port odchozího spojení integrace
Zdroj: interní karta integrace
12 hod.
platnost tokenu JWT
Zdroj: interní karta integrace
2 100
odbití denně u podobné integrace
Zdroj: interní karta implementace

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

Parametry integrace KD s InnerWebVodorovný sloupcový graf: 2100 odbití denně, okno párování 780 minut, token 12 hodin, práh duplicity 180 sekund.05001000150020002500hodnotaOdbití denněOdbití denně: 2100 hodnota2100Okno párování (min)Okno párování (min): 780 hodnota780Token JWT (hod.)Token JWT (hod.): 12 hodnota12Práh duplicity (s)Práh duplicity (s): 180 hodnota180
Zdroj: Interní karta integrace KD; okno 13 hodin přepočteno na 780 minut

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