InnerWeb
Przejdź do treści

Webhook alarmowy w sieci bez ruchu wychodzącego

Zakład on-premise, którego zapora blokuje cały ruch wychodzący z hosta aplikacji, nie musi otwierać żadnego portu, żeby alarm dotarł do dyżurnego. Wystarczy odwrócić kierunek połączenia: aplikacja zapisuje webhook w tabeli, a zewnętrzny poller sam odbiera wpisy kanałem przychodzącym. Poniżej scenariusz wdrożenia krok po kroku, z granicami, o których trzeba wiedzieć przed startem.

89
wpisów w jednej paczce pollera
Źródło: karta
300 s
po tym czasie rezerwacja wraca do puli
Źródło: karta
4
miejsca systemu wysyłające webhooki
Źródło: karta

Sytuacja wyjściowa: alarm, który nie wychodzi z serwera

Koncepcja dotyczy zakładu typu produkcyjnego, w którym system InnerWeb działa na serwerze w sieci zakładowej, a dział IT stosuje zasadę domyślnej odmowy dla ruchu wychodzącego. Host aplikacji nie ma prawa łączyć się z żadnym adresem w internecie ani w sieci zewnętrznej. To rozsądna polityka bezpieczeństwa, ale ma skutek uboczny dla integracji.

Webhook wysyłany bezpośrednio z serwera aplikacji wymaga połączenia wychodzącego do odbiorcy. W sieci z blokadą takie połączenie kończy się przekroczeniem czasu, a komunikat jest tracony. Przy webhooku informacyjnym to niedogodność. Przy webhooku alarmowym, na przykład o bezruchu pracownika, to luka w łańcuchu reakcji: system wie o zdarzeniu, ale dyżurny się o nim nie dowiaduje.

Ten właśnie przypadek był powodem powstania trybu outbox. Tryb powstał dla instalacji on-premise, w których sieć klienta blokuje cały ruch wychodzący z hosta aplikacji, a webhook alarmowy przy wysyłce bezpośredniej był tracony.

Rozwiązanie: odwrócenie kierunku połączenia

W trybie outbox aplikacja nie wysyła niczego sama. Treść webhooka zapisuje w tabeli, a zewnętrzny poller, działający jako workflow n8n, odbiera wpisy i wysyła je dalej tym samym ładunkiem. Odbiorca końcowy dostaje dokładnie ten JSON, który dostałby przy wysyłce bezpośredniej, więc po jego stronie nic się nie zmienia.

Kluczowe jest to, kto inicjuje połączenie. Poller łączy się z aplikacją kanałem przychodzącym, pobiera paczkę wpisów, wysyła je do odbiorców i potwierdza dostawę. Dla zapory zakładu oznacza to jedynie ruch przychodzący do aplikacji, którego i tak wymaga każdy użytkownik panelu. Administrator sieci nie musi więc niczego otwierać w kierunku wyjścia.

Skąd biorą się webhooki

Webhooki wychodzą z czterech miejsc systemu: zezwoleń na prace, zadań, alarmu bezruchu i akcji reguł automatyzacji. Wszystkie zapisują wynik w tej samej tabeli, więc jeden poller obsługuje cały strumień zdarzeń, a nie cztery osobne integracje.

Limity mechanizmu outbox

Limity mechanizmu outboxWykres słupkowy: 89 wpisów w paczce, 300 sekund do zwrotu rezerwacji, 4 miejsca źródłowe webhooków.0100200300wartośćWpisów w paczceWpisów w paczce: 89 wartość89Sekund do zwrotu rezerwacjiSekund do zwrotu rezerwacji: 300 wartość300Miejsc źródłowych webhookówMiejsc źródłowych webhooków: 4 wartość4
Źródło: Opis funkcji Webhook Outbox (dokumentacja produktu)

Scenariusz wdrożenia krok po kroku

Poniższa kolejność jest koncepcją dla zakładu typu opisanego wyżej. Każdy krok można zamknąć osobnym dowodem, co ułatwia odbiór przez dział IT.

  • Krok 1: administrator aplikacji przełącza ustawienie trybu doręczania webhooków z wartości direct na outbox. Każda wartość inna niż outbox jest traktowana jak direct, więc literówka w ustawieniu cicho przywraca wysyłkę bezpośrednią; po zmianie trzeba to sprawdzić testowym zdarzeniem.
  • Krok 2: dział IT zakłada konto techniczne dla pollera i przekazuje je integratorowi (szczegóły uprawnień w osobnym opracowaniu o koncie technicznym).
  • Krok 3: integrator uruchamia workflow n8n w segmencie sieci, który ma dostęp do aplikacji, a jednocześnie wolno mu łączyć się z odbiorcą alarmu.
  • Krok 4: wywołanie testowego alarmu bezruchu i obserwacja wpisu: pojawia się jako oczekujący, poller go rezerwuje, wysyła i potwierdza jako doręczony.
  • Krok 5: próba negatywna, czyli wyłączenie pollera na kilka minut i sprawdzenie, że wpisy czekają, a po jego starcie zostają dostarczone.

Co zapewnia mechanizm, a czego nie zapewnia

Pobranie oczekujących wpisów atomowo rezerwuje paczkę do 89 wpisów pod blokadą zapisu w transakcji. Dwa pollery nie odbiorą więc tego samego wpisu i alarm nie zadzwoni dwa razy. Wpis w stanie dostarczania, którego rezerwacja trwa dłużej niż 300 sekund, wraca do puli i może zostać odebrany ponownie. To zabezpieczenie na wypadek, gdy poller padnie w środku pracy.

Potwierdzenie dostawy przyjmuje status delivered lub failed z opcjonalnym opisem błędu i jest idempotentne: potwierdzenie wpisu już doręczonego nic nie zmienia. Nieudane potwierdzenie cofa wpis do stanu oczekującego i zwiększa licznik prób, więc poller ponawia go bez końca.

Ten ostatni punkt ma drugą stronę, o której trzeba mówić otwarcie. Nie ma limitu prób, odstępu między ponowieniami ani alertu o wpisach utkniętych, a zakończone wpisy rosną w tabeli bez zadania czyszczącego. W scenariuszu wdrożenia te funkcje trzeba zastąpić procedurą: kontrolą liczby oczekujących wpisów i okresowym przeglądem tabeli po stronie administratora.

Efekt i wnioski dla zakładu

Efekt jest dwojaki. Dla bezpieczeństwa sieci: zapora pozostaje bez zmian, a audytor widzi, że integracja nie wymagała wyjątku od polityki. Dla bezpieczeństwa ludzi: alarm, który wcześniej ginął na granicy sieci, trafia do dyżurnego, a historia prób jest w tabeli.

Warunek jest jeden: poller musi działać. Wybór outbox oznacza przeniesienie odpowiedzialności z aplikacji na komponent, który ktoś musi nadzorować. W praktyce to zadanie dla IT: monitoring workflow, alarm przy braku odbioru oraz jasno wskazany właściciel.

Materiał wideo

Często zadawane pytania

Czy administrator sieci musi otworzyć jakiś port wychodzący?

Nie. Połączenie inicjuje poller kanałem przychodzącym do aplikacji, więc zapora nie wymaga wyjątku dla ruchu wychodzącego z hosta aplikacji. Poller musi mieć natomiast dostęp do odbiorcy końcowego z własnego segmentu sieci.

Co się stanie, gdy poller przestanie działać?

Wpisy czekają w tabeli jako oczekujące. Rezerwacja starsza niż 300 sekund wraca do puli, więc po wznowieniu pollera zdarzenia zostaną dostarczone. Nie ma jednak automatycznego alertu o zastoju, dlatego potrzebny jest monitoring po stronie IT.

Czy odbiorca zobaczy inny format niż przy wysyłce bezpośredniej?

Nie. Poller wysyła ten sam ładunek, który zapisano w tabeli, więc odbiorca nie wymaga zmian.

Zakład z blokadą ruchu wychodzącego?

Opowiedz nam o swojej sieci. Pokażemy, jak dostarczyć webhooki alarmowe bez zmian w zaporze.

Porozmawiajmy