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ę
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