InnerWeb
Přejít na obsah

Průvodce: připojení čtečky KD k povolením přes webhook

Integrátor systému kontroly přístupu se obvykle ptá na jednu věc: co mám poslat a jak to mám poslat, aby událost z čtečky spustila kontrolu povolení. InnerWeb je výrobcem softwaru, ne zařízení, takže čtečky zůstávají vaše. Níže jsou kroky integrace přes webhook, od kontraktu po přejetí.

3
minimální pole události: karta, čas, bod
Zdroj: příkladová kalkulace
4
kroky integrace až k přejetí
Zdroj: příkladová kalkulace

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)

Etapy integrace webhooku a typická náročnost (příklad)Sloupcový graf: kontrakt 1 den, přiřazení 2, bezpečnost 2, testy 2 pracovní dny.012pracovní dnyKontrakt: 1 pracovní dny1KontraktPřiřazení karet: 2 pracovní dny2Přiřazení karetBezpečnost a síť: 2 pracovní dny2Bezpečnost a síťPřejímací testy: 2 pracovní dny2Přejímací testy
Zdroj: Příkladová kalkulace: plánovací předpoklady, nejde o údaje projektu

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