Rozdělení odpovědnosti
InnerWeb přijímá události přiložení karty ze systému kontroly přístupu přes webhook. Čtečky nevyrábí ani nenahrazuje, takže na straně integrátora zůstává konfigurace systému KD a na straně InnerWeb přiřazení události k osobě, jejím kvalifikacím a povolením.
Události z čteček mohou být propojeny s kvalifikacemi, povoleními, přítomností a evidencí pracovní doby. To znamená, že jedno přiložení karty může naráz napájet několik procesů, pokud je identita karty jednoznačně přiřazena osobě.
Krok 1: domluvte kontrakt události
Začněte krátkým dokumentem kontraktu: jaká pole posílá systém KD, jaký je formát času, jak se označuje směr a kontrolní bod. V tomto kroku nevymýšlíme formát podle přání: integrátor popíše, co jeho systém umí odeslat, a my to namapujeme na model události.
Minimum, které potřebujeme k propojení události, je identifikátor karty, čas události a identifikátor kontrolního bodu. Zbytek, například směr, usnadňuje lokalizaci, ale není podmínkou startu.
- Identifikátor karty ve stabilním formátu.
- Čas události se časovým pásmem.
- Identifikátor čtečky nebo kontrolního bodu.
- Směr vstupu nebo výstupu, pokud jej systém zná.
Etapy integrace webhooku a typická náročnost (příklad)
Krok 2: přiřaďte karty k osobám
Webhook je bez tabulky přiřazení k ničemu: musí být jasné, který identifikátor karty patří které osobě. Přiřazení by mělo pocházet z jednoho zdroje, nejlépe z personálního systému nebo z registrace, a ne z ručních seznamů integrátora.
Šifrované karty tento krok nemění, ale mění to, co je vidět na straně integrace: identifikátor může být odvozen od klíče spravovaného v systému KD. Důležité je, aby identifikátor odeslaný ve webhooku byl stejný, jaký je uložen v přiřazení.
Ztracené a náhradní karty
Ztracenou kartu zablokujte v systému KD a v InnerWeb ponechte záznam, aby dřívější události zůstaly přiřazeny správné osobě.
Dočasné karty
U hostů a zhotovitelů vyžadují dočasné karty výslovný začátek a konec přiřazení, jinak další osoby zdědí cizí kvalifikace.
Krok 3: bezpečnost a spolehlivost
Webhook by měl mít autentizaci, například sdílené tajemství nebo podpis, a omezení zdroje na síť integrátora. Přenos uvnitř sítě OT vyžaduje domluvu s oddělením IT, proto to plánujte včas, a ne v den spuštění.
Události odcházející z InnerWeb do externích systémů jdou do fronty typu outbox a opakované doručení je možné, když je přijímací systém dočasně nedostupný. Stejný vzor se doporučuje i na straně systému KD: fronta s opakováním místo jednoho pokusu.
Krok 4: přejímací test
Test začíná jednou událostí z jedné testovací karty, kterou určí klient. Ověřte, že se událost objeví v InnerWeb u správné osoby a že se změní stav povolení nebo přítomnosti.
Poté následuje zátěžový test: série událostí v krátkém čase, například průchod skupiny bránou. Na závěr test výpadku: přerušení spojení a doručení zameškaných událostí po jeho ukončení.
Co předat objednateli po přejetí
Objednatel by měl dostat krátkou dokumentaci: kontrakt, schéma toku, seznam kontrolních bodů a postup pro případ výpadku. Bez ní každá výměna čtečky vyžaduje novou analýzu.
Zapište také, kdo je vlastníkem přiřazení karet. Tato otázka se vrací po roce, když se mění dodavatel systému KD.
Kontrolní seznam
Videomateriál
Často kladené otázky
Dodává InnerWeb čtečky karet?
Ne. InnerWeb je výrobcem softwaru a čtečky nevyrábí ani nenahrazuje.
Musí webhook jít přímo ze systému KD?
Události přijímáme ze systému KD. Prostředník v síti OT je přípustný, pokud zachovává čas a identifikátor karty.
Co se zameškanými událostmi po výpadku?
Doporučujeme frontu s opakováním na straně KD. Na straně InnerWeb platí obdobný vzor pro odcházející události.
K čemu slouží události po integraci?
K propojení s kvalifikacemi, povoleními, přítomností a evidencí pracovní doby.
Propojujete KD s povoleními?
Pošleme kontrakt události a seznam otázek pro dodavatele systému KD a projdeme s vámi přejímací test.
Pojďme si promluvit