- KYBERNA AI
-
ITSM & ESM Software
- ITSM & ESM Software ky2help®
- Lösung nach Branchen
- Bauunternehmen & Baugewerbe
- Finanzdienstleistungen & Banken
- Gesundheitswesen & Kliniken
- Hospitality & Hotelgruppen
- Industrie & Fertigung
- IT-Dienstleister, MSPs & Systemhäuser
- Öffentliche Verwaltung & Behörden
- Sicherheitsdienste & Leitstellen
- Telekommunikation & Netzbetreiber
- Versicherungen & Sozialversicherungen
- ky2help® Referenzen
- Kontakt
- ITSM & ESM Wissenswelt
- Glossar
- IT Services
- eAuktion
- Über uns
- News & Blog
- Support

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.
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ängers | Abfragender braucht Zugangsdaten zum Quellsystem |
| Angriffsfläche | |
| Eingehender Endpunkt beim Empfänger | Ausgehende Verbindung, gespeicherte Zugangsdaten |
| Datenumfang | |
| Bestimmt der Sender | Bestimmt der Abfragende im Rahmen seiner Rechte |
| Nachweis | |
| Zustellprotokoll beim Sender, Eingangslog beim Empfänger | Zugriffslog im Quellsystem |
| Vollständigkeit | |
| Verluste bei Ausfall möglich | Nä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:
- Antrag: Fachbereich und Informatik beschreiben Zweck, Ereignistypen, Datenkategorien und Empfänger.
- Beurteilung: Enthält die Nutzlast Personendaten? Liegt der Empfänger im Ausland? Wird ein Auftragsbearbeiter eingebunden? Reicht eine schlanke Nutzlast?
- Freigabe: Nach dem Vier-Augen-Prinzip durch eine Person, die den Webhook nicht selbst einrichtet.
- Umsetzung als Change: URL, Schlüssel und Ereignisfilter werden kontrolliert eingeführt und dokumentiert.
- Inventar und Überprüfung: Jeder Webhook steht mit verantwortlicher Person im Verzeichnis und wird periodisch auf Notwendigkeit, Umfang und Schlüsselwechsel geprüft.
- 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.
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.
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.
Quellen und vertiefende Artikel
Quellen
- Fedlex: Bundesgesetz über den Datenschutz (DSG) und Datenschutzverordnung (DSV)
- FINMA: Rundschreiben 2023/1 «Operationelle Risiken und Resilienz – Banken»
- BACS: Meldepflicht für Cyberangriffe
- Standard Webhooks: Spezifikation (Signaturen, Nutzlasten, Zustellung)
- W3C: WebSub · CNCF: CloudEvents HTTP Web Hooks
- OWASP: API7:2023 Server Side Request Forgery und SSRF Prevention Cheat Sheet
- Microsoft Learn: Webhooks für Microsoft Graph
Vertiefen im Glossar
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.
Was ist Authentifizierung? Erfahren Sie, wie Identitäten geprüft, Konten geschützt und moderne Anmeldeverfahren wie Zwei-Faktor-Authentifizierung Ihre Sicherheit erhöhen.
Was ist ein Backlog? Erfahren Sie, wie priorisierte Aufgabenlisten Teams helfen, Projekte agil zu steuern, Prioritäten zu setzen und Fortschritte transparent zu machen.
Erfahren Sie, wie eine Balanced Scorecard Unternehmen hilft, Strategie, Ziele und Kennzahlen zu verbinden und Erfolge messbar zu machen.
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.
Erfahren Sie, wie KI-gestützte Chatbots Kommunikation automatisieren, Kundenservice verbessern und Prozesse effizienter gestalten.
Was ist Continuous Integration? Erfahren Sie, wie automatisierte Builds und Tests Entwicklungsprozesse beschleunigen, Fehler vermeiden und Softwarequalität steigern.
Zentrale Konfigurationsdatenbank mit CIs und Beziehungen für Transparenz, Abhängigkeits-/Impact-Analysen, Audit-Sicherheit und Change-/Incident-Beschleunigung.
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.
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.
Was ist DevOps? Erfahren Sie, wie Entwicklung und IT-Betrieb durch Automatisierung, Zusammenarbeit und CI/CD zu schnelleren, stabileren Software-Releases führen.
Was ist die DSGVO? Erfahren Sie, wie die Datenschutz-Grundverordnungpersonenbezogene Daten schützt, welche Pflichten Unternehmen haben und welche Rechte Betroffene haben.
Was ist ESM? Erfahren Sie, wie Enterprise Service Management Prozesse vereinheitlicht, Services digitalisiert und alle Abteilungen effizient miteinander verbindet.
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.
Ein Helpdesk ist die zentrale Schnittstelle zwischen den Anwendern eines Unternehmens und den dafür zuständigen Support-Teams.
Ein Incident ist eine Beeinträchtigung eines IT-Services, die dazu führt, dass der Service nicht wie vorgesehen genutzt werden kann.
Erfahren Sie, wie der internationale Standard Unternehmen hilft, Informationssicherheit systematisch aufzubauen, Risiken zu minimieren und Vertrauen zu schaffen.
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.
IT Service Management (ITSM) beschreibt die Gesamtheit spezialisierter organisatorischer Fähigkeiten, um IT-Services effizient zu betreiben.
Erfahren Sie, wie die japanische Kaizen-Methode durch kleine, stetige Verbesserungen Prozesse optimiert, Qualität steigert und Mitarbeitende einbindet.
Erfahren Sie, wie die Kanban-Methode durch Visualisierung, Flusssteuerung und kleine Verbesserungen Teams effizienter und flexibler arbeiten lässt.
Key Performance Indicators (KPIs) machen Ziele messbar, bewerten Leistung und unterstützen datenbasierte Entscheidungen im Unternehmen.
Erfahren Sie, wie KI funktioniert, wo sie eingesetzt wird und warum sie unsere Arbeitswelt verändert – zwischen Innovation und Verantwortung.
Machine Learning ist ein Teilgebiet der Künstlichen Intelligenz (KI). Es ermöglicht Systemen, Muster und Zusammenhänge in Daten eigenständig zu erkennen.
Erfahren Sie, wie Multi-Faktor-Authentifizierung funktioniert, warum sie Konten wirksam schützt und welche Methoden besonders sicher und benutzerfreundlich sind.
Erfahren Sie, wie die systematische Überwachung von IT-Systemen Leistung, Sicherheit und Verfügbarkeit verbessert – für stabile und effiziente Prozesse.
Erfahren Sie, wie Natural Language Processing funktioniert, wo es eingesetzt wird und warum es Kommunikation, Analyse und Serviceprozesse revolutioniert.
Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.
Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.
Operational Level Agreements (OLA) regelt interne Zusammenarbeit, unterstützt SLA-Ziele unterstützen und macht Serviceprozesse verlässlicher.
Operational Performance Indicator (OPI) sind ein zentrales Instrument, um die Leistungsfähigkeit operativer Prozesse in Unternehmen messbar zu machen.
Predictive Maintenance ist ein moderner Instandhaltungsansatz, der nicht auf starre Intervalle setzt, sondern auf datenbasierte Vorhersagen.
Die Root Cause Analysis (RCA) ist eine strukturierte Methode, um Ursachen eines Problems oder einer Störung zu identifizieren und zu beseitigen.
Was ist eine REST API? Erfahren Sie, wie REST-Schnittstellen Systeme verbinden, Daten austauschen und moderne Anwendungen schnell, flexibel und skalierbar machen.
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.
Was ist Scrum? Erfahren Sie, wie das agile Framework Teams hilft, flexibel zu arbeiten, schneller Ergebnisse zu liefern und Projekte kontinuierlich zu verbessern.
Verständlich erklärt: Wie Service Level Agreements Leistungen definieren, Qualität messbar machen und Servicebeziehungen strukturieren.
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.
Erfahren Sie, wie das Software Asset Management (SAM) Softwarebestände transparent macht, Kosten optimiert und Compliance sowie IT-Sicherheit stärkt.
Kompakt erklärt: Wie Sprints Teams helfen, in kurzen Zyklen zu planen, zu liefern und sich kontinuierlich zu verbessern.
Was ist eine SOP? Erfahren Sie, wie Standard Operating Procedures Abläufe standardisieren, Qualität sichern und Organisationen zuverlässiger machen.
Erfahren Sie, wie User Experience entsteht, warum sie entscheidend für Erfolg und Zufriedenheit ist und wie gute Nutzererlebnisse gestaltet werden.
Webhooks ermöglichen es, Ereignisse aus einem System in Echtzeit an ein anderes zu übermitteln, ohne dass ständige Abfragen erforderlich sind.
Was ist ein Workflow? Erfahren Sie, wie strukturierte Abläufe Prozesse vereinfachen, Qualität sichern und Unternehmen effizienter machen.