SonarQube ataskaitų webhookai#

Sužinokite, kaip SonarQube webhookai veikia Procurize AI, įskaitant sąranką, apkrovos struktūrą, saugumo patikrinimą ir pakartojimo elgseną.

Apžvalga#

Procurize webhookai leidžia išorinėms sistemoms gauti pranešimus, kai naujos SonarQube ataskaitos yra įkeliamos arba atnaujinamos.

Webhookų konfigūravimas#

Webhookus galima pridėti arba redaguoti organizacijos nustatymų skydelyje, Saugumo ataskaitų sekcijoje adresu https://dashboard.procurize.ai.
Prašome atkreipti dėmesį, kad prieiga prie nustatymų skydelio reikalauja autorizacijos, o prieiga prie organizacijos nustatymų skydelio reikalauja, kad vartotojas turėtų bent Administrator rolę toje organizacijoje.

Norėdami patikrinti webhookus, galite naudoti populiarias internetines paslaugas, pvz., https://webhook-test.com

Webhookų apkrova#

Webhookų įvykiai pristatomi kaip HTTP POST užklausos su JSON apkrova.

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ų saugumas#

Norint užtikrinti autentiškumą, webhookų užklausos apima parašo antraštę, sugeneruotą naudojant bendrą slaptąjį raktą.

• Parašas apskaičiuojamas naudojant HMAC-SHA256
• Klientai turėtų patikrinti parašą prieš apdorodami apkrovą

Tai apsaugo nuo neautorizuotų arba apgaulingų webhookų pristatymų.

Pristatymas ir pakartojimai#

• Webhookai tikisi 2xx atsakymo, kad būtų laikomi sėkmingai pristatytais
• Nepavykę pristatymai automatiškai pakartojami kas valandą.
• Įvykiai gali būti pristatyti kelis kartus; vartotojai turėtų įgyvendinti idempotentinį apdorojimą

Tipinės naudojimo atvejų#

• Automatiškai įkelti SonarQube radinius į vidinius saugumo prietaisų skydelius
• Pradėti atitikties darbo srautus, kai nesėkminga kokybės varteliai
• Archyvuoti saugumo ataskaitas auditams ir tiekėjų rizikos peržiūrai
• Išlaikyti trečiųjų šalių sistemas sinchronizuotas su naujausia kodo saugumo būkle

Taip pat žiūrėkite:#

• SonarQube Reports API

Susiję straipsniai#

Kas yra saugumo ataskaitos?

Saugumo ataskaitų saugykla

Kaip konfigūruoti saugumo ataskaitas