InnerWeb
Przejdź do treści

Strefy czasowe w kontroli dostępu: zalecenia dla działu IT

Dział IT lub OT, który zamawia strefy czasowe u dostawcy kontroli dostępu, powinien opisać je tak, aby każde odbicie wysłane do InnerWeb dało się jednoznacznie zinterpretować. Poniżej zalecenia dotyczące kierunków czytników, nazw miejsc odbicia, uwierzytelnienia webhooka i odporności na serie zdarzeń.

5 s
okno ignorowania powtórnego skanu kodu w stacji rejestracji
Źródło: karta komórki
2 000+
odbić na dobę roboczą w zakładzie z wieloma agencjami
Źródło: karta komórki

Dla kogo i po co ten opis

Zalecenia kierujemy do działu IT lub OT oraz do integratora, który rozmawia z dostawcą systemu KD. InnerWeb nie produkuje ani nie wymienia czytników kontroli dostępu: integruje się z istniejącym systemem KD klienta jako niezależny system uzupełniający obok KD, RCP, HR i ERP. Dlatego jakość danych zależy od tego, jak dokładnie strefy i czytniki opisano po stronie KD.

Dobry opis strefy czasowej odpowiada na cztery pytania: kto, gdzie, kiedy i w którą stronę. Brak odpowiedzi na ostatnie pytanie jest najczęstszą przyczyną problemów z raportami.

Zalecenie 1: kierunek na każdym czytniku

Reguły stref czasowych i harmonogramów zmian wymagają, aby czytniki w obu kierunkach przejścia raportowały kierunek wejście lub wyjście. Bez tego anti-passback nie ma na czym działać, a raport nie rozróżni spóźnionego wejścia od wyjścia przed końcem zmiany.

W zamówieniu dla dostawcy należy wymienić każde przejście z osobnym czytnikiem wejściowym i wyjściowym. Jeśli któraś brama ma jeden czytnik obsługujący oba kierunki, trzeba ustalić, jak kontroler odróżnia kierunek, i zapisać to w specyfikacji.

Przykładowe odnowienia tokenu na dobę

Przykładowe odnowienia tokenu na dobęWykres słupkowy: liczba odnowień tokenu na dobę przy odstępach 24, 12 i 6 godzin to odpowiednio 1, 2 i 401234odnowieńCo 24 godziny: 1 odnowień1Co 24 godzinyCo 12 godzin: 2 odnowień2Co 12 godzinCo 6 godzin: 4 odnowień4Co 6 godzin
Źródło: Kalkulacja przykładowa: 24 godziny podzielone przez przyjęty odstęp odnowienia tokenu

Zalecenie 2: stabilne nazwy miejsc odbicia

Pole miejsca odbicia rozróżnia lokalizacje czytników. Zdarzenia z miejsca, które nie ma w InnerWeb odpowiadającego mu szablonu, trafiają do logu i nie uruchamiają alarmu szkoleniowego. Dlatego nazwy miejsc powinny być stałe, unikalne i uzgodnione z zespołem, który konfiguruje InnerWeb.

Zmiana nazwy czytnika po stronie KD bez informacji dla InnerWeb jest jednym z najczęstszych powodów, dla których odbicia przestają uruchamiać reguły. Zalecamy rejestr zmian nazw prowadzony przez dział IT.

Zalecenie 3: uwierzytelnienie i odnawianie tokenu

Wywołanie webhooka wymaga tokenu z endpointu logowania API. Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację, więc po stronie KD nie potrzeba ręcznych czynności. Zalecamy, aby integracja odnawiała token z zapasem, a nie dopiero po odmowie.

Warto ustawić w systemie monitoringu IT alarm na serię odpowiedzi odmownych z endpointu, tak aby problem z uwierzytelnieniem był widoczny, zanim dotknie nocnej zmiany.

Zalecenie 4: odporność na serie i powtórzenia

W zakładzie z wieloma agencjami pracy ruch kartowy może przekraczać 2 000 odbić na dobę roboczą, a większość z nich przypada na kilka minut przed początkiem zmiany. Webhook musi być odporny na serie zdarzeń i powtórzenia.

Po stronie KD zalecamy kolejkę z ponawianiem, a po stronie odbiorcy odrzucanie powtórzeń. Dla podwójnego skanu kodu w stacji rejestracji InnerWeb ignoruje drugi skan w ciągu 5 sekund, ale to inna ścieżka niż webhook karty KD, więc zasady antyduplikatowe trzeba uzgodnić osobno w specyfikacji z dostawcą KD.

Wymagania wobec zdarzeń z systemu KD

W specyfikacji integracji przyjmujemy, że system KD wysyła zdarzenia w czasie rzeczywistym. Każde zdarzenie niesie czas z czytnika, kierunek (wejście lub wyjście), miejsce odbicia oraz identyfikator zdarzenia. InnerWeb przyjmuje je przez uwierzytelniony webhook, a odbicia zasilają ewidencję czasu pracy i listy obecności.

Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji razem z dostawcą KD. Dzięki temu obie strony wiedzą, który czas jest wiążący, jak traktować brakujące wyjście i co zrobić z powtórzonym zdarzeniem po ponowieniu wysyłki.

Odbicie karty w KD mówi tylko, że osoba przeszła przez punkt. Gdzie jest po przejściu, pokazuje lokalizacja na mapie i lista ewakuacyjna w InnerWeb, więc nie należy oczekiwać tej informacji od samego KD.

Jeśli któryś czytnik w systemie KD klienta nie rozróżnia kierunku, jest to fakt techniczny po stronie KD. Należy wtedy ustalić z dostawcą, jak kontroler wskazuje kierunek, i zapisać to w specyfikacji, zanim ruszy integracja.

Parametry SLA, czyli dostępność, czasy reakcji i naprawy, ustala się w umowie utrzymaniowej, na przykład dostępność 99,5% w miesiącu. Zalecamy opisać je przed uruchomieniem integracji, razem z osobą odpowiedzialną po stronie działu IT.

Lista kontrolna do dostawcy

Poniższe punkty warto przesłać dostawcy KD jako załącznik do zamówienia.

  • Kierunek wejście lub wyjście na każdym czytniku
  • Stałe, unikalne nazwy miejsc odbicia
  • Format zdarzenia z polami czasu z czytnika, kierunku, karty, miejsca i identyfikatora zdarzenia
  • Token o ograniczonym czasie ważności, odnawiany automatycznie przez integrację
  • Kolejka i ponawianie przy braku odpowiedzi
  • Zasady parowania wejść i wyjść oraz odrzucania duplikatów
  • Rejestr zmian nazw czytników

Materiał wideo

Często zadawane pytania

Kto konfiguruje strefy czasowe?

Strefy czasowe i harmonogramy ustawia się w systemie KD klienta. InnerWeb przyjmuje odbicia webhookiem i nie zmienia konfiguracji kontrolerów.

Co się stanie z odbiciem z nieznanego miejsca?

Zdarzenie z miejsca bez szablonu w InnerWeb trafia do logu i nie uruchamia alarmu szkoleniowego.

Czy webhook przenosi kierunek przejścia?

Zgodnie ze specyfikacją integracji system KD wysyła zdarzenia z czasem z czytnika, kierunkiem wejście lub wyjście i identyfikatorem zdarzenia. Zasady parowania i odrzucania duplikatów ustala się z dostawcą KD.

Źródła

Przygotujmy specyfikację dla dostawcy KD

Przejdziemy z Państwa działem IT przez format odbić, nazwy miejsc i odnawianie tokenu, zanim dostawca zacznie konfigurację.

Porozmawiajmy