Pro koho je tento text
Pro integrátora, který vede nasazení v závodě, a pro dodavatele systému KD, který má nastavit odesílání událostí. Text popisuje model integrace, nikoli technickou specifikaci konkrétního produktu: pole a formát se dohodnou individuálně s dodavatelem a týmem závodu.
Hranice: co InnerWeb nedělá
InnerWeb je výrobcem softwaru a nevyrábí čtečky kontroly přístupu. Integruje se se systémem KD zákazníka tak, že přijímá události přiložení karty webhookem a spojuje je s kvalifikacemi, povoleními a přítomností. Závod tedy nevyměňuje karty, čtečky ani kontroléry a dodavatel KD si zachovává svou roli: odpovídá za zařízení, firmware, klíče a jejich správu.
Tato hranice je zapsána v implementační smlouvě, aby na straně závodu nikdo neočekával od nás zásahy do čteček.
Příklad: počet polí události a riziko nesouladu
Zdroj pravdy o události
Přiložení karty ke čtečce je skutečnost na straně KD. Přijímáme ji tak, jak byla odeslána: časové razítko, identifikátor karty a místo přiložení, případně směr. Událost neopravujeme ani nevyvozujeme, že se čtečka spletla. Pokud KD přiložení zaznamenal a InnerWeb na něj nereaguje, rozdíl diagnostikujeme na obou stranách: nejdříve ověříme, zda událost dorazila, a potom jak byla přiřazena k osobě.
Událost se poté spojuje s daty InnerWeb: kvalifikacemi, povolením nebo návštěvou, prohlášením a školením. V chemicko-farmaceutickém závodě je to právě místo, kde brána prohlášení přidává ke přiložení požadavek: pokud prohlášení chybí, systém vstup nezapíše.
Rozsah událostí k dohodě
S dodavatelem domluvte krátkou sadu polí. Doporučujeme: identifikátor karty (nebo jeho šifrovanou podobu podle technologie karty), časové razítko v dohodnutém pásmu, identifikátor místa přiložení a směr. Více polí zvyšuje riziko nesouladu a zátěž sítě a nezlepšuje rozhodnutí brány.
Dohodněte také chování při opakování události: KD může odeslat stejné přiložení dvakrát, pokud nedostane potvrzení. Na straně InnerWeb má prohlášení jeden řádek na osobu a den, takže opakování nevytvoří duplikát prohlášení, ale chování pro všechny události je vhodné popsat ve specifikaci.
- Identifikátor karty nebo jeho šifrovaná podoba.
- Časové razítko a časové pásmo.
- Místo přiložení (komora, brána, dveře).
- Směr, pokud jej KD zná.
- Chování při opakovaném odeslání.
Komory: vstup, odchod a směr
V čistých zónách musí událost z čtečky u přechodové komory říkat, zda jde o vstup, nebo odchod. Prohlášení se vyžaduje výhradně při vstupu a osoba, která už je na území, může vždy odejít. Pokud čtečka směr nerozlišuje, měl by závod po straně KD zřídit oddělené body vstupu a odchodu; InnerWeb to nenahradí, protože vlastní čtečky nemá.
Přejímací zkoušky a odpovědnost
Před spuštěním týmy provedou zkoušky na společných scénářích: přiložení osoby s platným prohlášením, bez prohlášení, s návštěvou, po odchodu a se zopakovanou událostí. Výsledek zkoušky zapíší oba týmy. Dobré je také dohodnout, kdo první přijme hlášení o nesouladu: doporučujeme vlastníka integrace na straně závodu, který je předá příslušné straně.
Pokyny EU GMP (EudraLex, svazek 4) obsahují kapitolu o personálu a přílohu 1 ve znění platném od 25. srpna 2023. Systém KD ani InnerWeb tyto požadavky nemění; dodávají záznamy, které může závod ukázat při auditu.
Videomateriál
Často kladené otázky
Dodává InnerWeb čtečky?
Ne. Jsme výrobcem softwaru a integrujeme se se systémem KD zákazníka bez výměny čteček.
Kdo je zdrojem pravdy o přiložení karty?
Systém KD. InnerWeb událost přijímá webhookem a spojuje ji s kvalifikacemi, povoleními a přítomností.
Co když KD pošle událost dvakrát?
Chování při opakování popište ve specifikaci. Prohlášení má jeden řádek na osobu a den, takže se jeho duplikát nevytvoří.
Zdroje
Domluvme integraci s dodavatelem KD
Připravíme sadu polí události a scénáře přejímacích zkoušek pro společný rozhovor s dodavatelem systému KD.
Pojďme si promluvit