Punkt wyjścia: zakład, który ma KD i nie chce go ruszać
Koncepcja dotyczy zakładu produkcyjnego typu średniego, który od lat korzysta z systemu kontroli dostępu na kartach. Czytniki wiszą przy bramie, w szatniach i przy wejściach na halę, a dostawca KD odpowiada za ich serwis. Ochrona widzi, że karta jest ważna, ale nie widzi, czy jej posiadacz ma ważne szkolenie wstępne BHP i czy firma zewnętrzna ma prawo wejść na teren.
InnerWeb jest producentem oprogramowania, nie czytników. Nie produkuje i nie wymienia urządzeń kontroli dostępu, tylko integruje się z istniejącym systemem KD jako niezależny system uzupełniający obok KD, RCP, HR i ERP. To założenie ustawia cały projekt: nie ma wymiany sprzętu, nie ma przestoju bram, jest jedna integracja po stronie oprogramowania.
Punktem styku jest webhook odbicia karty. System KD wysyła do InnerWeb żądanie HTTP POST przy każdym odbiciu, a InnerWeb przyjmuje je jako zdarzenie i łączy z kontem osoby, jej szkoleniami, kwalifikacjami i firmą.
Dzień 1: uwierzytelnienie i pierwszy komunikat testowy
Pierwszego dnia integrator po stronie KD uzyskuje dostęp do API InnerWeb. Wywołanie webhooka wymaga tokenu, który pobiera się z endpointu logowania API. Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację. W praktyce usługa po stronie KD musi odnawiać token regularnie albo przed każdą serią zgłoszeń.
Typowy błąd pierwszego dnia to zapisanie tokenu na stałe w konfiguracji skryptu. Token wygasa po określonym czasie, więc taka integracja zadziała na początku, a potem zgłoszenia zaczną być odrzucane. Dobry wzorzec to krótka procedura logowania uruchamiana przy kodzie odpowiedzi odrzucającym autoryzację.
Pierwszy komunikat testowy powinien dotyczyć jednej, znanej osoby z kartą. Ochrona sprawdza w InnerWeb, czy odbicie pojawiło się przy właściwym koncie, i dopiero wtedy włącza ruch produkcyjny.
Skala i zakres zdarzeń w integracji odbić
Dni 2–3: dane osoby i firmy w zgłoszeniu
Zgodnie ze specyfikacją system KD wysyła w zgłoszeniu odbicia czas zdarzenia z czytnika, kierunek (wejście lub wyjście), identyfikator zdarzenia, miejsce odbicia i dane osoby: imię i nazwisko (wymagane), akronim, firmę (nazwa wymagana), numer aktywnej karty, telefon, e-mail i język. Numer aktywnej karty jest identyfikatorem, po którym InnerWeb łączy odbicie z kontem osoby, a firma zewnętrzna jest przypisywana na podstawie nazwy firmy ze zgłoszenia.
Drugi i trzeci dzień to czas na sprawdzenie, kto się w systemie pojawia. Odbicie karty przez osobę, której InnerWeb nie zna, zakłada konto i firmę z danych zgłoszenia. Jeśli ta sama firma jest w KD zapisana raz jako pełna nazwa, a raz w skrócie, w systemie powstaną dwie firmy. Dlatego w tym oknie czasowym ochrona i HR porównują listę firm w KD z listą firm w InnerWeb i ujednolicają pisownię u źródła.
- porównanie nazw firm w KD i w InnerWeb
- sprawdzenie, czy każda osoba ma numer aktywnej karty
- kontrola, czy pole języka jest wypełnione dla osób zagranicznych
Dni 4–5: miejsca odbicia i alarm szkoleniowy
Pole miejsca odbicia rozróżnia lokalizacje czytników. Zdarzenia z miejsca, które nie ma w InnerWeb zdefiniowanego szablonu, trafiają do logu i nie uruchamiają alarmu szkoleniowego. To najczęstsze zaskoczenie czwartego dnia: czytnik przy bramie głównej działa jak trzeba, a czytnik przy bramie dostawczej wpisuje się w log i nie uruchamia żadnej reakcji.
Ochrona przegląda więc listę wszystkich miejsc, z których przychodzą zgłoszenia, i dla każdego decyduje, czy ma mieć szablon wymagający szkolenia. Dopiero komplet szablonów daje pewność, że brak szkolenia jest zgłaszany niezależnie od tego, którą bramą osoba weszła.
Dzień 6: sprawdzenie obciążenia i serii zdarzeń
W zakładzie z kilkoma firmami zewnętrznymi ruch kartowy w godzinach zmiany jest skokowy. W zakładzie z wieloma agencjami pracy ruch może przekraczać 2 000 odbić na dobę roboczą, więc integracja musi być odporna na serie zdarzeń i powtórzenia. Szóstego dnia IT po stronie KD sprawdza, czy po awarii łącza kolejka zgłoszeń jest wysyłana po kolei i czy ponowienia nie powielają zdarzeń.
Specyfikacja wymaga, aby system KD wysyłał zdarzenia w czasie rzeczywistym, z czasem zdarzenia z czytnika. To warunek wiarygodnej ewidencji wejść i czasu pracy.
Po stronie InnerWeb warto równolegle przygotować widok kontrolny dla ochrony, w którym od razu widać zdarzenia z nowych czytników. Pozwala to w pierwszych dniach ruchu produkcyjnego wychwycić czytnik, który wysyła dane w innym formacie niż reszta.
Dzień 7: czego sam webhook nie daje
Sam webhook z odbiciem karty nie daje jeszcze rejestracji czasu pracy: potrzebne jest mapowanie zdarzeń na wejścia i wyjścia. Ostatniego dnia tygodnia zespół ustala, czy odbicia mają zasilać rejestr wejść, i spisuje ze specyfikacją dostawcy KD zasady parowania wejść i wyjść oraz odrzucania duplikatów.
Wartością dodaną InnerWeb jest połączenie odbicia z kontem, szkoleniami i zezwoleniami. Odbicie w KD mówi tylko, że osoba przeszła przez punkt, a InnerWeb odpowiada na pytanie, czy mogła to zrobić zgodnie z wymogami zakładu.
Materiał wideo
Często zadawane pytania
Czy do integracji trzeba wymienić czytniki kart?
Nie. InnerWeb nie produkuje ani nie wymienia czytników. Integruje się z istniejącym systemem KD, który wysyła odbicia webhookiem.
Co się stanie, gdy token wygaśnie?
Wywołanie zostanie odrzucone. Token ma ograniczony czas ważności, dlatego usługa po stronie KD powinna go odnawiać automatycznie z endpointu logowania.
Czy odbicie osoby nieznanej systemowi zostanie odrzucone?
Nie. System zakłada konto i firmę z danych zgłoszenia, dlatego dane osobowe i nazwa firmy muszą być spójne.
Masz system KD i chcesz dołożyć BHP?
Umów rozmowę o integracji webhooka z Twoim systemem kontroli dostępu. Sprawdzimy, jakie dane wysyła dostawca i co trzeba ustawić po stronie InnerWeb.
Porozmawiajmy