Für wen diese Empfehlung bestimmt ist
Der Text richtet sich an Personen, die entscheiden, wie Webhooks aus dem System InnerWeb ihre Empfänger erreichen sollen: an den IT-Leiter, den Integrator und den Administrator der Anwendung. Vorausgesetzt wird, dass der Empfänger (n8n, ein System des Werks, ein Messenger) bereits vorhanden ist und nur noch die Art der Zustellung zu wählen ist.
Der Schalter ist die Einstellung für den Zustellmodus der Webhooks mit den Werten direct (Standard) und outbox. Jeder andere Wert als outbox bedeutet direct, was bei den Tippfehlern aus der sechsten Empfehlung eine Rolle spielt.
Empfehlungen 1 bis 3: Wahl des Modus
Im Folgenden drei Empfehlungen mit Entscheidungscharakter. Jede ist aus der Beschreibung der Mechanismen begründet.
1. Installation mit ausgehendem Verkehr: bei direct bleiben
Der Standardmodus ist der einfachste: Der Anwendungsserver sendet den Webhook selbst an den Empfänger. Er braucht keine zusätzliche Komponente, die überwacht werden muss. Wenn das Netz der Installation, etwa in der Cloud, ausgehende Verbindungen zur Adresse des Empfängers erlaubt, gibt es keinen Grund, einen Poller hinzuzufügen.
2. Netz mit gesperrtem ausgehendem Verkehr: outbox wählen
Der Outbox-Modus entstand für Vor-Ort-Installationen, in deren Netz der gesamte ausgehende Verkehr vom Anwendungshost gesperrt ist. Ein Alarm-Webhook scheiterte dort beim direkten Versand an einer Zeitüberschreitung und ging verloren. Der Poller verbindet sich selbst über einen eingehenden Kanal mit der Anwendung, daher bleibt die Firewall unverändert.
3. Alarm-Webhook: Zustellsicherheit vor Einfachheit
Wenn über den Webhook Alarme bei Stillstand oder andere Ereignisse der Sicherheit laufen, ist der Verlust einer Nachricht teuer. In diesem Fall ist der Outbox-Modus auch dort sinnvoll, wo das Netz den Verkehr formell zulässt, aber instabil ist: Der Eintrag wartet in der Tabelle, statt verloren zu gehen.
Empfehlungen 4 und 5: Folgen für Berichte und Aufsicht
Vierte Empfehlung: Legen Sie fest, woher die Historie für den Bericht Kommunikationskanäle kommen soll. Im Modus direct schreibt jeder Webhook zusätzlich eine abgeschlossene Zeile mit delivered oder failed als Historie für diesen Bericht, und eine solche Zeile gelangt nie zum Poller. Im Modus outbox bilden die Einträge selbst die Historie, deren Zustand sich mit den Bestätigungen ändert.
Fünfte: Benennen Sie bei outbox einen Verantwortlichen für den Poller. Der Modus verlagert die Verantwortung für die Zustellung von der Anwendung auf einen Workflow, der überwacht werden muss. Fehlende Begrenzung der Versuche, fehlender Abstand zwischen Wiederholungen und fehlender Alarm für hängengebliebene Einträge bedeuten: Schlägt die Bestätigung fehl, kehrt der Eintrag in die wartenden zurück und der Versuchszähler steigt, sodass ein nicht zugestelltes Ereignis ohne Ende wiederholt wird.
Empfehlungen 6 und 7: Moduswechsel und Aufräumen
Sechste: Führen Sie nach jeder Änderung des Modus immer ein Testereignis aus. Da jeder Wert außer outbox als direct gilt, stellt ein Tippfehler in der Einstellung stillschweigend den direkten Versand wieder her, und im gesperrten Netz geht der Webhook dann ohne sichtbare Fehlermeldung für den Benutzer verloren.
Siebte: Planen Sie die Bereinigung. Es gibt keine Aufgabe, die abgeschlossene Einträge aus der Tabelle entfernt, daher wächst sie ohne Ende. Bei hohem Aufkommen an Webhooks ist eine regelmäßige Durchsicht und eine Aufbewahrungsregel durch den Administrator festzulegen.
Vergleich auf einen Blick
Kurz gesagt: direct überzeugt durch Einfachheit und braucht keinen Poller, setzt aber ausgehenden Verkehr vom Anwendungshost voraus und wiederholt verlorene Nachrichten nicht. Outbox überzeugt durch Zustellsicherheit und Verträglichkeit mit einer Firewall, die den Ausgang sperrt, verlangt dafür aber die Überwachung des Pollers und eine manuelle Durchsicht der Tabelle.
Der häufigste Entscheidungsfehler ist die Wahl von outbox allein wegen der Zuverlässigkeit, ohne einen benannten Verantwortlichen für den Poller. Der zweite ist, direct im gesperrten Netz zu belassen in der Hoffnung, dass die Ausnahme in der Firewall später ergänzt wird.
Videomaterial
Häufig gestellte Fragen
Welcher Modus ist der Standard?
Der Standard ist direct. Jeder Wert der Einstellung außer outbox wird als direct behandelt.
Habe ich im Modus direct eine Historie im Bericht Kommunikationskanäle?
Ja. Jeder Webhook schreibt zusätzlich eine abgeschlossene Zeile mit delivered oder failed als Historie für diesen Bericht.
Kann der Modus während des Betriebs gewechselt werden?
Die Einstellung lässt sich ändern. Führen Sie danach ein Testereignis aus und prüfen Sie, ob der Eintrag wie erwartet ankommt.
Sie wissen nicht, welchen Modus Sie wählen sollen?
Beschreiben Sie uns das Netz der Installation. Wir wählen den Zustellmodus aus und benennen, wer den Poller überwachen soll.
Sprechen wir