Podział odpowiedzialności
InnerWeb odbiera zdarzenia przyłożenia karty z systemu kontroli dostępu przez webhook. Nie produkuje ani nie zastępuje czytników, więc po stronie integratora zostaje konfiguracja systemu KD, a po stronie InnerWeb powiązanie zdarzenia z osobą, jej kwalifikacjami i zezwoleniami.
Zdarzenia z czytników mogą być powiązane z kwalifikacjami, zezwoleniami, obecnością i ewidencją czasu pracy. To oznacza, że jedno odbicie karty może zasilić kilka procesów naraz, o ile tożsamość karty jest jednoznacznie przypisana do osoby.
Krok 1: uzgodnij kontrakt zdarzenia
Zacznij od krótkiego dokumentu kontraktu: jakie pola wysyła system KD, jaki jest format czasu, jak oznaczany jest kierunek i punkt kontroli. Na tym etapie nie wymyślamy formatu na życzenie: integrator opisuje, co jego system potrafi wysłać, a my mapujemy to na model zdarzenia.
Minimum, którego potrzebujemy do powiązania zdarzenia, to identyfikator karty, czas zdarzenia i identyfikator punktu kontroli. Reszta, na przykład kierunek, ułatwia lokalizację, ale nie jest warunkiem startu.
- Identyfikator karty w stabilnym formacie.
- Czas zdarzenia ze strefą czasową.
- Identyfikator czytnika lub punktu kontroli.
- Kierunek wejścia lub wyjścia, jeśli system go zna.
Etapy integracji webhooka a typowy nakład (przykład)
Krok 2: przypisz karty do osób
Webhook jest bezużyteczny bez tabeli przypisań: który identyfikator karty należy do której osoby. Przypisania powinny pochodzić z jednego źródła, najlepiej z systemu kadrowego lub rejestracji, a nie z ręcznych list integratora.
Karty szyfrowane nie zmieniają tego kroku, ale zmieniają to, co widać po stronie integracji: identyfikator może być pochodną klucza zarządzanego w systemie KD. Ważne, by identyfikator wysyłany w webhooku był tym samym, który zapisano w przypisaniu.
Karty zgubione i zastępcze
Zgubioną kartę zablokuj w systemie KD, a w InnerWeb zachowaj zapis, aby wcześniejsze zdarzenia zostały przypisane właściwej osobie.
Karty tymczasowe
Dla gości i wykonawców karty tymczasowe wymagają jawnego początku i końca przypisania, inaczej kolejne osoby odziedziczą cudze kwalifikacje.
Krok 3: bezpieczeństwo i niezawodność
Webhook powinien mieć uwierzytelnienie, na przykład wspólny sekret lub podpis, oraz ograniczenie źródła do sieci integratora. Transmisja w obrębie sieci OT wymaga uzgodnienia z działem IT, więc zaplanuj to z wyprzedzeniem, a nie w dniu uruchomienia.
Zdarzenia wychodzące z InnerWeb do systemów zewnętrznych trafiają do kolejki typu outbox, a ponowienie dostarczenia jest możliwe, gdy system odbierający jest chwilowo niedostępny. Ten sam wzorzec zaleca się po stronie systemu KD: kolejka z ponowieniami zamiast jednej próby.
Krok 4: test odbiorczy
Test zaczyna się od jednego zdarzenia z jednej karty testowej, którą wskazuje klient. Sprawdź, czy zdarzenie pojawia się w InnerWeb przy właściwej osobie i czy zmienia się status zezwolenia lub obecności.
Potem test obciążeniowy: seria zdarzeń w krótkim czasie, na przykład zmiana wchodząca przez bramkę. Na końcu test awarii: przerwa łączności i dostarczenie zaległych zdarzeń po jej zakończeniu.
Co przekazać zamawiającemu po odbiorze
Zamawiający powinien dostać krótką dokumentację: kontrakt, schemat przepływu, listę punktów kontroli i procedurę na wypadek awarii. Bez niej każda wymiana czytnika wymaga ponownej analizy.
Zapisz także, kto jest właścicielem przypisań kart. To pytanie wraca po roku, gdy zmienia się dostawca systemu KD.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Czy InnerWeb dostarcza czytniki kart?
Nie. InnerWeb jest producentem oprogramowania i nie produkuje ani nie zastępuje czytników.
Czy webhook musi iść z systemu KD bezpośrednio?
Zdarzenia przyjmujemy od systemu KD. Pośrednik w sieci OT jest dopuszczalny, jeśli zachowuje czas i identyfikator karty.
Co z zaległymi zdarzeniami po awarii?
Zalecamy kolejkę z ponowieniami po stronie KD. Po stronie InnerWeb obowiązuje analogiczny wzorzec dla zdarzeń wychodzących.
Do czego służą zdarzenia po integracji?
Do powiązania z kwalifikacjami, zezwoleniami, obecnością i ewidencją czasu pracy.
Integrujecie KD z zezwoleniami?
Wyślemy kontrakt zdarzenia i listę pytań do dostawcy systemu KD, a przejdziemy z Wami test odbiorczy.
Porozmawiajmy