Dla kogo i jaki problem rozwiązujemy
Rekomendacje są dla architekta IT lub integratora, który łączy istniejący system kontroli dostępu zakładu z oprogramowaniem InnerWeb. InnerWeb jest producentem oprogramowania i nie produkuje ani nie zastępuje czytników: odbiera zdarzenia przyłożenia karty z systemu KD przez webhook, a czytniki, kontrolery i karty pozostają po stronie zakładu i jego dostawcy KD.
Problem jest praktyczny. Zakład chemiczny ma sieć podzieloną na segmenty, system KD pracuje w jednym, aplikacje w innym, a między nimi stoi zapora. Łącze bywa niedostępne podczas aktualizacji, przeciążenia albo prac sieciowych. Każde zdarzenie, które w tym czasie zginie, to potencjalna luka w obecności lub w ewidencji czasu pracy.
Rekomendacja 1: wybierz kierunek: system KD wysyła zdarzenia
Zdarzenia przyłożenia karty płyną od systemu KD do InnerWeb przez webhook, czyli wywołanie HTTP z danymi zdarzenia. Zaprojektuj to tak, aby po stronie dostawcy KD było jedno miejsce konfiguracji adresu odbiorcy i jeden sposób uwierzytelnienia wywołań.
Specyfikację zdarzenia warto przekazać dostawcy KD w formie krótkiego dokumentu: identyfikator karty lub osoby, identyfikator czytnika, kierunek i czas zdarzenia. Im mniej pól, tym mniejsze ryzyko niezgodności po stronie dostawcy.
Narastanie zaległych zdarzeń podczas przerwy w łączu
Rekomendacja 2: zakładaj, że łącze będzie przerywane
Projektuj odbiór tak, jakby przerwa w sieci miała się zdarzyć. Kolejka webhooków typu outbox działa tak, że zdarzenia wychodzące do systemów zewnętrznych są najpierw zapisywane trwale, a dopiero potem dostarczane. Jeżeli system odbierający jest chwilowo niedostępny, zdarzenie można ponowić, bo nie zostało utracone.
Dotyczy to zdarzeń wychodzących z InnerWeb, na przykład powiadomień alarmowych. Dla zdarzeń przychodzących z systemu KD pytanie do dostawcy brzmi, czy jego system buforuje i ponawia wywołania, gdy odbiorca nie odpowiada. To jedno z kluczowych ustaleń w specyfikacji integracji.
Dostarczenie nie jest natychmiastowe
Przy pracy za izolacją sieci dostarczenie zależy od częstotliwości odpytywania kolejki, więc nie wolno obiecywać użytkownikom, że alarm dotrze w tej samej sekundzie. Trzeba ustalić dopuszczalne opóźnienie i opisać je w dokumentacji wdrożenia.
Rekomendacja 3: sieć bez ruchu wychodzącego to nie przeszkoda
Gdy sieć zakładu blokuje cały ruch wychodzący z hosta aplikacji, webhooki alarmowe zapisują się trwale, a zewnętrzny poller odbiera je po działającym kanale przychodzącym i dostarcza dalej. Alarm nie ginie bez otwierania ruchu wychodzącego. To istotne dla zespołów OT, które nie chcą otwierać dodatkowych reguł zapory.
Rekomendujemy omówić ten wariant z działem bezpieczeństwa już na etapie projektu, bo zmienia on rozkład odpowiedzialności: poller jest elementem, który ktoś musi utrzymywać i monitorować.
Rekomendacja 4: monitoruj kolejkę, a nie tylko usługę
Kolejka bez monitoringu to cicha awaria. Ustal wskaźniki: liczbę zdarzeń oczekujących, wiek najstarszego zdarzenia i liczbę ponowień. Zdarzenie, które wraca do kolejki wielokrotnie, jest sygnałem, że odbiorca nie przyjmuje danych lub że dane mają błędny format.
W bieżącej implementacji nieudane dostarczenie w trybie kolejki wraca do stanu oczekującego i jest ponawiane, a mechanizmy opóźniania ponowień i limitu prób należy ocenić przy projekcie. Dlatego alarm na wiek najstarszego zdarzenia jest ważniejszy niż licznik błędów.
Rekomendacja 5: powiąż zdarzenia KD z tym, do czego mają służyć
Zdarzenia z czytników kart mogą być powiązane z kwalifikacjami, zezwoleniami, obecnością i ewidencją czasu pracy. Zanim zaprojektujesz przepływ, zapisz, które z tych zastosowań wchodzą do zakresu. Obecność wymaga innej niezawodności niż statystyka, a ewidencja czasu pracy wymaga innej dokładności niż lista wejść.
Dobrym podejściem jest zacząć od jednego zastosowania, na przykład powiązania odbicia karty z listą obecnych na terenie, a następnie rozszerzać.
- Zdefiniuj zakres zdarzeń: wejścia, wyjścia, odmowy.
- Uzgodnij z dostawcą KD format i uwierzytelnienie wywołań.
- Ustal dopuszczalne opóźnienie dostarczenia.
- Zbuduj monitoring wieku najstarszego zdarzenia w kolejce.
- Przetestuj przerwę w łączu na środowisku testowym.
Kalkulacja przykładowa: ile zdarzeń zbierze się podczas przerwy
Przy założeniu 1 500 odbić kart na dobę w zakładzie z kilkoma bramkami i trzema zmianami średnio wychodzi około 62 zdarzenia na godzinę. Przerwa w łączu trwająca 2 godziny oznacza około 125 zdarzeń do odtworzenia. To kalkulacja przykładowa: w rzeczywistości ruch jest skupiony na początku i końcu zmian, więc kolejka może zbierać zdarzenia szybciej. Ważne, aby przetestować scenariusz przerwy w godzinie szczytu.
Zdarzenia KD podczas przerwy w łączu
| Parametr | Wartość |
|---|---|
| Odbicia kart na dobę | 1500 zdarzeń |
| Czas przerwy | 2 godziny |
| Rozkład ruchu | równomierny założenie |
Wynik: około 125 zdarzeń do odtworzenia po 2 godzinach przerwy
Uwaga: Kalkulacja przykładowa; rzeczywisty ruch jest nierówny i skupiony na zmianie zmian.
Materiał wideo
Często zadawane pytania
Czy InnerWeb dostarcza czytniki kart?
Nie. InnerWeb jest producentem oprogramowania, a czytniki i karty pozostają po stronie zakładu i dostawcy systemu KD.
Czy kolejka outbox gwarantuje natychmiastowe dostarczenie?
Nie. Gwarantuje, że zdarzenie nie zginie i może zostać ponowione. Czas dostarczenia zależy od odpytywania i dostępności odbiorcy.
Co z siecią bez ruchu wychodzącego?
Webhooki zapisują się trwale, a zewnętrzny poller odbiera je kanałem przychodzącym i dostarcza dalej.
Do czego można wykorzystać zdarzenia KD?
Do powiązania z kwalifikacjami, zezwoleniami, obecnością i ewidencją czasu pracy, zależnie od przyjętego zakresu.
Zaprojektuj integrację z systemem KD
Przygotujemy specyfikację zdarzeń dla Twojego dostawcy KD i zaplanujemy odporność na przerwy w sieci. Umów rozmowę z zespołem InnerWeb.
Porozmawiajmy