Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Daybreak-Benachrichtigungen

Sende Scan-Ereignisse aus Daybreak an einen Workspace-Webhook.

Mit einem Workspace-Webhook kannst du Scan-Ereignisse an einen Dienst senden, den du kontrollierst. Damit kannst du zum Beispiel ein Sicherheitsdashboard aktualisieren, wenn ein Scan endet, oder ein Ticket aktualisieren, wenn sich die Scan-Ergebnisse ändern. Jedes Ziel empfängt die dafür ausgewählten Ereignisse aus deinem gesamten ChatGPT-Workspace.

Workspace-Webhook hinzufügen

  1. Öffne in Daybreak Einstellungen > Benachrichtigungen und wähle Hinzufügen aus.

  2. Gib einen Namen und eine Endpunkt-URL ein. Verwende einen öffentlich erreichbaren HTTPS-Endpunkt, der POST-Anfragen auf Port 443 annimmt.

  3. Wähle die Ereignisse aus, die du empfangen möchtest.

    • Scan beendet (scan.finished) meldet, wenn ein Scan erfolgreich abgeschlossen wird, fehlschlägt oder abgebrochen wird.
    • Scan aktualisiert (scan.updated) meldet nachträgliche Änderungen an den Scan-Ergebnissen, etwa wenn sich das Validierungsergebnis oder der Schweregrad ändert.
  4. Wähle Hinzufügen aus. Kopiere den Signaturschlüssel und bewahre ihn sicher auf. Daybreak zeigt den vollständigen Schlüssel nur einmal an.

  5. Wähle im Menü des Ziels zuerst Testbenachrichtigung senden und dann Test senden aus. Daybreak sendet ein Beispielereignis vom Typ scan.finished mit is_test: true und bestätigt die Zustellung, wenn dein Endpunkt eine 2xx-Antwort zurückgibt.

Zustellungen prüfen und verarbeiten

Daybreak sendet eine mit HMAC-SHA256 signierte POST-Anfrage im JSON-Format. Die Signatur umfasst webhook-id, webhook-timestamp und den ursprünglichen Anfrageinhalt. Prüfe die Signatur der Anfrage anhand des Headers webhook-signature, bevor du das Ereignis verarbeitest. Übergib den Anfrageinhalt zur Prüfung in seiner ursprünglichen Bytefolge, damit Änderungen an Leerraumzeichen oder der JSON-Formatierung die Signatur nicht ungültig machen. Einzelheiten findest du in der Spezifikation von Standard Webhooks. Bibliotheken zur Signaturprüfung für verschiedene Programmiersprachen findest du in den Referenzimplementierungen von Standard Webhooks.

Prüfe is_test, bevor du deinen Workflow im Produktivbetrieb auslöst. An der id in den Nutzdaten erkennst du wiederholte Zustellungen. Mit data.scan_id kannst du Ereignisse desselben Scans gruppieren. Daybreak wartet bei jedem Zustellversuch bis zu 10 Sekunden auf eine Antwort. Das gilt auch für Testzustellungen. Sende innerhalb dieser Frist eine 2xx-Antwort, sobald dein Dienst das Ereignis angenommen hat. Wenn die Verarbeitung länger dauert, speichere das Ereignis in einer Warteschlange und antworte, bevor du es verarbeitest.

Ziele verwalten und Signaturschlüssel wechseln

Wähle im Menü des Ziels Bearbeiten aus. Du kannst die URL ändern, andere Ereignisse auswählen oder die Option Aktiviert ausschalten, um Zustellungen zu pausieren. Wähle Signaturschlüssel wechseln aus, um den Signaturschlüssel zu ersetzen. Kopiere den neuen Schlüssel und aktualisiere deinen Empfangsdienst. Wenn dein Empfangsdienst Zeit für die Umstellung benötigt, wähle beim Wechsel Aktuellen Signaturschlüssel 24 Stunden lang aktiv lassen aus. In diesem Zeitraum signiert Daybreak mit beiden Schlüsseln. Du kannst die Zustellung mit jedem der beiden Schlüssel prüfen. Wenn du den Schlüssel mit sofortiger Wirkung wechselst, aktualisiere den Empfangsdienst, bevor du eine neue Testbenachrichtigung sendest.