osFoundry / Platform
Ausgehende Webhooks
Verteilen Sie Plattform-Ereignisse an Ihre eigenen Endpunkte. Auto-Retry, Signaturprüfung.
Was es ist
Mit Outbound-Webhooks schickt osFoundry Events an Endpunkte, die Sie kontrollieren. Statt Änderungen abzufragen, registrieren Sie eine URL, und osFoundry sendet eine HTTP-Anfrage dorthin, sobald in Ihrem Workspace ein relevantes Event auftritt. So wird Aktivität in Ihren Bereichen für Chat, Agenten, Apps, Code, Wissen und Daten zu einem Signal, auf das Ihre eigenen Systeme reagieren können, ohne für jeden Fall eine eigene Integration bauen zu müssen.
Innerhalb von osFoundry liegen Webhooks unter Einstellungen und Sicherheit, denn sie überschreiten eine Vertrauensgrenze: Sie tragen Workspace-Events nach außen zu einem Empfänger, der Ihnen gehört. Jede Zustellung ist signiert, sodass Ihr Endpunkt prüfen kann, dass die Anfrage tatsächlich von osFoundry stammt und unterwegs nicht manipuliert wurde. Prüfen Sie die Signatur gegen Ihr gemeinsames Geheimnis, bevor Sie dem Body vertrauen. Zustellungen, die fehlschlagen, weil Ihr Endpunkt ausgefallen oder langsam war oder einen Fehler zurückgab, werden automatisch wiederholt statt verworfen, sodass ein kurzer Ausfall auf Ihrer Seite nicht stillschweigend Events verliert. Da osFoundry local-first arbeitet und Sie Ihre eigenen Schlüssel mitbringen (BYOK), sind Webhooks der bewusste, aktiv gewählte Weg, Daten nach außen zu bewegen: Sie entscheiden, welche Endpunkte Events erhalten, und Payloads gehen nur dorthin, wohin Sie sie leiten.
Der praktische Nutzen ist die Entkopplung. Ihr Benachrichtigungsdienst, Ihr Ticketsystem, Ihr Data Warehouse oder eine hauseigene Automatisierung muss weder innerhalb von osFoundry laufen noch osFoundry-Zugangsdaten vorhalten. Er muss nur einen HTTPS-Endpunkt bereitstellen, der eine Signatur prüft und einen Erfolgsstatus zurückgibt. Signaturprüfung und automatische Wiederholung machen diesen Endpunkt vertrauenswürdig und verlässlich, und genau darin liegt der Unterschied zwischen einem Webhook, auf dem Sie einen Workflow aufbauen können, und einem, den Sie ständig beaufsichtigen müssen.
Wichtige Funktionen
- Registrieren Sie Ihre eigenen HTTPS-Endpunkte und empfangen Sie Plattform-Events in dem Moment, in dem sie auftreten, ohne eine Polling-Schleife zu pflegen
- Jede Payload ist signiert, sodass Ihr Empfänger prüfen kann, dass die Anfrage von osFoundry stammt, bevor er darauf reagiert
- Fehlgeschlagene Zustellungen werden automatisch wiederholt, sodass ein Ausfall stromabwärts nicht stillschweigend Events verwirft
- Verwaltet unter Einstellungen und Sicherheit als aktiv gewählter, pro Endpunkt vollständig von Ihnen kontrollierter Ausgangsweg
- Passt zum local-first-, BYOK-Modell: Daten verlassen das System nur zu den Endpunkten, die Sie ausdrücklich angeben
Anwendungsfälle
- Plattform-Engineer: Workspace-Events an einen internen Automatisierungsdienst weiterleiten, ohne ihm osFoundry-Zugangsdaten zu geben oder ihn in die App einzubetten
- Ops/Bereitschaft: Events in ein bestehendes Alarmierungs- oder Benachrichtigungssystem leiten, damit die richtigen Leute in Echtzeit von Aktivität erfahren
- Data-Team: Events an ein Warehouse oder einen ETL-Endpunkt streamen, um einen externen Datenbestand mit dem Geschehen im Workspace synchron zu halten
Häufig gestellte Fragen
Wie prüfe ich, dass eine Webhook-Anfrage tatsächlich von osFoundry kam?
Jede Zustellung ist signiert. Ihr Endpunkt berechnet die Signatur über den Anfrage-Body mithilfe Ihres gemeinsamen Geheimnisses neu und vergleicht sie mit der Signatur, die osFoundry sendet. Stimmen sie nicht überein, weisen Sie die Anfrage ab. Genau das verhindert, dass Dritte Events an Ihren Endpunkt fälschen.
Was passiert, wenn mein Endpunkt ausgefallen ist, während ein Event ausgelöst wird?
osFoundry wiederholt die Zustellung automatisch, statt sie zu verwerfen, sodass ein kurzer Ausfall oder ein Deployment auf Ihrer Seite Sie keine Events kostet. Ihr Endpunkt sollte einen Erfolgsstatus zurückgeben, sobald er die Payload angenommen hat.
Werden meine Daten durch Webhooks an einen von osFoundry kontrollierten Ort gesendet?
Nein. osFoundry ist local-first und BYOK, und Webhooks gehen ausgehend an Endpunkte, die Sie registrieren. Events gehen nur an die URLs, die Sie konfigurieren, und Sie kontrollieren, welche Endpunkte existieren. Es ist ein aktiv gewählter Weg, um bestimmte Events an Systeme zu bewegen, die Ihnen bereits gehören.