Documentatie / Platform

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. 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. 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. 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.

Open Watchtower