InnerWeb
Přejít na obsah

Webhook z KD do doplňujícího systému: provozní poznámky pro IT

Události odbití karet musí dorazit z KD do doplňujícího systému a cesta vede přes síť, kterou obvykle spravují oddělené týmy IT a OT. Níže seznam ujednání s dodavatelem KD a sítí OT, pořadí prací a úskalí, která nejčastěji oddalují spuštění.

2
verze REST API (v1 a v2, JWT)
Zdroj: karta

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)

Příklad doby dohodnutí před spuštěním (pracovní dny)Vodorovný graf: 5, 13, 5 a 8 pracovních dnů na další etapy dohodnutí051015dnůSpecifikace s dodavatelem KDSpecifikace s dodavatelem KD: 5 dnů5Výjimka v síti OTVýjimka v síti OT: 13 dnů13Testy na jedné bráněTesty na jedné bráně: 5 dnů5Ostatní brányOstatní brány: 8 dnů8
Zdroj: Příkladová kalkulace: ilustrativní předpoklady pro jeden závod

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