Co přenášíme a proč
InnerWeb přijímá události odbití karty z existujícího systému KD přes webhook a spojuje je s kvalifikacemi, oprávněními, přítomností a evidencí pracovní doby. Systém KD zůstává vlastníkem čteček a rozhodnutí o otevření průchodu. InnerWeb je nezávislý doplňující systém, takže nenahrazuje KD, evidenci pracovní doby, HR ani ERP.
Platforma nabízí REST API ve verzích 1 a 2 s autorizací JWT a webhooky do automatizační platformy, kde pravidla typu když-tak mohou webhook vyvolat po události. Pro integraci KD je důležitější opačný směr: událost posílá KD.
Ujednání s dodavatelem KD
Specifikace pro dodavatele by měla být jeden dokument. Podle tohoto vzoru byla u výrobce obalů vytvořena integrace odbití z KD do evidence pracovní doby, bez čteček InnerWeb.
- Formát události: identifikátor karty, kontrolní bod, směr, časové razítko se zónou.
- Způsob ověření volání, například token v hlavičce.
- Chování při chybě: opakované odeslání, odstupy, limit pokusů.
- Kdo udržuje odesílání na straně dodavatele a jak se hlásí výpadek.
- Zda se posílají i události z odmítnutých odbití.
Příklad doby dohodnutí před spuštěním (pracovní dny)
Ujednání se sítí OT
Výrobní sítě často blokují odchozí provoz z hostitele aplikace. Tato varianta má hotové řešení: pokud síť zákazníka blokuje odchozí provoz z hostitele aplikace, webhooky se trvale ukládají do fronty a přebírá je poller přes příchozí kanál. Události se neztratí a tým OT nemusí otevírat nová odchozí spojení.
S OT ujednejte tři věci: segment sítě, ze kterého KD posílá události, pravidla firewallu pro adresu příjemce a servisní okno pro změny. Také určete, kdo schvaluje výjimku z politiky, protože to bývá nejdelší etapa.
Pořadí prací
Dobré pořadí omezuje riziko zastavení provozu: nejdřív testovací prostředí s odbitími testovací karty, potom jedna brána, potom ostatní. V každé etapě ověřte zpoždění, úplnost a shodu identifikátoru karty s účtem osoby.
Při opakovaném odeslání událostí po výpadku má systém rozpoznávat duplicity. Ujasněte si s dodavatelem, zda má událost jedinečný identifikátor, protože bez něj by opakování zapsalo stejný vstup dvakrát.
Past při nasazení
První je nesoulad časových pásem: událost v UTC načtená jako místní čas posune přítomnost o hodinu nebo dvě. Druhá je chybějící účet pro kartu: odbití přijde, ale není k čemu ho připojit. Třetí je předpoklad, že šifrovaná karta řeší oprávnění: ověřuje totožnost nosiče a o vstupu rozhodují oprávnění na straně systému. Čtvrtá je chybějící monitoring ticha: integrace bez událostí hodinu uprostřed dne je signál poruchy, ne klid.
Videomateriál
Často kladené otázky
Co když síť OT blokuje odchozí provoz?
Webhooky se trvale ukládají do fronty a poller je přebírá přes příchozí kanál. Události se neztratí a OT neotevírá nová odchozí spojení.
Je potřeba API kromě webhooku?
Ne vždy. Platforma nabízí REST API v1 a v2 s JWT, které lze doplnit, pokud dodavatel KD podporuje obousměrnou integraci.
Kdo odpovídá za výpadek odesílání?
Strany to určí ve specifikaci: dodavatel KD odpovídá za odesílání a řídicí jednotky, IT a OT za síť a InnerWeb za přijetí a zpracování událostí.
Zdroje
Domluvme webhook s vaším dodavatelem
Připravíme specifikaci událostí a pomůžeme ji uzgodnit s IT a týmem OT. Domluvte si rozhovor s týmem InnerWeb.
Pojďme si promluvit