Kto czyta zdarzenia i kto dostarcza czytniki?
InnerWeb jest producentem oprogramowania i nie produkuje ani nie wymienia czytników kontroli dostępu. Czytniki, kontrolery i karty pozostają po stronie klienta i jego dostawcy KD. Nasz system przyjmuje zdarzenia odbicia karty z istniejącego systemu KD przez webhook i łączy je z kwalifikacjami, zezwoleniami, obecnością i ewidencją czasu pracy.
Dostawca KD otrzymuje od nas specyfikację zdarzenia odbicia. Dzięki temu nie musi poznawać wewnętrznej struktury naszego systemu, a zakład nie wymienia sprzętu bramowego.
Jak dostawca KD uwierzytelnia się w systemie?
Uwierzytelnienie odbywa się kontem technicznym i tokenem JWT. Token jest ważny 12 godzin, więc integracja musi odnawiać go przed wygaśnięciem albo po otrzymaniu odrzucenia z powodu przeterminowania.
Konto techniczne służy wyłącznie do wysyłania zdarzeń. Nie jest kontem pracownika i nie powinno mieć uprawnień do przeglądania danych osobowych.
- Osobne konto techniczne dla każdego systemu KD, żeby dało się je wyłączyć niezależnie.
- Odnawianie tokenu z zapasem czasu, nie w ostatniej minucie ważności.
- Przechowywanie danych logowania po stronie dostawcy KD w magazynie sekretów, nie w kodzie.
Parametry integracji odbić
Z czego składa się komunikat odbicia?
Komunikat zawiera czas odbicia zapisany przez kontroler, identyfikator czytnika, osobę i numer karty w postaci kod_obiektu-numer. Opcjonalnie dostawca podaje kierunek przejścia oraz identyfikator zdarzenia.
Czas pochodzi z kontrolera, a nie z chwili dotarcia komunikatu do nas. To ważne przy ewidencji czasu pracy: po awarii sieci kontroler może wysłać zaległe odbicia, a ich godzina nadal jest prawdziwa.
Numer karty w postaci kod_obiektu-numer
Kod obiektu odróżnia karty z różnych instalacji, które mogłyby mieć ten sam numer. System łączy kartę z kontem pracownika, więc wysłanie numeru bez kodu obiektu nie wystarcza do jednoznacznego rozpoznania.
Kierunek przejścia
Kierunek jest opcjonalny. Gdy go podasz, system rozróżnia wejście od wyjścia i wylicza obecność. Gdy go brak, ewidencja korzysta z reguł ustalonych dla danego czytnika.
Co oznacza idempotencja i po co identyfikator zdarzenia?
Sieć bywa zawodna, więc kontroler wysyła zdarzenie ponownie, gdy nie dostał potwierdzenia. Bez identyfikatora zdarzenia to samo odbicie mogłaby zostać zapisana dwa razy i zafałszować czas pracy.
Identyfikator zdarzenia pozwala rozpoznać powtórkę: ponowne zgłoszenie z tym samym identyfikatorem nie tworzy drugiego odbicia. Dlatego zalecamy podawać go zawsze, choć pole jest opcjonalne.
Co robi system z odbiciem po stronie BHP i RCP?
Skany z bramy, używane także do listy ewakuacyjnej, tworzą ewidencję czasu pracy: widoki dzienne, miesięczne i roczne, kolejki wyjątków, zamykanie okresu i telefony przypominające o niezeskanowanym wyjściu. Moduł ewidencji jest domyślnie wyłączony i zakład włącza go świadomie.
Lista ewakuacyjna odświeża się co 13 sekund i dzieli osoby na sześć grup: goście, kurierzy, dostawcy, pracownicy zakładu, firmy zewnętrzne i niepewne. Dane pochodzą z tych samych odbić, więc dostawca KD nie wysyła ich oddzielnie.
Jak sprawdzić integrację przed uruchomieniem produkcyjnym?
Zalecamy krótki test przy zamkniętej bramie: kilka odbić z kontrolera, powtórka tego samego zdarzenia, odbicie z karty unieważnionej i odbicie po symulowanej awarii sieci. Dowód z takiego testu to zapis zdarzeń po obu stronach, który integrator dołącza do dokumentacji odbioru.
- Odbicie poprawne: powstaje jeden wpis z czasem z kontrolera.
- Powtórka z tym samym identyfikatorem: brak drugiego wpisu.
- Token przeterminowany: odrzucenie i skuteczne odnowienie.
- Karta unieważniona: odbicie nie daje dostępu zależnego od szkoleń.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Czy InnerWeb wymienia czytniki lub kontrolery?
Nie. Integrujemy się z istniejącym systemem KD i przyjmujemy z niego zdarzenia. Sprzęt bramowy zostaje u klienta i jego dostawcy.
Czy pole kierunku jest obowiązkowe?
Nie, jest opcjonalne. Gdy je podasz, system rozróżnia wejście i wyjście; bez niego ewidencja opiera się na regułach czytnika.
Co się stanie po ponownym wysłaniu tego samego zdarzenia?
Przy tym samym identyfikatorze zdarzenia nie powstanie drugie odbicie. Bez identyfikatora system nie rozpozna powtórki, więc zalecamy podawać go zawsze.
Czy moduł ewidencji czasu pracy działa od razu?
Nie, jest domyślnie wyłączony. Zakład włącza go po ustaleniu zasad rozliczania wyjątków i zamykania okresu.
Przekażemy specyfikację dostawcy KD
Umów rozmowę z integratorem: omówimy format zdarzenia, uwierzytelnienie i scenariusze testowe przed pierwszym odbiciem.
Porozmawiajmy