InnerWeb
Přejít na obsah

Webhook z čteček KD a fronta outbox: doporučení pro architekta IT

Událost přiložení karty má význam jen tehdy, když dorazí tam, kde se má použít, a průmyslová síť bývá přerušovaná. Doporučení níže ukazují architektovi IT, jak navrhnout příjem událostí ze systému řízení přístupu přes webhook a jak využít frontu outbox, aby žádná událost nezanikla při dočasné nedostupnosti příjemce.

62
událostí za hodinu při 1500 přiložení denně
Zdroj: ilustrativní kalkulace
125
událostí k obnovení po 2 hodinách přerušení
Zdroj: ilustrativní kalkulace

Pro koho a jaký problém řešíme

Doporučení jsou určena architektovi IT nebo integrátorovi, který propojuje stávající systém řízení přístupu závodu se softwarem InnerWeb. InnerWeb je výrobcem softwaru a nevyrábí ani nenahrazuje čtečky: přijímá události přiložení karty ze systému KD přes webhook, zatímco čtečky, řadiče a karty zůstávají na straně závodu a jeho dodavatele systému KD.

Problém je praktický. Chemický závod má síť rozdělenou na segmenty, systém KD běží v jednom, aplikace v jiném a mezi nimi stojí firewall. Spojení bývá nedostupné během aktualizací, přetížení nebo síťových prací. Každá událost, která se v té době ztratí, je potenciální mezerou v evidenci přítomnosti nebo docházky.

Doporučení 1: zvolte směr, systém KD posílá události

Události přiložení karty proudí od systému KD k InnerWeb přes webhook, tedy HTTP volání s daty události. Navrhněte to tak, aby dodavatel KD měl jedno místo pro nastavení adresy příjemce a jeden způsob ověřování volání.

Specifikaci události je vhodné předat dodavateli KD ve formě krátkého dokumentu: identifikátor karty nebo osoby, identifikátor čtečky, směr a čas události. Čím méně polí, tím menší riziko nesouladu na straně dodavatele.

Narůstání nevyřízených událostí při přerušení spojení

Narůstání nevyřízených událostí při přerušení spojeníSpojnicový graf: 0, 62, 125 a 187 nevyřízených událostí po jednotlivých hodinách přerušení.050100150200událostí0 h1 h2 h3 h0 h: 0 událostí01 h: 62 událostí622 h: 125 událostí1253 h: 187 událostí187
Zdroj: Ilustrativní kalkulace: 1500 přiložení denně, rovnoměrný provoz

Doporučení 2: počítejte s přerušováním spojení

Navrhujte příjem tak, jako by k přerušení sítě mělo dojít. Fronta webhooků typu outbox funguje tak, že odchozí události se nejprve trvale uloží a teprve potom doručí. Pokud je přijímací systém dočasně nedostupný, událost lze zopakovat, protože nebyla ztracena.

Týká se to událostí odcházejících z InnerWeb, například poplachových oznámení. U příchozích událostí ze systému KD je otázkou pro dodavatele, zda jeho systém události ukládá do vyrovnávací paměti a opakuje volání, když příjemce neodpovídá. Je to jedno z klíčových ustálení ve specifikaci integrace.

Doručení není okamžité

Při práci za izolací sítě závisí doručení na četnosti dotazování fronty, takže uživatelům nelze slibovat, že poplach dorazí ve stejné sekundě. Přípustné zpoždění je třeba určit a popsat v dokumentaci nasazení.

Doporučení 3: síť bez odchozího provozu není překážkou

Pokud síť závodu blokuje veškerý odchozí provoz z hostitele aplikace, poplachové webhooky se trvale ukládají a externí poller je přebírá přes funkční příchozí kanál a předává dál. Poplach se neztrácí ani bez otevírání odchozího provozu. To je důležité pro týmy OT, které nechtějí otevírat další pravidla firewallu.

Doporučujeme tuto variantu projednat s bezpečnostním oddělením již ve fázi návrhu, protože mění rozložení odpovědnosti: poller je prvek, který někdo musí udržovat a monitorovat.

Doporučení 4: monitorujte frontu, nejen službu

Fronta bez monitoringu je tichá porucha. Stanovte ukazatele: počet čekajících událostí, stáří nejstarší události a počet opakování. Událost, která se do fronty vrací opakovaně, signalizuje, že příjemce data nepřijímá nebo že mají chybný formát.

V aktuální implementaci se neúspěšné doručení v režimu fronty vrací do čekajícího stavu a opakuje se, mechanismy zpoždění opakování a limitu pokusů je třeba při návrhu vyhodnotit. Proto je alarm na stáří nejstarší události důležitější než čítač chyb.

Doporučení 5: propojte události KD s tím, k čemu slouží

Události z čteček karet mohou být propojeny s kvalifikacemi, povoleními, přítomností a evidencí pracovní doby. Před návrhem toku zapište, která z těchto použití spadají do rozsahu. Přítomnost vyžaduje jinou spolehlivost než statistika a evidence pracovní doby jinou přesnost než seznam vstupů.

Osvědčeným přístupem je začít jedním použitím, například propojením přiložení karty se seznamem osob přítomných v areálu, a teprve potom rozšiřovat.

  • Vymezte rozsah událostí: vstupy, výstupy, odmítnutí.
  • Dohodněte s dodavatelem KD formát a ověřování volání.
  • Určete přípustné zpoždění doručení.
  • Vybudujte monitoring stáří nejstarší události ve frontě.
  • Otestujte přerušení spojení v testovacím prostředí.

Ilustrativní kalkulace: kolik událostí se nashromáždí během přerušení

Při předpokladu 1500 přiložení karet denně v závodě s několika branami a třemi směnami vychází v průměru přibližně 62 událostí za hodinu. Přerušení spojení trvající 2 hodiny znamená přibližně 125 událostí k obnovení. Jde o ilustrativní kalkulaci: ve skutečnosti je provoz soustředěn na začátek a konec směn, takže fronta může události nabírat rychleji. Je důležité otestovat scénář přerušení v době špičky.

Příklad výpočtu

Události KD během přerušení spojení

Předpoklady
ParametrHodnota
Přiložení karet denně1500 událostí
Doba přerušení2 hodiny
Rozložení provozurovnoměrné předpoklad

Výsledek: přibližně 125 událostí k obnovení po 2 hodinách přerušení

Poznámka: Ilustrativní kalkulace; skutečný provoz je nerovnoměrný a soustředěný na přechod mezi směnami.

Videomateriál

Často kladené otázky

Dodává InnerWeb čtečky karet?

Ne. InnerWeb je výrobcem softwaru a čtečky a karty zůstávají na straně závodu a dodavatele systému KD.

Zaručuje fronta outbox okamžité doručení?

Ne. Zaručuje, že událost nezanikne a lze ji zopakovat. Doba doručení závisí na dotazování a dostupnosti příjemce.

Co se sítí bez odchozího provozu?

Webhooky se ukládají trvale a externí poller je přebírá přes příchozí kanál a předává dál.

K čemu lze události KD využít?

K propojení s kvalifikacemi, povoleními, přítomností a evidencí pracovní doby, podle zvoleného rozsahu.

Navrhněte integraci se systémem KD

Připravíme specifikaci událostí pro vašeho dodavatele KD a naplánujeme odolnost vůči přerušení sítě. Domluvte si rozhovor s týmem InnerWeb.

Pojďme si promluvit