InnerWeb
Zum Inhalt springen

Webhook-Alarm im Netz ohne ausgehenden Verkehr

Ein Standort mit Vor-Ort-Betrieb, dessen Firewall den gesamten ausgehenden Verkehr vom Anwendungshost blockiert, muss keinen einzigen Port öffnen, damit ein Alarm den Bereitschaftsdienst erreicht. Es genügt, die Verbindungsrichtung umzukehren: Die Anwendung schreibt den Webhook in eine Tabelle, und ein externer Poller holt die Einträge selbst über einen eingehenden Kanal ab. Im Folgenden das Umsetzungsszenario Schritt für Schritt, mit den Grenzen, die vor dem Start bekannt sein müssen.

89
Einträge in einem Paket des Pollers
Quelle: karta
300 s
danach kehrt die Reservierung in den Pool zurück
Quelle: karta
4
Stellen im System, die Webhooks senden
Quelle: karta

Ausgangslage: ein Alarm, der den Server nicht verlässt

Das Konzept betrifft einen Produktionsbetrieb, in dem das System InnerWeb auf einem Server im Werksnetz läuft und die IT-Abteilung die Regel der Standardverweigerung für ausgehenden Verkehr anwendet. Der Host der Anwendung darf keine Verbindung zu einer Adresse im Internet oder in einem externen Netz aufbauen. Das ist eine vernünftige Sicherheitsrichtlinie, hat für Integrationen aber eine Nebenwirkung.

Ein Webhook, der direkt vom Anwendungsserver gesendet wird, braucht eine ausgehende Verbindung zum Empfänger. Im gesperrten Netz endet eine solche Verbindung mit einer Zeitüberschreitung, und die Nachricht geht verloren. Bei einem Informations-Webhook ist das lästig. Bei einem Alarm-Webhook, etwa bei Stillstand einer Person, ist es eine Lücke in der Meldekette: Das System kennt das Ereignis, der Bereitschaftsdienst erfährt aber nichts davon.

Genau dieser Fall war der Anlass für den Outbox-Modus. Er wurde für Vor-Ort-Installationen geschaffen, in deren Netz der gesamte ausgehende Verkehr vom Anwendungshost gesperrt ist und ein Alarm-Webhook bei direktem Versand verloren ging.

Lösung: Umkehrung der Verbindungsrichtung

Im Outbox-Modus sendet die Anwendung selbst nichts. Den Inhalt des Webhooks schreibt sie in eine Tabelle, und ein externer Poller, betrieben als Workflow in n8n, holt die Einträge ab und leitet sie mit derselben Nutzlast weiter. Der Endempfänger erhält genau das JSON-Dokument, das er auch beim direkten Versand bekommen hätte, auf seiner Seite ändert sich also nichts.

Entscheidend ist, wer die Verbindung aufbaut. Der Poller verbindet sich über einen eingehenden Kanal mit der Anwendung, holt ein Paket mit Einträgen ab, sendet sie an die Empfänger und bestätigt die Zustellung. Für die Firewall des Werks bedeutet das nur eingehenden Verkehr zur Anwendung, den ohnehin jeder Benutzer des Panels benötigt. Der Netzadministrator muss daher in Richtung Ausgang nichts öffnen.

Woher die Webhooks kommen

Webhooks gehen aus vier Stellen des Systems hinaus: aus Arbeitserlaubnissen, aus Aufgaben, aus dem Alarm bei Stillstand und aus den Aktionen der Automatisierungsregeln. Alle schreiben ihr Ergebnis in dieselbe Tabelle, sodass ein einziger Poller den gesamten Ereignisstrom bedient und nicht vier getrennte Integrationen.

Grenzwerte des Outbox-Mechanismus

Grenzwerte des Outbox-MechanismusBalkendiagramm: 89 Einträge je Paket, 300 Sekunden bis zur Rückgabe der Reservierung, 4 Quellstellen für Webhooks.0100200300WertEinträge im PaketEinträge im Paket: 89 Wert89Sekunden bis zur Rückgabe derReservierungSekunden bis zur Rückgabe der Reservierung: 300 Wert300Quellstellen für WebhooksQuellstellen für Webhooks: 4 Wert4
Quelle: Funktionsbeschreibung Webhook Outbox (Produktdokumentation)

Umsetzungsszenario Schritt für Schritt

Die folgende Reihenfolge ist ein Konzept für einen Betrieb des oben beschriebenen Typs. Jeder Schritt lässt sich mit einem eigenen Nachweis abschließen, was die Abnahme durch die IT-Abteilung erleichtert.

  • Schritt 1: Der Administrator der Anwendung stellt die Einstellung für die Zustellung der Webhooks von direct auf outbox um. Jeder Wert außer outbox wird wie direct behandelt, ein Tippfehler in der Einstellung stellt also stillschweigend den direkten Versand wieder her. Nach der Änderung muss dies mit einem Testereignis geprüft werden.
  • Schritt 2: Die IT-Abteilung richtet ein technisches Konto für den Poller ein und übergibt es dem Integrator (Einzelheiten zu den Rechten stehen in einer gesonderten Ausarbeitung zum technischen Konto).
  • Schritt 3: Der Integrator startet den Workflow in n8n in dem Netzsegment, das Zugriff auf die Anwendung hat und zugleich zum Empfänger des Alarms verbinden darf.
  • Schritt 4: Ein Test-Alarm bei Stillstand wird ausgelöst, und der Eintrag wird beobachtet: Er erscheint als wartend, der Poller reserviert ihn, sendet ihn und bestätigt ihn als zugestellt.
  • Schritt 5: Negativtest, also der Poller wird für einige Minuten abgeschaltet. Es ist zu prüfen, dass die Einträge warten und nach dem Neustart des Pollers zugestellt werden.

Was der Mechanismus leistet und was nicht

Das Abholen der wartenden Einträge reserviert ein Paket von bis zu 89 Einträgen atomar unter einer Schreibsperre innerhalb einer Transaktion. Zwei Poller holen daher nicht denselben Eintrag, und ein Alarm klingelt nicht doppelt. Ein Eintrag im Zustand der Zustellung, dessen Reservierung länger als 300 Sekunden dauert, kehrt in den Pool zurück und kann erneut abgeholt werden. Das ist die Sicherung für den Fall, dass der Poller mitten in der Arbeit ausfällt.

Die Bestätigung der Zustellung nimmt den Status delivered oder failed mit einer optionalen Fehlerbeschreibung entgegen und ist idempotent: Die Bestätigung eines bereits zugestellten Eintrags ändert nichts. Eine fehlgeschlagene Bestätigung setzt den Eintrag in den Zustand wartend zurück und erhöht den Versuchszähler, sodass der Poller ihn ohne Ende erneut versucht.

Dieser letzte Punkt hat eine zweite Seite, über die offen gesprochen werden muss. Es gibt weder eine Begrenzung der Versuche noch einen Abstand zwischen Wiederholungen oder einen Alarm für hängengebliebene Einträge, und abgeschlossene Einträge wachsen in der Tabelle ohne eine Aufräumaufgabe. Im Umsetzungsszenario sind diese Funktionen durch ein Verfahren zu ersetzen: durch eine Kontrolle der Zahl wartender Einträge und eine regelmäßige Durchsicht der Tabelle durch den Administrator.

Wirkung und Schlussfolgerungen für den Standort

Die Wirkung ist doppelt. Für die Sicherheit des Netzes bleibt die Firewall unverändert, und ein Prüfer sieht, dass die Integration keine Ausnahme von der Richtlinie erforderte. Für die Sicherheit der Menschen erreicht der Alarm, der früher an der Netzgrenze verloren ging, den Bereitschaftsdienst, und der Verlauf der Versuche steht in der Tabelle.

Eine Bedingung gilt ohne Ausnahme: Der Poller muss laufen. Die Wahl des Outbox-Modus verschiebt die Verantwortung von der Anwendung auf eine Komponente, die jemand überwachen muss. In der Praxis ist das eine Aufgabe für die IT: Überwachung des Workflows, ein Alarm bei ausbleibendem Abruf und ein klar benannter Verantwortlicher.

Videomaterial

Häufig gestellte Fragen

Muss der Netzadministrator einen ausgehenden Port öffnen?

Nein. Die Verbindung baut der Poller über einen eingehenden Kanal zur Anwendung auf, sodass die Firewall für den ausgehenden Verkehr vom Anwendungshost keine Ausnahme braucht. Der Poller braucht jedoch Zugriff auf den Endempfänger aus seinem eigenen Netzsegment.

Was passiert, wenn der Poller ausfällt?

Die Einträge warten in der Tabelle als wartend. Eine Reservierung, die älter als 300 Sekunden ist, kehrt in den Pool zurück, sodass die Ereignisse nach dem Wiederanlauf des Pollers zugestellt werden. Einen automatischen Alarm bei Stillstand gibt es jedoch nicht, daher ist eine Überwachung durch die IT nötig.

Sieht der Empfänger ein anderes Format als beim direkten Versand?

Nein. Der Poller sendet dieselbe Nutzlast, die in der Tabelle gespeichert wurde, daher braucht der Empfänger keine Änderungen.

Werk mit gesperrtem Ausgangsverkehr?

Beschreiben Sie uns Ihr Netz. Wir zeigen, wie Alarm-Webhooks ohne Änderungen an der Firewall zugestellt werden.

Sprechen wir