Documentatie / Starten

Eerste SBOM in vijf minuten

Genereer een CycloneDX-document, stuur het op en controleer de impact.

Wat je nodig hebt

  • Een Watchtower ingest-token
  • Syft, cdxgen of een andere CycloneDX JSON-generator
  • Een herkenbare assetnaam en omgeving
  1. 1

    Maak een CycloneDX SBOM

    Scan de broncode, image of host die je wilt volgen. Watchtower gebruikt Package URLs en versies uit het document als primair bewijs.

    syft dir:. -o cyclonedx-json=sbom.cdx.json
  2. 2

    Publiceer het document

    Gebruik per workspace een apart token en geef altijd asset, omgeving en host mee. Zo blijft ieder finding herleidbaar.

    curl --fail-with-body https://stackportrait.com/api/inventory/sbom \
      -H "X-Inventory-Token: $WATCHTOWER_TOKEN" \
      -H "X-Asset-Name: checkout-api" \
      -H "X-Environment: production" \
      -H "X-Hostname: checkout-01" \
      -H "Content-Type: application/vnd.cyclonedx+json" \
      --data-binary @sbom.cdx.json
  3. 3

    Controleer de bewijsketen

    Open Omgeving → Assets in de applicatie en kies de asset uit je upload. Controleer de laatste ontvangst, het aantal componenten en eventuele ontbrekende productidentiteiten. Ontvangst betekent niet dat alle software van de host is gevonden.

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