Documentatie / Software aansluiten

CI-opdracht en inventarisbewijs koppelen

Controleer dat een bronopdracht werkelijk de bijbehorende inventaris heeft aangeleverd.

Wat je nodig hebt

  • Workspacebeheer
  • Een eigen ingestcredential per bron
  • Een CI-workflow die de bewijsparameters terugstuurt
  1. 1

    Wanneer gebruik je dit?

    Bij Verzameling → Herstelacties kun je een nieuwe inventarisjob starten. Met exact runbewijs wordt deze opdracht pas bevestigd na controle van de provider-run en het ontvangen SBOM-bestand. Dit bewijst ontvangst van inventaris; het bewijst geen succesvolle uitrol of opgelost risico.

  2. 2

    Richt de workflow eerst in

    Laat Jenkins en GitLab WATCHTOWER_EXECUTION en WATCHTOWER_PROOF als parameters/variabelen accepteren. Azure ontvangt ze als runvariabelen. GitHub gebruikt gelijknamige workflow_dispatch-inputs en run-name: WatchTower ${{ inputs.WATCHTOWER_EXECUTION }}. Log het bewijs-token niet. Gebruik één unieke systeemnaam per bron en omgeving.

  3. 3

    Stuur bewijs mee

    Upload CycloneDX naar /api/inventory/sbom met X-Watchtower-Execution, X-Watchtower-Execution-Proof, X-Watchtower-Run en X-Watchtower-Artifact-Sha256. Gebruik het echte build-/pipeline-/run-ID en de SHA-256 van exact de verzonden bytes. Een andere run of hash wordt geweigerd. Een providerstoring vraagt om opnieuw aanbieden van dezelfde waarneming.

  4. 4

    Activeer en controleer

    Vink bij een nieuwe bronkoppeling Exact CI-runbewijs controleren aan. Start de job vanuit Herstelacties. Na geldige ontvangst zie je de geverifieerde run en de SBOM-hash bij de uitvoering. Bestaande koppelingen blijven compatibel, maar worden niet door een willekeurige latere inventaris als geslaagd gemarkeerd.

Klaar wanneer het bewijs zichtbaar is

Controleer in Watchtower of de bron recent is, het componentaantal logisch is en de releasecontext bij de juiste asset staat. Een geslaagde HTTP-call alleen is niet genoeg.

Open Watchtower