InnerWeb
Přejít na obsah

Přiložení karet po migraci: otázky IT/OT

Po výměně karet chce oddělení IT/OT vědět jedno: zda integrace přiložení přežije změnu nosiče bez otevírání nových portů a bez zkreslení pracovních dnů. Níže jsou odpovědi na otázky o směru spojení, autentizaci, obsahu zprávy, čase a opakovaném odesílání.

443
jeden odchozí port pro integraci
Zdroj: karta
3
povinná pole události: čas z čtečky, směr, identifikátor
Zdroj: karta

Směr spojení a porty

Je nutné otevřít příchozí port v síti závodu? Ne. Při každém přiložení karty server systému KD odešle do InnerWeb zprávu HTTPS POST, takže spojení je odchozí ze sítě závodu. Pro tým IT/OT to znamená pravidlo firewallu pro odchozí provoz na jednu adresu a port 443, bez vystavení serveru KD do internetu.

Mění migrace karet tento návrh? Ne, protože se mění nosič a číslo karty, nikoli kanál událostí. Pokud se spolu s kartami vyměňují i čtečky a řadiče, stačí ověřit, zda server KD po aktualizaci stále umí odesílat HTTPS POST.

Autentizace a token JWT

Jak se systém KD vůči InnerWeb autentizuje? Integrace používá technický účet a token JWT s omezenou dobou platnosti, který integrace automaticky obnovuje. Na straně dodavatele KD proto musí fungovat obnova tokenu nebo přihlášení před každou sérií odeslání.

Je vhodné ujasnit s dodavatelem KD, jak řeší vypršení tokenu v noci nebo o víkendu. Dobrým přejímacím testem je pozastavit obnovu a ověřit, zda se odesílání po novém přihlášení obnoví bez ztráty událostí.

Požadavky specifikace integrace přiložení

Požadavky specifikace integrace přiloženíSloupcový graf: jeden odchozí port a tři povinná pole události0123početOdchozí porty: 1 počet1 početOdchozí portyPovinná pole události: 3 počet3 početPovinná pole události
Zdroj: Karta integrace přiložení z systému KD

Obsah zprávy a číslo karty

Co by měla zpráva obsahovat? Specifikace integrace vyžaduje čas přiložení z čtečky, identifikátor čtečky, osobu, číslo karty ve tvaru kod_objektu-cislo, směr (vstup nebo výstup) a identifikátor události. Po migraci mají čísla karet nové hodnoty, proto je před spuštěním vlny nutné dodat export karet (kod objektu a číslo) propojený s osobním číslem.

Jak se zachází se vstupy a výstupy? Systém KD posílá události v reálném čase spolu se směrem a InnerWeb je přijímá prostřednictvím ověřeného webhooku. Pravidla párování vstupů a výstupů a odmítání duplicit se určují ve specifikaci s dodavatelem KD. Pokud čtečky v systému KD klienta nerozlišují směr, jde o technickou skutečnost na straně KD, kterou je nutné do specifikace zahrnout. Po výměně čteček aktualizujte slovník čteček, ve kterém se samostatné čtečky popisují jako vstup a výstup.

Čas z řadiče a idempotence

Proč rozhoduje čas z čtečky, a ne čas přijetí? Systém KD posílá události v reálném čase s časem události z čtečky. Díky tomu offline fronta nebo opakované odeslání po výpadku linky nepřesouvá přiložení: opožděné přiložení se zapíše do své hodiny a identifikátor události umožní odmítnout duplicity podle pravidel dohodnutých ve specifikaci.

V praxi to znamená jeden požadavek na dodavatele KD: každá událost musí mít stabilní identifikátor, který se při opakovaném odeslání nemění. Po migraci řadičů se to vyplatí ověřit, protože nový firmware může identifikátory generovat jinak.

Co zůstává na straně InnerWeb a co na straně KD

Veškeré zpracování, tedy rozpoznání vstupu a výstupu, spojování do pracovních dnů, směnové plány, výjimky a sestavy, probíhá na straně InnerWeb a logika KD zůstává beze změny. Oddělení IT/OT tak nemusí přenášet pravidla vyúčtování do systému KD ani naopak.

Přiložení neznámé karty skončí ve frontě karet k přiřazení namísto zakládání účtu z neznámého přiložení. Díky tomu první vlna nových karet, která zatím není spojena s osobami, nevytváří účty a nevnáší zmatek do evidence.

Videomateriál

Často kladené otázky

Je po výměně karet nutné integraci znovu nasazovat?

Ne. Kanál HTTPS POST a autentizace zůstávají. Mění se číslo karty a export karet k osobnímu číslu, který se do InnerWeb nahrává importem CSV.

Co dělat, když dodavatel KD neodesílá HTTPS POST?

Je to první otázka k ujasnění před integrací: zda server KD umí odesílat HTTPS POST. Společně se určuje seznam čteček a formát exportu karet.

Nenaruší události z offline fronty pracovní dny?

Ne, pokud zpráva nese čas z čtečky a identifikátor události. Pravidla pro odmítání duplicit se určují ve specifikaci s dodavatelem KD.

Vidí InnerWeb číslo karty v otevřené podobě?

Číslo karty má tvar kod_objektu-cislo a slouží k propojení s osobou. Ve vyhledávání účtu v modulu školení se číslo karty nezobrazuje.

Zdroje

Ověřme integraci přiložení před migrací

Projdeme s vaším oddělením IT/OT a dodavatelem KD seznam ujednání: odesílání, token, čtečky a export karet. Po výměně karet tak dny pracovní doby zůstanou bez děr.

Pojďme si promluvit