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)
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