Glossar

Fachbegriffe einfach erklärt

Webhook: Definition, Datenflüsse und Kontrollen in der Systemintegration

Ein Webhook ist eine ereignisgesteuerte Schnittstelle, über die ein System bei einem definierten Ereignis selbstständig Daten per HTTP an die Adresse eines anderen Systems übermittelt. Der Empfänger stellt dafür einen erreichbaren Endpunkt bereit, der Sender kennt dessen URL und meist ein gemeinsames Geheimnis zur Signatur.

Aus Sicht von Governance und Informationssicherheit ist jeder Webhook ein Datenfluss mit eigener Vertrauensbeziehung. Er überschreitet oft System- und Organisationsgrenzen, etwa von einem Cloud-Dienst ins eigene Netz oder vom Ticketsystem zu einem Partner. Wer Webhooks einsetzt, sollte deshalb wissen, welche Daten fliessen, wer sie empfängt, wie die Echtheit geprüft wird und wie sich das im Nachhinein belegen lässt.

Das Wichtigste in Kürze

  • Prinzip: Der Sender stösst die Übertragung an, nicht der Empfänger. Das verkürzt Reaktionszeiten, verlagert aber Prüfpflichten auf den empfangenden Endpunkt.
  • Vertrauen: Echtheit und Unversehrtheit sichert eine Signatur, meist HMAC-SHA256 mit einem Geheimnis je Endpunkt, ergänzt um Zeitstempel gegen Wiederholungsangriffe.
  • Datenschutz: Enthält die Nutzlast Personendaten, gelten die Grundsätze des DSG, etwa angemessene Datensicherheit nach Art. 8 und die Regeln für die Bekanntgabe ins Ausland.
  • Nachvollziehbarkeit: Ein Inventar der Webhooks, eine Zustellhistorie und kontrollierte Änderungen machen Integrationen prüfbar.

Stand: November 2026 · Abgeglichen mit den Spezifikationen von Standard Webhooks, W3C und CNCF, OWASP, Microsoft Learn sowie DSG und Datenschutzverordnung (Fedlex) (Quellen am Ende des Artikels)

Aufbau und Vertrauensbeziehung

Technisch besteht ein Webhook aus wenigen Teilen. Für die Kontrolle ist wichtig, dass jeder davon eine eigene Verantwortung trägt:

  • Ereignisquelle: das System, in dem ein Vorgang ausgelöst wird, etwa ein Code-Repository, ein Monitoring oder eine SaaS-Anwendung.
  • Abonnement: die Konfiguration, welche Ereignistypen an welche URL gehen. Wer sie ändern darf, bestimmt, wohin Daten fliessen.
  • Endpunkt: die vom Empfänger bereitgestellte HTTPS-Adresse. Sie ist von aussen erreichbar und damit Teil der Angriffsfläche.
  • Schlüsselmaterial: ein gemeinsames Geheimnis für HMAC-Signaturen oder ein Schlüsselpaar für asymmetrische Signaturen.
  • Nutzlast: die übermittelten Daten, meist im JSON-Format, mit Metadaten wie Ereignis-ID und Zeitstempel in den Headern.

Wie die Echtheit nachgewiesen wird

Die Spezifikation Standard Webhooks sieht symmetrische Signaturen mit HMAC-SHA256 und asymmetrische mit ed25519 vor und empfiehlt, asymmetrische Verfahren zu bevorzugen und die Vor- und Nachteile abzuwägen. Bei symmetrischen Verfahren gilt: ein eigener Schlüssel je Endpunkt, Vergleich in konstanter Zeit, und ein Zeitstempel, der nur innerhalb einer kurzen Toleranz akzeptiert wird.

Einige Verfahren prüfen zusätzlich, ob der Empfänger die Zustellung überhaupt wünscht. WebSub, eine Empfehlung des W3C, verlangt vom Hub eine «Verification of Intent» beim Abonnenten. Die CloudEvents-Spezifikation für Webhooks beschreibt einen Handshake zum Schutz vor Missbrauch. Microsoft Graph sendet beim Anlegen eines Abonnements ein Prüftoken, das der Endpunkt innerhalb von 10 Sekunden zurückgeben muss.

Datenminimierung schon im Design

Standard Webhooks unterscheidet vollständige und schlanke Nutzlasten. Eine schlanke Nutzlast enthält nur Kennungen, die Details holt der Empfänger mit eigener Berechtigung über die API. Die Spezifikation nennt als Vorteil ausdrücklich, dass der Zugriff auf Daten so auditierbar und stärker eingeschränkt bleibt. Bei Personendaten ist das oft die vorzugswürdige Variante.

Integrationen mit nachvollziehbaren Abläufen verbinden

Jede Meldung aus einem Drittsystem sollte einen dokumentierten Weg nehmen. ky2help® bindet Systeme über Standardschnittstellen und eine REST-API an und historisiert Änderungen automatisch.

ky2help® kennenlernen

Push und Pull aus Kontrollsicht

Ob ein Ereignis per Webhook zugestellt (Push) oder per periodischer API-Abfrage geholt wird (Pull), ist nicht nur eine Frage der Reaktionszeit. Beide Varianten verteilen Zugänge, Angriffsfläche und Nachweise unterschiedlich.

Webhook (Push)Abfrage (Pull)
Wer braucht Zugang?
Sender braucht die URL und ein Geheimnis des EmpfängersAbfragender braucht Zugangsdaten zum Quellsystem
Angriffsfläche
Eingehender Endpunkt beim EmpfängerAusgehende Verbindung, gespeicherte Zugangsdaten
Datenumfang
Bestimmt der SenderBestimmt der Abfragende im Rahmen seiner Rechte
Nachweis
Zustellprotokoll beim Sender, Eingangslog beim EmpfängerZugriffslog im Quellsystem
Vollständigkeit
Verluste bei Ausfall möglichNächste Abfrage holt Änderungen nach

Beide Varianten lassen sich gut kontrollieren, wenn die Verantwortung klar ist. Ein Beispiel für Pull: Bei der CCT Software Solutions GmbH fragt laut Referenzbericht eine REST-API-Schnittstelle die Events der Monitoring-Software laufend ab und eröffnet bei einem erkannten Problem automatisch ein Ticket in ky2help®.

Und Message Broker?

Innerhalb einer Organisation werden Ereignisse oft über Broker wie Kafka verteilt. Sie speichern Nachrichten und erlauben eine Wiederholung. Über Organisationsgrenzen hinweg sind Webhooks verbreiteter, weil sie nur HTTPS voraussetzen. Für Informatik-Verantwortliche heisst das: Der Broker ist eine interne Komponente mit eigener Betriebsverantwortung, der Webhook eine Schnittstelle zu Dritten mit Vertragsbezug.

Webhooks in ein Kontrollsystem einbinden

In regulierten Umgebungen sollte ein Webhook denselben Lebenszyklus durchlaufen wie jede andere Schnittstelle mit Datenbezug. Ein bewährter Ablauf:

  1. Antrag: Fachbereich und Informatik beschreiben Zweck, Ereignistypen, Datenkategorien und Empfänger.
  2. Beurteilung: Enthält die Nutzlast Personendaten? Liegt der Empfänger im Ausland? Wird ein Auftragsbearbeiter eingebunden? Reicht eine schlanke Nutzlast?
  3. Freigabe: Nach dem Vier-Augen-Prinzip durch eine Person, die den Webhook nicht selbst einrichtet.
  4. Umsetzung als Change: URL, Schlüssel und Ereignisfilter werden kontrolliert eingeführt und dokumentiert.
  5. Inventar und Überprüfung: Jeder Webhook steht mit verantwortlicher Person im Verzeichnis und wird periodisch auf Notwendigkeit, Umfang und Schlüsselwechsel geprüft.
  6. Ausserbetriebnahme: Abonnement löschen, Schlüssel widerrufen, Endpunkt schliessen.

Rechtlicher Rahmen in der Schweiz

  • DSG Art. 8 sowie DSV Art. 2 und 3: Verantwortliche müssen eine dem Risiko angemessene Datensicherheit gewährleisten. Die Datenschutzverordnung nennt in Art. 2 die Schutzziele Vertraulichkeit, Verfügbarkeit, Integrität und Nachvollziehbarkeit und in Art. 3 die Massnahmen, mit denen sie erreicht werden.
  • DSG Art. 9: Übernimmt ein Dienstleister die Bearbeitung, etwa ein Cloud-Dienst als Empfänger, muss sich der Verantwortliche vergewissern, dass dieser die Datensicherheit gewährleisten kann.
  • DSG Art. 16: Geht ein Webhook mit Personendaten an einen Empfänger im Ausland, sind die Regeln zur Bekanntgabe ins Ausland zu prüfen.
  • DSV Art. 4: Werden besonders schützenswerte Personendaten in grossem Umfang automatisiert bearbeitet oder Profilings mit hohem Risiko durchgeführt und genügen präventive Massnahmen nicht, ist eine Protokollierung vorgeschrieben.
  • Branchen: Banken berücksichtigen zusätzlich das FINMA-Rundschreiben 2023/1 «Operationelle Risiken und Resilienz – Banken». Betreiber kritischer Infrastrukturen müssen Cyberangriffe seit dem 1. April 2025 innert 24 Stunden dem BACS melden.

Ein ITSM-System hilft, den Lebenszyklus nachweisbar zu machen. Change Enablement gehört zu den 13 von PeopleCert akkreditierten ITIL®-Practices von ky2help®, und Änderungen werden automatisch historisiert. Wie lückenlose Nachvollziehbarkeit in der Praxis aussieht, zeigt das Personalamt des Kantons Thurgau.

Change Management ansehen

Risiken nach Priorität

Priorität 1: gefälschte Aufrufe

Ein Endpunkt ohne Signaturprüfung führt jede Anfrage aus, die ihn erreicht. Kontrolle: Signatur und Zeitstempel bei jedem Aufruf prüfen, ungültige Aufrufe abweisen und protokollieren. Statische Absender-IP-Adressen, die manche Anbieter veröffentlichen, sind eine Ergänzung, kein Ersatz.

Priorität 2: offengelegte Geheimnisse

Schlüssel und geheime URLs landen leicht in Tickets, Konfigurationsdateien oder Protokollen. GitHub warnt ausdrücklich davor, Zugangsdaten in die Ziel-URL zu schreiben. Kontrolle: Ablage in einem Tresor, Rotation nach festem Ablauf und bei Personalwechsel, Maskierung in Logs.

Priorität 3: Server-Side Request Forgery

Bietet eine eigene Anwendung Webhooks an, kann ein Angreifer eine interne Adresse als Ziel eintragen. Die OWASP API Security Top 10 nennen Webhooks bei API7:2023 ausdrücklich als Ursache. Kontrolle: Zustellung über einen Proxy, der interne Adressbereiche sperrt, und ein abgeschottetes Netzsegment für den Versand.

Priorität 4: zu breite Nutzlast

Vollständige Nutzlasten senden alle Daten an jeden Empfänger, auch an solche, die sie nicht brauchen. Kontrolle: schlanke Nutzlasten mit Abruf über die API, Prüfung der Datenkategorien bei der Freigabe, Dokumentation der Empfängerländer.

Priorität 5: Verlust und Duplikate

Microsoft Graph wiederholt Zustellungen bis zu 4 Stunden und kann bei dauerhaft langsamen Endpunkten Benachrichtigungen verwerfen, die nicht wiederherstellbar sind. Andere Sender wiederholen gar nicht. Kontrolle: idempotente Verarbeitung über die Ereignis-ID, periodischer Abgleich mit dem Quellsystem, Alarm bei ausbleibenden Ereignissen.

Schnittstellen kontrolliert in Serviceprozesse einbinden

Wer Integrationen prüfbar betreiben will, braucht dokumentierte Abläufe von der Meldung bis zur Erledigung. In einer Live-Demo zeigen wir Ihnen, wie ky2help® das unterstützt.

  • Automatische Historisierung, integriertes Daten-Audit, revisionssicher
  • Betrieb als SaaS mit eigener Instanz im Rechenzentrum in der Schweiz oder On-Premises
  • Hersteller nach ISO/IEC 27001 zertifiziert

Live-Demo vereinbaren

Oder ein Beratungsgespräch buchen

Fragen und Antworten zu Webhooks

Was ist ein Webhook?

Ein Webhook ist eine ereignisgesteuerte Schnittstelle: Tritt in einem System ein definiertes Ereignis ein, übermittelt es die zugehörigen Daten selbstständig per HTTP an die hinterlegte Adresse eines anderen Systems.

Ist ein Webhook mit Personendaten datenschutzrechtlich relevant?

Ja. Übermittelt ein Webhook Personendaten, ist das eine Bearbeitung im Sinne des DSG. Es gelten unter anderem die Anforderungen an die Datensicherheit nach Art. 8. Bei Dienstleistern als Empfänger ist Art. 9, bei Empfängern im Ausland Art. 16 zu prüfen.

Wie lässt sich die Echtheit eines Webhooks prüfen?

Üblich ist eine Signatur über die Nutzlast, meist HMAC-SHA256 mit einem Geheimnis je Endpunkt oder ein asymmetrisches Verfahren wie ed25519. Der Empfänger prüft Signatur und Zeitstempel und verwirft bereits bekannte Ereignis-IDs.

Was sollte protokolliert werden?

Mindestens Eingang, Ergebnis der Signaturprüfung, Ereignis-ID, Zeitpunkt und ausgelöste Aktion, ohne Geheimnisse im Klartext. Unter den Voraussetzungen von Art. 4 DSV ist eine Protokollierung vorgeschrieben, die mindestens ein Jahr getrennt aufzubewahren ist.

Wie oft sollten Webhooks überprüft werden?

Eine gesetzliche Frist gibt es dafür nicht. Bewährt hat sich, Webhooks im selben Rhythmus wie Berechtigungen zu rezertifizieren und zusätzlich bei Änderungen am Empfänger, bei Personalwechsel und nach Sicherheitsvorfällen zu prüfen.

Wie unterstützt ky2help® kontrollierte Integrationen?

ky2help® bietet Standardschnittstellen und eine REST-API für Webservices. Änderungen werden automatisch historisiert, ein Daten-Audit ist integriert, und Change Enablement gehört zu den 13 akkreditierten ITIL®-Practices.

Alle Glossar-Artikel in der Übersicht

Erfahren Sie, wie Microsofts Verzeichnisdienst Benutzer, Geräte und Rechte zentral verwaltet – sicher & zukunftsfähig für Unternehmen.

Mehr zu Active Directory

Was ist eine API? Erfahren Sie, wie Programmierschnittstellen Anwendungen verbinden, Prozesse automatisieren und Innovation in der digitalen Wirtschaft ermöglichen.

Mehr über API's

Was ist Authentifizierung? Erfahren Sie, wie Identitäten geprüft, Konten geschützt und moderne Anmeldeverfahren wie Zwei-Faktor-Authentifizierung Ihre Sicherheit erhöhen.

Zur Authentifizierung

Was ist ein Backlog? Erfahren Sie, wie priorisierte Aufgabenlisten Teams helfen, Projekte agil zu steuern, Prioritäten zu setzen und Fortschritte transparent zu machen.

Mehr über Backlog

Erfahren Sie, wie eine Balanced Scorecard Unternehmen hilft, Strategie, Ziele und Kennzahlen zu verbinden und Erfolge messbar zu machen.

Zur Balanced Scorecard

Das Change Advisory Board (CAB) berät bei der Bewertung und Freigabe von Changes im IT Service Management. Erfahren Sie, wann ein CAB gebraucht wird und wie ITIL 4 die Freigabe regelt.

Mehr zum CAB

Gesteuerter Change-Prozess mit Risikoanalyse, CAB-Freigaben und Kommunikation, um Ausfallzeiten zu reduzieren und Releasessicher in Produktionsumgebungen zu bringen.

Mehr zu Change Management

Erfahren Sie, wie KI-gestützte Chatbots Kommunikation automatisieren, Kundenservice verbessern und Prozesse effizienter gestalten.

Mehr zu Chatbots

Was ist Continuous Integration? Erfahren Sie, wie automatisierte Builds und Tests Entwicklungsprozesse beschleunigen, Fehler vermeiden und Softwarequalität steigern.

Mehr dazu

Zentrale Konfigurationsdatenbank mit CIs und Beziehungen für Transparenz, Abhängigkeits-/Impact-Analysen, Audit-Sicherheit und Change-/Incident-Beschleunigung.

Mehr über CMDB

Was ist CSI? Erfahren Sie, wie Continual Service Improvement in ITIL hilft, IT-Services dauerhaft zu optimieren, Qualität zu steigern und Kundenzufriedenheit zu sichern.

Mehr über CSI

Der Customer Effort Score ist eine Kennzahl, die beschreibt, wie viel Aufwand ein Kunde betreiben muss, um sein Anliegen mit einem Unternehmen zu lösen.

Mehr über CES

Was ist DevOps? Erfahren Sie, wie Entwicklung und IT-Betrieb durch Automatisierung, Zusammenarbeit und CI/CD zu schnelleren, stabileren Software-Releases führen.

Mehr über DevOps

Was ist die DSGVO? Erfahren Sie, wie die Datenschutz-Grundverordnungpersonenbezogene Daten schützt, welche Pflichten Unternehmen haben und welche Rechte Betroffene haben.

Mehr über DSGVO

Was ist ESM? Erfahren Sie, wie Enterprise Service Management Prozesse vereinheitlicht, Services digitalisiert und alle Abteilungen effizient miteinander verbindet.

Mehr über ESM

Was ist Hardware Asset Management? Erfahren Sie, wie Unternehmen mit HAM ihre IT-Geräte effizient verwalten, Kosten senken und Sicherheit im gesamten Lebenszyklus sichern.

Mehr über HAM

Ein Helpdesk ist die zentrale Schnittstelle zwischen den Anwendern eines Unternehmens und den dafür zuständigen Support-Teams. 

Mehr über Helpdesk

Ein Incident ist eine Beeinträchtigung eines IT-Services, die dazu führt, dass der Service nicht wie vorgesehen genutzt werden kann.

Mehr über Incident

Erfahren Sie, wie der internationale Standard Unternehmen hilft, Informationssicherheit systematisch aufzubauen, Risiken zu minimieren und Vertrauen zu schaffen.

Mehr über Incident

Erfahren Sie, wie das Framework IT-Prozesse strukturiert, Qualität sichert und die IT an den Geschäftszielen ausrichtet – praxisnah und modern mit ITIL 4 oder ITIL 5.

Mehr über ITIL

IT Service Management (ITSM) beschreibt die Gesamtheit spezialisierter organisatorischer Fähigkeiten, um IT-Services effizient zu betreiben.

Mehr über ITSM

Erfahren Sie, wie die japanische Kaizen-Methode durch kleine, stetige Verbesserungen Prozesse optimiert, Qualität steigert und Mitarbeitende einbindet.

Mehr über Kaizen

Erfahren Sie, wie die Kanban-Methode durch Visualisierung, Flusssteuerung und kleine Verbesserungen Teams effizienter und flexibler arbeiten lässt.

Mehr über Kanban

Key Performance Indicators (KPIs) machen Ziele messbar, bewerten Leistung und unterstützen datenbasierte Entscheidungen im Unternehmen.

Mehr über KPIs

Erfahren Sie, wie KI funktioniert, wo sie eingesetzt wird und warum sie unsere Arbeitswelt verändert – zwischen Innovation und Verantwortung.

Mehr über KI

Machine Learning ist ein Teilgebiet der Künstlichen Intelligenz (KI). Es ermöglicht Systemen, Muster und Zusammenhänge in Daten eigenständig zu erkennen.

Mehr zu Machine Learning

Erfahren Sie, wie Multi-Faktor-Authentifizierung funktioniert, warum sie Konten wirksam schützt und welche Methoden besonders sicher und benutzerfreundlich sind.

Mehr über MFA

Erfahren Sie, wie die systematische Überwachung von IT-Systemen Leistung, Sicherheit und Verfügbarkeit verbessert – für stabile und effiziente Prozesse.

Mehr über Monitoring

Erfahren Sie, wie Natural Language Processing funktioniert, wo es eingesetzt wird und warum es Kommunikation, Analyse und Serviceprozesse revolutioniert.

Mehr über NLP erfahren

Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.

Mehr über den NPS

Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.

Mehr über den NPS

Operational Level Agreements (OLA) regelt interne Zusammenarbeit, unterstützt SLA-Ziele unterstützen und macht Serviceprozesse verlässlicher. 

Mehr zu OLA

Operational Performance Indicator (OPI) sind ein zentrales Instrument, um die Leistungsfähigkeit operativer Prozesse in Unternehmen messbar zu machen. 

Mehr zu OPI

Predictive Maintenance ist ein moderner Instandhaltungsansatz, der nicht auf starre Intervalle setzt, sondern auf datenbasierte Vorhersagen.

Zu Predictive Maintenance

Die Root Cause Analysis (RCA) ist eine strukturierte Methode, um Ursachen eines Problems oder einer Störung zu identifizieren und zu beseitigen. 

Mehr über RCA

Was ist eine REST API? Erfahren Sie, wie REST-Schnittstellen Systeme verbinden, Daten austauschen und moderne Anwendungen schnell, flexibel und skalierbar machen.

Mehr zu REST API

Was ist eine Root Cause Analysis? Lernen Sie Methoden wie 5 Why, Ishikawa und Fehlerbaum kennen und erfahren Sie, welche Methode zu welcher Störung passt.

Zur Root Cause Analysis

Was ist Scrum? Erfahren Sie, wie das agile Framework Teams hilft, flexibel zu arbeiten, schneller Ergebnisse zu liefern und Projekte kontinuierlich zu verbessern.

Mehr zu Scrum

Verständlich erklärt: Wie Service Level Agreements Leistungen definieren, Qualität messbar machen und Servicebeziehungen strukturieren.

Mehr über SLA erfahren

Was ist SSO? Erfahren Sie, wie Single Sign-On funktioniert, wie es Sicherheit und Komfort verbindet und warum es in modernen IT-Landschaften unverzichtbar ist.

Mehr zu SSO

Erfahren Sie, wie das Software Asset Management (SAM) Softwarebestände transparent macht, Kosten optimiert und Compliance sowie IT-Sicherheit stärkt.

Mehr zu SAM

Kompakt erklärt: Wie Sprints Teams helfen, in kurzen Zyklen zu planen, zu liefern und sich kontinuierlich zu verbessern.

Mehr zu Sprints

Was ist eine SOP? Erfahren Sie, wie Standard Operating Procedures Abläufe standardisieren, Qualität sichern und Organisationen zuverlässiger machen.

Mehr zu SOP

Erfahren Sie, wie User Experience entsteht, warum sie entscheidend für Erfolg und Zufriedenheit ist und wie gute Nutzererlebnisse gestaltet werden.

Mehr zu User Experience

Webhooks ermöglichen es, Ereignisse aus einem System in Echtzeit an ein anderes zu übermitteln, ohne dass ständige Abfragen erforderlich sind. 

Mehr zu Webhooks

Was ist ein Workflow? Erfahren Sie, wie strukturierte Abläufe Prozesse vereinfachen, Qualität sichern und Unternehmen effizienter machen.

Mehr über Workflows