Vous pouvez utiliser un webhook de votre espace de travail pour envoyer des événements d’analyse à un service que vous contrôlez. Par exemple, vous pouvez mettre à jour un tableau de bord de sécurité à la fin d’une analyse ou actualiser un ticket lorsque les résultats changent. Chaque destination reçoit les événements que vous avez sélectionnés pour elle et qui proviennent de l’ensemble de votre espace de travail ChatGPT.
Ajouter un webhook à l’espace de travail
-
Dans Daybreak, accédez à Paramètres > Notifications, puis sélectionnez Ajouter.
-
Renseignez les champs Nom et URL du point de terminaison. Utilisez un point de terminaison HTTPS accessible publiquement qui accepte les requêtes
POSTsur le port 443. -
Choisissez les événements à recevoir.
- Analyse terminée (
scan.finished) signale la fin d’une analyse, y compris en cas d’échec ou d’annulation. - Analyse mise à jour (
scan.updated) signale les modifications ultérieures des résultats d’une analyse, par exemple un changement de statut de validation ou de niveau de gravité.
- Analyse terminée (
-
Sélectionnez Ajouter. Copiez le secret de signature et conservez-le en lieu sûr. Daybreak n’affiche le secret complet qu’une seule fois.
-
Dans le menu de la destination, sélectionnez Envoyer une notification de test, puis Envoyer le test. Daybreak envoie un exemple d’événement
scan.finishedavecis_test: trueet confirme la livraison lorsque votre point de terminaison renvoie une réponse2xx.
Vérifier et traiter les notifications reçues
Daybreak envoie une requête POST au format JSON signée avec HMAC-SHA256. La signature couvre webhook-id, webhook-timestamp et le corps d’origine de la requête. Avant de traiter l’événement, vérifiez la requête à l’aide de l’en-tête webhook-signature.
Transmettez à votre outil de vérification les octets d’origine du corps de la requête pour éviter qu’une modification des espaces ou de la mise en forme du JSON n’invalide la signature. Pour en savoir plus, consultez la spécification Standard Webhooks.
Pour trouver une bibliothèque de vérification adaptée à votre langage, consultez les implémentations de référence de Standard Webhooks.
Vérifiez is_test avant de déclencher votre workflow de production. Utilisez le champ id de la charge utile pour repérer les livraisons répétées du même événement et le champ data.scan_id pour regrouper les événements d’une même analyse. Daybreak accorde 10 secondes par tentative de livraison, y compris pour les tests. Dès que votre service a accepté l’événement, renvoyez une réponse 2xx dans ce délai. Si le traitement demande plus de temps, placez l’événement dans une file d’attente et répondez avant de le traiter.
Gérer les destinations et renouveler les secrets
Sélectionnez Modifier dans le menu de la destination. Vous pouvez modifier l’URL, choisir d’autres événements ou désactiver l’option Activé pour suspendre les livraisons. Sélectionnez Renouveler le secret pour remplacer le secret de signature. Copiez le nouveau secret et mettez à jour votre service de réception. Si votre service a besoin de temps pour passer au nouveau secret, sélectionnez Garder le secret actuel actif pendant 24 heures lors du renouvellement. Pendant cette période, Daybreak signe chaque requête avec les deux secrets. Vous pouvez donc vérifier sa signature avec l’un ou l’autre. En cas de renouvellement immédiat, mettez à jour votre service de réception avant d’envoyer un nouveau test.