Webhooks Αναφοράς SonarQube
Μάθετε πώς λειτουργούν τα webhooks του SonarQube στο Procurize AI, συμπεριλαμβανομένης της ρύθμισης, της δομής του payload, της επαλήθευσης ασφαλείας και της συμπεριφοράς επαναπροσπάθειας.
Επισκόπηση
Τα webhooks του Procurize επιτρέπουν σε εξωτερικά συστήματα να λαμβάνουν ειδοποιήσεις όταν νέες αναφορές SonarQube εισάγονται ή ενημερώνονται.
Διαμόρφωση webhooks
Τα webhooks μπορούν να προστεθούν ή να επεξεργαστούν στον πίνακα ρυθμίσεων του οργανισμού, στην ενότητα Αναφορές Ασφάλειας στη διεύθυνση https://dashboard.procurize.ai.
Παρακαλούμε σημειώστε ότι η πρόσβαση στον πίνακα ρυθμίσεων απαιτεί εξουσιοδότηση, και η πρόσβαση στον πίνακα ρυθμίσεων του οργανισμού απαιτεί ρόλο χρήστη τουλάχιστον Διαχειριστή σε αυτόν τον οργανισμό.
Για να ελέγξετε τα webhooks, μπορείτε να χρησιμοποιήσετε δημοφιλείς διαδικτυακές υπηρεσίες όπως https://webhook-test.com
Payload Webhook
Τα γεγονότα webhooks παραδίδονται ως αιτήσεις HTTP POST με payload τύπου JSON.
Παράδειγμα Payload
{
"organizationId": "00000000-0000-0000-0000-000000000001",
"reports": [
{
"projectName": "Test product",
"id": "00000000-0000-0000-0000-000000000002",
"reportType": "CWE Top 25",
"reportVersion": 2024,
"projectVersion": "1.0",
"date": "2025-12-17T09:05:48.5946432+00:00",
"uploadDate": "2025-12-17T09:05:48.5946432+00:00",
"vulnerabilitiesCount": 0,
"securityRating": "A"
}
]
}
Ασφάλεια Webhook
Για να εξασφαλιστεί η αυθεντικότητα, τα αιτήματα webhook περιλαμβάνουν μια κεφαλίδα υπογραφής που δημιουργείται με χρήση κοινόμυστου.
- Η υπογραφή υπολογίζεται με HMAC‑SHA256
- Οι πελάτες πρέπει να επαληθεύουν την υπογραφή πριν επεξεργαστούν το payload
Αυτό αποτρέπει μη εξουσιοδοτημένες ή παραποιημένες παραδόσεις webhook.
Παράδοση και Επαναπροσπάθειες
- Τα webhooks θεωρούνται επιτυχώς παραδομένα όταν επιστρέφουν κωδικό
2xx - Αποτυχίες παράδοσης επαναπροσπαθούν αυτόματα κάθε ώρα.
- Τα γεγονότα μπορεί να παραδοθούν περισσότερες από μία φορές· οι καταναλωτές θα πρέπει να εφαρμόζουν αμετάβλητη (idempotent) επεξεργασία
Συνηθισμένες Περιπτώσεις Χρήσης
- Αυτόματη εισαγωγή ευρημάτων SonarQube σε εσωτερικούς πίνακες ασφαλείας
- Έναρξη ροών εργασίας συμμόρφωσης όταν αποτυγχάνουν τα quality gates
- Αρχειοθέτηση αναφορών ασφαλείας για ελέγχους και αξιολογήσεις κινδύνου προμηθευτών
- Διατήρηση συγχρονισμού τρίτων συστημάτων με την πιο πρόσφατη κατάσταση ασφαλείας του κώδικα