Files
git.stella-ops.org/docs/modules/excititor/operations/chunk-api-user-guide.md
master 79b8e53441
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Add new features and tests for AirGap and Time modules
- Introduced `SbomService` tasks documentation.
- Updated `StellaOps.sln` to include new projects: `StellaOps.AirGap.Time` and `StellaOps.AirGap.Importer`.
- Added unit tests for `BundleImportPlanner`, `DsseVerifier`, `ImportValidator`, and other components in the `StellaOps.AirGap.Importer.Tests` namespace.
- Implemented `InMemoryBundleRepositories` for testing bundle catalog and item repositories.
- Created `MerkleRootCalculator`, `RootRotationPolicy`, and `TufMetadataValidator` tests.
- Developed `StalenessCalculator` and `TimeAnchorLoader` tests in the `StellaOps.AirGap.Time.Tests` namespace.
- Added `fetch-sbomservice-deps.sh` script for offline dependency fetching.
2025-11-20 23:29:54 +02:00

849 B

Using the Chunk API

Endpoint: POST /vex/evidence/chunks

  • Content-Type: application/x-ndjson
  • See schema: docs/modules/excititor/schemas/vex-chunk-api.yaml

Response: 202 Accepted

{ "chunk_digest": "sha256:…", "queue_id": "uuid" }

Operational notes

  • Deterministic hashing: server recomputes chunk_digest from canonical JSON; mismatches return 400.
  • Limits: default 500 items, max 2000 (aligned with Program.cs guard).
  • Telemetry: metrics under StellaOps.Excititor.Chunks (see chunk-telemetry.md).
  • Headers: correlation/trace headers echoed (X-Stella-TraceId, X-Stella-CorrelationId).

Example curl

curl -X POST https://excitor.local/vex/evidence/chunks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/x-ndjson" \
  --data-binary @docs/samples/excititor/chunk-sample.ndjson