InnerWeb
Přejít na obsah

Integrace KD se systémem BOZP: webhook v závodě

Vedoucí ochrany závodu, který má funkční systém řízení přístupu, nemusí měnit čtečky, aby u brány kontroloval školení BOZP. Stačí, aby systém KD při každém přiložení karty poslal do InnerWeb požadavek HTTP POST. Níže je popsán scénář nasazení pro středně velký výrobní závod, den po dni.

3
vlastnosti každé události: čas z čtečky, směr, identifikátor
Zdroj: specifikace integrace
2 000+
přiložení za den v závodě s více agenturami

Výchozí stav: závod, který má KD a nechce ho měnit

Koncept se týká středně velkého výrobního závodu, který už léta používá systém řízení přístupu na kartách. Čtečky visí u brány, v šatnách a u vstupů do hal, a servis KD zajišťuje dodavatel. Ochrana vidí, že karta je platná, ale nevidí, zda má její držitel platné vstupní školení BOZP a zda externí firma smí vstoupit na areál.

InnerWeb je výrobce softwaru, ne čteček. Nevyrábí ani nevyměňuje zařízení řízení přístupu, ale integruje se se stávajícím systémem KD jako nezávislý doplňkový systém vedle KD, RCP, HR a ERP. Toto východisko určuje celý projekt: žádná výměna techniky, žádný výpadek bran a jediná integrace na straně softwaru.

Místem styku je webhook přiložení karty. Systém KD posílá do InnerWeb požadavek HTTP POST při každém přiložení a InnerWeb jej přijme jako událost a propojí s účtem osoby, jejími školeními, kvalifikacemi a firmou.

Den 1: ověření a první testovací zpráva

První den integrátor na straně KD získá přístup k API InnerWeb. Volání webhooku vyžaduje token, který se získá z přihlašovacího endpointu API. Token má omezenou dobu platnosti a integrace jej obnovuje automaticky. V praxi musí služba na straně KD token obnovovat pravidelně nebo před každou sérií hlášení.

Typická chyba prvního dne je uložení tokenu natvrdo do konfigurace skriptu. Token po určité době vyprší, takže integrace zpočátku funguje, a pak začnou být hlášení odmítána. Dobrý vzor je krátký postup přihlášení, který se spustí při odpovědi s kódem odmítnutí autorizace.

První testovací zpráva má se týkat jedné známé osoby s kartou. Ochrana v InnerWeb ověří, zda se přiložení objevilo u správného účtu, a teprve potom zapne produkční provoz.

Rozsah a objem událostí v integraci přiložení

Rozsah a objem událostí v integraci přiloženíDva sloupce: přes 2 000 přiložení za den a 3 vlastnosti každé události.0500100015002000hodnotaPřiložení za den (závod s agenturami): 2000 hodnota2000Přiložení za den (závod s agenturami)Vlastnosti události ve specifikaci: 3 hodnota3Vlastnosti události ve specifikaci
Zdroj: a

Dny 2–3: údaje osoby a firmy v hlášení

Podle specifikace posílá systém KD v hlášení přiložení čas události z čtečky, směr (vstup nebo výstup), identifikátor události, místo přiložení a údaje osoby: jméno a příjmení (povinné), akronym, firmu (název firmy povinný), číslo aktivní karty, telefon, e-mail a jazyk. Číslo aktivní karty je identifikátor, podle kterého InnerWeb páruje přiložení s účtem osoby, a externí firma se přiřadí podle názvu firmy v hlášení.

Druhý a třetí den slouží ke kontrole, kdo se v systému objevuje. Přiložení karty osoby, kterou InnerWeb nezná, založí účet a firmu z údajů v hlášení. Pokud je stejná firma v KD zapsaná jednou celým názvem a jindy zkratkou, vzniknou v systému dvě firmy. Proto v tomto období ochrana a HR porovnávají seznam firem v KD se seznamem firem v InnerWeb a sjednotí pravopis už u zdroje.

  • porovnání názvů firem v KD a v InnerWeb
  • kontrola, zda má každá osoba číslo aktivní karty
  • kontrola, zda je vyplněné pole jazyka u cizinců

Dny 4–5: místa přiložení a školicí poplach

Pole místa přiložení rozlišuje lokality čteček. Události z místa, které v InnerWeb nemá definovanou šablonu, se zapíší do logu a nespustí školicí poplach. Je to nejčastější překvapení čtvrtého dne: čtečka u hlavní brány funguje správně, ale čtečka u dodávkové brány zapisuje události do logu a nevyvolá žádnou reakci.

Ochrana proto prochází seznam všech míst, odkud přicházejí hlášení, a pro každé rozhoduje, zda má mít šablonu vyžadující školení. Teprve kompletní sada šablon dává jistotu, že chybějící školení se oznámí bez ohledu na to, kterou bránou osoba vešla.

Den 6: kontrola zatížení a sérií událostí

V závodě s více externími firmami je provoz karet v hodinách směny skokový. V závodě s větším počtem agentur práce může provoz přesáhnout 2 000 přiložení za pracovní den, proto musí integrace zvládat série událostí a opakování. Šestého dne IT na straně KD ověří, zda se po výpadku linky fronta hlášení odesílá postupně a zda opakování nezdvojují události.

Specifikace požaduje, aby systém KD posílal události v reálném čase s časem události z čtečky. Je to podmínka věrohodné evidence vstupů a pracovní doby.

Na straně InnerWeb je vhodné současně připravit kontrolní přehled pro ochranu, kde jsou hned vidět události z nových čteček. V prvních dnech produkčního provozu tak lze zachytit čtečku, která posílá data v jiném formátu než zbytek.

Den 7: co samotný webhook nedává

Samotný webhook s přiložením karty ještě nedává evidenci pracovní doby: potřebné je mapování událostí na vstupy a výstupy. Posledního dne týdne tým určí, zda mají přiložení plnit registr vstupů, a se specifikací dodavatele KD sepíše pravidla párování vstupů a výstupů a odmítání duplicit.

Přidanou hodnotou InnerWeb je propojení přiložení s účtem, školeními a oprávněními. Přiložení v KD říká jen to, že osoba prošla bodem, a InnerWeb odpovídá na otázku, zda na to měla podle požadavků závodu nárok.

Videomateriál

Často kladené otázky

Je k integraci nutné vyměnit čtečky karet?

Ne. InnerWeb nevyrábí ani nevyměňuje čtečky. Integruje se se stávajícím systémem KD, který přiložení posílá webhookem.

Co se stane, až token vyprší?

Volání bude odmítnuto. Token má omezenou dobu platnosti, proto by služba na straně KD měla token automaticky obnovovat z přihlašovacího endpointu.

Bude odmítnuto přiložení osoby, kterou systém nezná?

Ne. Systém založí účet a firmu z údajů v hlášení, proto musí být osobní údaje a název firmy konzistentní.

Máte systém KD a chcete přidat BOZP?

Domluvte si schůzku o integraci webhooku s vaším systémem řízení přístupu. Ověříme, jaká data posílá dodavatel a co je třeba nastavit na straně InnerWeb.

Pojďme si promluvit