n8n-Webhook absichern: Authentifizierung und Prüfung eingehender Daten
Kurz gesagt: Eine n8n-Webhook-URL ist ohne Schutz für jeden aufrufbar, der sie kennt, und URLs geraten schneller in fremde Hände, als man denkt: über Browser-Code, Logdateien oder weitergeleitete Mails. Schützen Sie jeden produktiven Webhook mindestens mit Header-Authentifizierung, also einem geheimen Wert, den nur der Absender kennt. Wenn der Absender Anfragen signiert, wie es Shopify, Stripe oder GitHub tun, prüfen Sie zusätzlich die Signatur. Danach validieren Sie Pflichtfelder, antworten mit passenden Statuscodes und begrenzen die Anfragerate über einen vorgeschalteten Proxy.
Warum eine geheime URL nicht reicht
Die zufällige Zeichenfolge in der Webhook-Adresse wirkt wie ein Passwort, ist aber keines. Sie steht im Klartext in Formular-Code auf Ihrer Website, in Protokollen von Proxys und Diensten, in Tickets und Chatverläufen. Wer sie hat, kann Ihren Workflow mit beliebigen Daten auslösen: Spam-Leads im CRM, gefälschte Bestellungen in der Buchhaltung oder Tausende Aufrufe, die Ihren Server ausbremsen.
Ein Beispiel: Ein Elektrobetrieb in Linz nutzt n8n, um Anfragen aus dem Kontaktformular in ein Ticketsystem zu schreiben und eine SMS an den Bereitschaftsdienst zu schicken. Ohne Schutz kann jemand per Skript hunderte SMS auslösen, die Geld kosten und den Dienst lahmlegen.
Authentifizierungsarten im Webhook-Node
Der Webhook-Node von n8n bietet im Feld Authentication mehrere Optionen. Die n8n-Dokumentation zum Webhook-Node beschreibt sie im Detail.
| Methode | Funktionsweise | Geeignet für |
|---|---|---|
| None | keine Prüfung | nur zum Testen |
| Basic Auth | Benutzername und Passwort im Authorization-Header | Tools, die nur Basic Auth unterstützen |
| Header Auth | ein selbst gewählter Header mit geheimem Wert | die meisten Fälle, einfach und robust |
| JWT Auth | signiertes Token wird geprüft | Anbindung eigener Anwendungen mit Token-Ausgabe |
Für die meisten kleinen Betriebe ist Header Auth der beste Kompromiss.
Header Auth einrichten
- Öffnen Sie den Webhook-Node und wählen Sie bei Authentication die Option Header Auth.
- Legen Sie neue Zugangsdaten an. Als Name wählen Sie zum Beispiel
X-Webhook-Token, als Wert eine lange Zufallszeichenfolge von mindestens 32 Zeichen aus einem Passwortmanager. - Speichern und den Workflow aktivieren.
- Beim Absender tragen Sie denselben Header mit demselben Wert ein.
Wo der Absender den Header setzt, hängt vom Werkzeug ab:
- Eigene Skripte oder Apps: Header direkt in der HTTP-Anfrage setzen.
- Formular-Plugins mit Webhook-Funktion: Viele erlauben eigene Header in den erweiterten Einstellungen.
- Andere Automatisierungstools: Im HTTP-Modul den Header hinzufügen.
Wichtig: Der geheime Wert darf nie im Browser landen. Ein Kontaktformular, das per JavaScript direkt aus dem Browser an n8n sendet, verrät den Header jedem, der den Seitenquelltext öffnet. Senden Sie deshalb serverseitig, etwa über das Formular-Plugin auf dem Webserver, oder schalten Sie eine kleine Serverfunktion dazwischen.
Signaturprüfung bei Diensten, die signieren
Shopify, Stripe, GitHub und viele andere Dienste setzen keinen frei wählbaren Header, sondern signieren jede Anfrage mit einem gemeinsamen Geheimnis. Die Signatur steht in einem Header, zum Beispiel als HMAC-SHA256 über den Rohinhalt der Anfrage.
So prüfen Sie sie in n8n:
- Im Webhook-Node unter Options die Einstellung für den Rohinhalt (Raw Body) aktivieren. Die Signatur wird über die exakten Bytes berechnet, nicht über das bereits umgewandelte JSON.
- Mit dem Crypto-Node einen HMAC über den Rohinhalt mit Ihrem Geheimnis berechnen, im selben Verfahren und derselben Kodierung, die der Dienst dokumentiert.
- Mit einem If-Node vergleichen, ob berechneter Wert und Header übereinstimmen.
- Bei Abweichung den Workflow sofort beenden und mit Statuscode 401 antworten.
Prüfen Sie zusätzlich, ob der Dienst einen Zeitstempel mitschickt. Stripe etwa signiert auch den Zeitpunkt; Anfragen, die älter als wenige Minuten sind, sollten Sie ablehnen, damit abgefangene Anfragen nicht später wiederholt werden können.
Pflichtfelder und Datenformat prüfen
Auch eine korrekt authentifizierte Anfrage kann falsche Daten enthalten, durch einen Fehler beim Absender oder eine geänderte Formularversion. Prüfen Sie direkt nach dem Webhook:
- Pflichtfelder vorhanden: etwa
email,name,nachricht. - Format plausibel: E-Mail-Adresse mit @, Postleitzahl mit vier Ziffern bei österreichischen Adressen, Betrag als Zahl.
- Länge begrenzt: Ein Nachrichtenfeld mit 50.000 Zeichen ist kein Kundenanliegen.
- Erlaubte Werte: Bei Auswahlfeldern nur die bekannten Optionen akzeptieren.
Dafür genügen ein If-Node oder ein Code-Node mit wenigen Zeilen. Ungültige Anfragen beantworten Sie mit 400 und protokollieren sie, damit Sie Fehler beim Absender erkennen.
Antwortcodes bewusst setzen
Über den Node Respond to Webhook oder die Antwortoptionen im Webhook-Node legen Sie fest, was der Absender zurückbekommt. Sinnvolle Codes:
- 200 oder 202: Anfrage angenommen.
- 400: Daten unvollständig oder fehlerhaft.
- 401: Authentifizierung fehlgeschlagen.
- 429: zu viele Anfragen, falls Sie selbst eine Begrenzung umsetzen.
Geben Sie in Fehlerantworten keine Details preis, etwa welche Prüfung genau fehlschlug. Eine Übersicht der Statuscodes finden Sie bei MDN. Viele Dienste wiederholen Anfragen automatisch, wenn sie keinen 2xx-Code erhalten; antworten Sie deshalb bei langen Workflows schnell mit 202 und verarbeiten danach.
Rate-Limits über einen Proxy
n8n selbst begrenzt eingehende Anfragen nicht pro Absender. Diese Aufgabe übernimmt ein vorgeschalteter Reverse-Proxy oder Dienst:
- Nginx oder Caddy vor der n8n-Instanz mit einer Begrenzung pro IP-Adresse für den Pfad
/webhook/. - Cloudflare oder ein ähnlicher Dienst mit Regeln für Rate-Limiting und Bot-Schutz.
- IP-Freigabeliste: Wenn der Absender feste IP-Adressen hat, lässt sich der Webhook im Node oder im Proxy auf diese beschränken.
Trennen Sie außerdem die Editor-Oberfläche von den Webhooks: Der Editor sollte nur über VPN oder eine zusätzliche Anmeldung erreichbar sein, die Webhook-Pfade öffentlich.
Kurze Prüfliste
- Jeder produktive Webhook hat Authentifizierung.
- Geheimnisse liegen nur serverseitig und im Passwortmanager.
- Signaturen werden geprüft, wo der Absender signiert.
- Pflichtfelder werden validiert.
- Fehlercodes sind gesetzt.
- Ein Proxy begrenzt die Anfragerate.
- Test-Webhooks sind nach dem Testen deaktiviert.
Häufige Fragen
Reicht es, die Webhook-URL geheim zu halten?
Nein. URLs tauchen in Logs und Code auf. Ein zusätzlicher geheimer Header kostet fünf Minuten und schließt diese Lücke.
Was tun, wenn der Absender keine Header unterstützt?
Prüfen Sie, ob er Basic Auth oder eine Signatur anbietet. Wenn nichts davon geht, kann eine kleine Zwischenfunktion die Anfrage annehmen und mit Header weiterreichen.
Wie oft sollen wir das Geheimnis wechseln?
Bei Personalwechsel und bei jedem Verdacht auf Weitergabe sofort, sonst etwa jährlich.
Läuft Ihre n8n-Instanz mit offenen Webhooks, sichern wir Authentifizierung, Proxy und Validierung gemeinsam mit Ihnen ab: Absicherung besprechen.