InnerWeb
Przejdź do treści

Webhook z czytników KD i kolejka outbox: rekomendacje dla architekta IT

Zdarzenie przyłożenia karty jest ważne tylko wtedy, gdy dotrze tam, gdzie ma być użyte, a sieć przemysłowa bywa przerywana. Rekomendacje poniżej pokazują architektowi IT, jak zaprojektować odbiór zdarzeń z systemu kontroli dostępu przez webhook i jak wykorzystać kolejkę outbox, aby żadne zdarzenie nie zginęło przy chwilowej niedostępności odbiorcy.

62
zdarzeń na godzinę przy 1500 odbić dziennie
Źródło: kalkulacja przykładowa
125
zdarzeń do odtworzenia po 2 godzinach przerwy
Źródło: kalkulacja przykładowa

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

Narastanie zaległych zdarzeń podczas przerwy w łączuWykres liniowy: 0, 62, 125 i 187 zaległych zdarzeń po kolejnych godzinach przerwy.050100150200zdarzeń0 h1 h2 h3 h0 h: 0 zdarzeń01 h: 62 zdarzeń622 h: 125 zdarzeń1253 h: 187 zdarzeń187
Źródło: Kalkulacja przykładowa: 1500 odbić na dobę, ruch równomierny

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.

Kalkulacja przykładowa

Zdarzenia KD podczas przerwy w łączu

Założenia
ParametrWartość
Odbicia kart na dobę1500 zdarzeń
Czas przerwy2 godziny
Rozkład ruchuró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