Kierunek połączenia i porty
Czy trzeba otworzyć port przychodzący w sieci zakładu? Nie. Przy każdym odbiciu serwer systemu KD wysyła do InnerWeb komunikat HTTPS POST, więc połączenie jest wychodzące z sieci zakładu. Dla zespołu IT/OT oznacza to regułę zapory dla ruchu wychodzącego na jeden adres i port 443, bez wystawiania serwera KD do internetu.
Czy migracja kart zmienia ten układ? Nie, bo zmienia się nośnik i numer karty, a nie kanał zdarzeń. Jeżeli wraz z kartami wymieniane są czytniki i kontrolery, wystarczy sprawdzić, czy serwer KD po aktualizacji nadal potrafi wysyłać HTTPS POST.
Uwierzytelnienie i token JWT
Jak system KD uwierzytelnia się wobec InnerWeb? Integracja używa konta technicznego i tokenu JWT o ograniczonym czasie ważności, odnawianego automatycznie przez integrację. Po stronie dostawcy KD musi więc działać odnawianie tokenu albo logowanie przed każdą serią wysyłek.
Warto ustalić z dostawcą KD, jak obsługuje wygaśnięcie tokenu w nocy lub w weekend. Dobrym testem odbiorczym jest wstrzymanie odnowienia i sprawdzenie, czy wysyłka wraca bez utraty zdarzeń po ponownym zalogowaniu.
Wymagania specyfikacji integracji odbić
Zawartość komunikatu i numer karty
Co powinien zawierać komunikat? Specyfikacja integracji wymaga czasu odbicia z czytnika, identyfikatora czytnika, osoby, numeru karty w postaci kod_obiektu-numer, kierunku (wejście lub wyjście) oraz identyfikatora zdarzenia. Po migracji numer karty ma nowe wartości, więc przed uruchomieniem fali trzeba dostarczyć eksport kart (kod obiektu i numer) powiązany z numerem kadrowym.
Jak traktowane są wejścia i wyjścia? System KD wysyła zdarzenia w czasie rzeczywistym wraz z kierunkiem, a InnerWeb przyjmuje je przez uwierzytelniony webhook. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD. Jeżeli czytniki w systemie KD klienta nie rozróżniają kierunku, jest to fakt techniczny po stronie KD, który trzeba uwzględnić w tej specyfikacji. Po wymianie czytników zaktualizuj słownik czytników, w którym osobne czytniki opisuje się jako wejście i wyjście.
Czas z kontrolera i idempotencja
Dlaczego liczy się czas z czytnika, a nie czas odbioru? System KD wysyła zdarzenia w czasie rzeczywistym, z czasem zdarzenia z czytnika. Dzięki temu kolejka offline lub ponowna wysyłka po awarii łącza nie przesuwa odbić: opóźnione odbicie trafia w swoją godzinę, a identyfikator zdarzenia pozwala odrzucić duplikaty zgodnie z regułami uzgodnionymi w specyfikacji.
W praktyce oznacza to jeden wymóg dla dostawcy KD: każde zdarzenie musi mieć stabilny identyfikator, który nie zmienia się przy ponownej wysyłce. Po migracji kontrolerów warto to sprawdzić, bo nowy firmware może generować identyfikatory inaczej.
Co zostaje po stronie InnerWeb, a co po stronie KD
Całe przetwarzanie, czyli rozpoznanie wejścia i wyjścia, łączenie w dni pracy, grafiki, wyjątki i raporty, odbywa się po stronie InnerWeb, a logika KD zostaje bez zmian. Dział IT/OT nie musi więc przenosić reguł rozliczania do systemu KD ani odwrotnie.
Odbicie nieznanej karty trafia do kolejki karty do przypisania zamiast zakładać konto z nieznanego odbicia. Dzięki temu pierwsza fala nowych kart, która nie została jeszcze powiązana z osobami, nie tworzy kont i nie wprowadza zamieszania w ewidencji.
Materiał wideo
Często zadawane pytania
Czy po wymianie kart trzeba ponownie wdrażać integrację?
Nie. Kanał HTTPS POST i uwierzytelnienie zostają. Zmienia się numer karty i eksport kart do numeru kadrowego, który wczytuje się do InnerWeb importem CSV.
Co zrobić, gdy dostawca KD nie wysyła HTTPS POST?
To pierwsze pytanie do ustalenia przed integracją: czy serwer KD obsługuje wysyłkę HTTPS POST. Razem z nim ustala się listę czytników i format eksportu kart.
Czy zdarzenia z kolejki offline nie rozregulują dni pracy?
Nie, o ile komunikat niesie czas z czytnika i identyfikator zdarzenia. Zasady odrzucania duplikatów ustala się w specyfikacji z dostawcą KD.
Czy InnerWeb widzi numer karty w sposób jawny?
Numer karty ma postać kod_obiektu-numer i służy do powiązania z osobą. W wyszukiwarce konta w module szkoleń numer karty nie jest ujawniany.
Źródła
Sprawdźmy integrację odbić przed migracją
Przejdziemy z waszym działem IT/OT i dostawcą KD przez listę ustaleń: wysyłka, token, czytniki i eksport kart. Dzięki temu po wymianie kart dni pracy zostaną bez dziur.
Porozmawiajmy