Webhooki Raportowania SonarQube
Dowiedz się, jak działają webhooki SonarQube w Procurize AI, w tym konfiguracja, struktura ładunku, weryfikacja bezpieczeństwa oraz zachowanie przy ponownych próbach.
Przegląd
Webhooki Procurize umożliwiają zewnętrznym systemom otrzymywanie powiadomień, gdy nowe raporty SonarQube zostaną załadowane lub zaktualizowane.
Konfigurowanie webhooków
Webhooki można dodać lub edytować w panelu ustawień organizacji, w sekcji Raporty bezpieczeństwa pod adresem https://dashboard.procurize.ai.
Należy pamiętać, że dostęp do panelu ustawień wymaga autoryzacji, a dostęp do panelu ustawień organizacji wymaga roli użytkownika co najmniej Administrator w tej organizacji.
Aby przetestować webhooki, możesz użyć popularnych usług online, takich jak https://webhook-test.com
Ładunek Webhooka
Zdarzenia webhooka są dostarczane jako żądania HTTP POST z ładunkiem JSON.
Przykładowy Ładunek
{
"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"
}
]
}
Bezpieczeństwo Webhooka
Aby zapewnić autentyczność, żądania webhooka zawierają nagłówek podpisu generowany przy użyciu wspólnego sekretu.
- Podpis jest obliczany przy użyciu HMAC‑SHA256
- Klienci powinni weryfikować podpis przed przetworzeniem ładunku
Zapobiega to nieautoryzowanym lub sfałszowanym dostawom webhooków.
Dostawa i Ponowne Próby
- Webhooki oczekują odpowiedzi
2xx, aby zostały uznane za pomyślnie dostarczone - Nieudane dostawy są automatycznie ponawiane co godzinę.
- Zdarzenia mogą być dostarczane wielokrotnie; odbiorcy powinni implementować przetwarzanie idempotentne
Typowe Przypadki Użycia
- Automatyczne pobieranie wyników SonarQube do wewnętrznych pulpitów bezpieczeństwa
- Uruchamianie przepływów zgodności, gdy bramki jakości nie zostaną spełnione
- Archiwizowanie raportów bezpieczeństwa na potrzeby audytów i przeglądów ryzyka dostawców
- Utrzymywanie synchronizacji systemów zewnętrznych z najnowszym stanem bezpieczeństwa kodu
Zobacz także:
Powiązane artykuły
Czym są Raporty Bezpieczeństwa?