Ingest- en gate-API
Koppel iedere generator of orchestrator via het stabiele HTTP-contract.
Wat je nodig hebt
- HTTPS endpoint
- Workspacegebonden ingest-token
- CycloneDX JSON 1.4 of hoger
-
1
Authenticatie
Stuur het token in X-Inventory-Token. Tokens horen bij één workspace, zijn intrekbaar en mogen nooit in URL, SBOM of logs staan.
-
2
SBOM-ingest
POST /api/inventory/sbom accepteert CycloneDX JSON. Asset-, environment- en hostnameheaders zijn verplicht; buildheaders zijn optioneel maar aanbevolen.
POST /api/inventory/sbom → 200 {"components": 137, "dependencies": 231, "cryptographicAssets": 0, "documentSha256": "<sha256>"} -
3
Release gate
GET /api/inventory/gate?assetName=...&snapshotToken=... retourneert 200 als het actuele bewijs compleet is en beleid doorzetten toestaat. Een scan die nog niet klaar is geeft 503 met Retry-After. Beleidsblokkades of gewijzigde/onbruikbare inventaris geven 409; een onbekend of niet bij deze asset horend token geeft 404. Bij waarschuwingsbeleid staan beperkingen expliciet in evidenceWarnings.
GET /api/inventory/gate?assetName=checkout-api&snapshotToken=<uuid> → 200, 409, 503 of 404
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.