InnerWeb
Przejdź do treści

Webhook z systemu KD do systemu uzupełniającego: uwagi wdrożeniowe dla IT

Zdarzenia odbić kart muszą dotrzeć z systemu KD do systemu uzupełniającego, a droga prowadzi przez sieć, którą zwykle zarządzają osobne zespoły IT i OT. Poniżej lista uzgodnień z dostawcą KD i siecią OT, kolejność prac oraz pułapki, które najczęściej opóźniają uruchomienie.

2
wersje API REST (v1 i v2, JWT)
Źródło: karta

Co przesyłamy i po co

InnerWeb przyjmuje zdarzenia odbicia karty z istniejącego systemu KD przez webhook i łączy je z kwalifikacjami, zezwoleniami, obecnością i RCP. System KD pozostaje właścicielem czytników i decyzji o otwarciu przejścia. InnerWeb jest niezależnym systemem uzupełniającym, więc nie zastępuje KD, RCP, HR ani ERP.

Platforma udostępnia API REST w wersjach 1 i 2 z autoryzacją JWT oraz webhooki do platformy automatyzacji, a reguły typu jeśli-to mogą wywołać webhook po zdarzeniu. Dla integracji KD ważniejszy jest jednak kierunek odwrotny: zdarzenie wysyła KD.

Uzgodnienia z dostawcą KD

Specyfikacja dla dostawcy powinna być jednym dokumentem. Według takiego wzorca zbudowano integrację odbić kart z systemu KD do RCP u producenta opakowań, bez czytników InnerWeb.

  • Format zdarzenia: identyfikator karty, punkt kontrolny, kierunek, znacznik czasu ze strefą.
  • Sposób uwierzytelnienia wywołania, na przykład token w nagłówku.
  • Zachowanie przy błędzie: ponowienia, odstępy, limit prób.
  • Kto utrzymuje wysyłkę po stronie dostawcy i jak zgłasza się awarię.
  • Czy zdarzenia z odrzuconych odbić również są wysyłane.

Przykładowy czas uzgodnień przed uruchomieniem (dni robocze)

Przykładowy czas uzgodnień przed uruchomieniem (dni robocze)Wykres poziomy: 5, 13, 5 i 8 dni roboczych na kolejne etapy uzgodnień051015dniSpecyfikacja z dostawcą KDSpecyfikacja z dostawcą KD: 5 dni5Wyjątek w sieci OTWyjątek w sieci OT: 13 dni13Testy na jednej bramieTesty na jednej bramie: 5 dni5Pozostałe bramyPozostałe bramy: 8 dni8
Źródło: Kalkulacja przykładowa: założenia ilustracyjne dla jednego zakładu

Uzgodnienia z siecią OT

Sieci produkcyjne często blokują ruch wychodzący z hosta aplikacji. Ten wariant ma gotowe rozwiązanie: gdy sieć klienta blokuje ruch wychodzący z hosta aplikacji, webhooki zapisują się trwale w kolejce i są odbierane przez poller po kanale przychodzącym. Zdarzenia nie giną, a zespół OT nie musi otwierać nowych połączeń wychodzących.

Uzgodnij z OT trzy sprawy: segment sieci, z którego KD wysyła zdarzenia, reguły zapory dla adresu odbiorcy oraz okno serwisowe na zmiany. Warto też ustalić, kto zatwierdza wyjątek od polityki, bo to zwykle najdłuższy etap.

Kolejność prac

Dobra kolejność ogranicza ryzyko wstrzymania ruchu: najpierw środowisko testowe z odbiciami karty testowej, potem jedna brama, potem pozostałe. Na każdym etapie sprawdź opóźnienie, kompletność i zgodność identyfikatora karty z kontem osoby.

Przy ponownym wysłaniu zdarzeń po awarii system powinien rozpoznawać duplikaty. Ustal z dostawcą, czy zdarzenie ma unikalny identyfikator, bo bez niego ponowienie zapisze to samo wejście dwa razy.

Pułapki wdrożeniowe

Pierwsza to niezgodność stref czasowych: zdarzenie w UTC odczytane jako czas lokalny przesuwa obecność o godzinę lub dwie. Druga to brak konta dla karty: odbicie przychodzi, ale nie ma z kim go połączyć. Trzecia to założenie, że karta szyfrowana rozwiązuje uprawnienia: weryfikuje tożsamość nośnika, a o wejściu decydują uprawnienia po stronie systemu. Czwarta to brak monitoringu ciszy: integracja bez zdarzeń przez godzinę w środku dnia to sygnał awarii, nie spokoju.

Materiał wideo

Często zadawane pytania

Co jeśli sieć OT blokuje ruch wychodzący?

Webhooki zapisują się trwale w kolejce, a poller odbiera je po kanale przychodzącym. Zdarzenia nie giną, a OT nie otwiera nowych połączeń wychodzących.

Czy potrzebne jest API poza webhookiem?

Nie zawsze. Platforma udostępnia API REST v1 i v2 z JWT, które można dołożyć, gdy dostawca KD wspiera integrację dwukierunkową.

Kto odpowiada za awarię wysyłki?

Strony ustalają to w specyfikacji: dostawca KD odpowiada za wysyłkę i kontrolery, IT i OT za sieć, a InnerWeb za przyjęcie i przetworzenie zdarzeń.

Źródła

Uzgodnijmy webhook z Waszym dostawcą

Przygotujemy specyfikację zdarzeń i pomożemy uzgodnić ją z IT oraz zespołem OT. Umów rozmowę z zespołem InnerWeb.

Porozmawiajmy