Webhook‑и за отчитане в SonarQube
Научете как работят webhook‑ите на SonarQube в Procurize AI, включително настройка, структура на payload‑а, проверка на сигурността и поведение при повторни опити.
Преглед
Webhook‑ите на Procurize позволяват на външни системи да получават известия, когато нови отчети от SonarQube бъдат заредени или актуализирани.
Конфигуриране на webhook‑и
Webhook‑ите могат да се добавят или редактират в панела за настройки на организацията, раздел Сигурност на докладите на https://dashboard.procurize.ai.
Моля, имайте предвид, че достъпът до панела за настройки изисква упълномощаване, а достъпът до панела за настройки на организацията изисква потребителска роля поне Администратор в тази организация.
За проверка на webhook‑ите можете да използвате популярни онлайн услуги като https://webhook-test.com
Payload на webhook
Събитията от webhook‑ите се изпращат като HTTP POST заявки с JSON payload.
Example 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.
Доставка и повторни опити
- Webhook‑ите очакват отговор
2xx, за да се смятат за успешно доставени - Неуспешните доставки се опитват автоматично отново на всеки час
- Събитията могат да бъдат доставени повече от веднъж; консуматорите трябва да реализират идемпотентна обработка
Типични случаи на употреба
- Автоматично внасяне на резултати от SonarQube във вътрешните табла за сигурност
- Задействане на процеси за съответствие, когато качествените порти не бъдат преминати
- Архивиране на сигурностни отчети за одити и прегледи на рисковете от доставчици
- Поддържане на синхрон между системите на трети страни и текущото състояние на сигурността на кода
Вижте също:
Свързани статии
Какво са сигурностните отчети?