InnerWeb
Przejdź do treści

Poradnik: podpięcie czytnika KD do zezwoleń przez webhook

Integrator systemu kontroli dostępu pyta zwykle o jedno: co mam wysłać i jak mam to wysłać, żeby zdarzenie z czytnika uruchomiło sprawdzenie zezwolenia. InnerWeb jest producentem oprogramowania, nie urządzeń, więc czytniki zostają Wasze. Poniżej kroki integracji przez webhook, od kontraktu po odbiór.

3
minimalne pola zdarzenia: karta, czas, punkt
Źródło: kalkulacja przykładowa
4
kroki integracji do odbioru
Źródło: kalkulacja przykładowa

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)

Etapy integracji webhooka a typowy nakład (przykład)Wykres słupkowy: kontrakt 1 dzień, przypisania 2, bezpieczeństwo 2, testy 2 dni robocze.012dni roboczeKontrakt: 1 dni robocze1KontraktPrzypisania kart: 2 dni robocze2Przypisania kartBezpieczeństwo i sieć: 2 dni robocze2Bezpieczeństwo i siećTesty odbiorcze: 2 dni robocze2Testy odbiorcze
Źródło: Kalkulacja przykładowa: założenia planistyczne, nie dane projektu

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