Scope#
WS13-005 adds deterministic artifact-manifest integrity controls by:
- signing output packaging manifests with HMAC-SHA256,
- persisting integrity records in output metadata, and
- verifying signatures to detect metadata/manifest tampering.
Research and Existing Implementation Alignment#
Before implementation, existing integrity/signature and manifest patterns were reviewed:
- Output packaging contract and manifest flows:
apps/isis/web/src/pages/output-export-center-utils.tsapps/isis/web/src/pages/OutputsPage.tsx
- Existing signing semantics:
apps/isis/generation-api/src/services/webhook-callback-security.service.ts- versioned signatures and HMAC-SHA256 verification pattern.
- Existing parity operational model:
apps/isis/web/src/pages/OutputsParityPage.tsx
The implementation follows these patterns while using Web Crypto in the web layer for deterministic browser-safe signing and verification.
Deliverables#
- Added shared artifact-integrity utility module:
apps/isis/web/src/security/artifact-integrity-utils.ts- canonical JSON serialization (
json-c14n-v1) for stable signing payloads, - SHA-256 manifest hashing,
- HMAC-SHA256 signature generation with versioned signatures (
v1=<hex>), - verification engine with explicit mismatch diagnostics,
- tamper-evidence record update helper,
- metadata merge/read helpers for
artifactIntegrity.
- canonical JSON serialization (
- Added unit tests for signing and tamper detection:
apps/isis/web/src/security/artifact-integrity-utils.spec.ts- sign + verify happy path,
- tamper detection when manifest changes post-signing,
- merge/read metadata record roundtrip.
- Integrated signed-manifest controls into Outputs page:
apps/isis/web/src/pages/OutputsPage.tsx- added signing controls (key ID + secrets),
- added action to sign export manifest and persist tamper-evident metadata,
- added action to verify manifest integrity and persist verification status,
- added integrity status UI with verification result telemetry.
apps/isis/web/src/pages/OutputsPage.spec.tsx- added flow test to sign and verify artifact integrity metadata persistence.
- Integrated parity action for artifact integrity verification:
apps/isis/web/src/pages/OutputsParityPage.tsx- method coverage expanded with
verifyArtifactManifestIntegrity, - parity action verifies signed manifest metadata with caller-provided secret.
- method coverage expanded with
apps/isis/web/src/pages/OutputsParityPage.spec.tsx- verifies parity execution path for artifact integrity verification.
Verification Commands#
bash
pnpm --filter @isis/web exec vitest run src/security/artifact-integrity-utils.spec.ts src/security/content-governance-policy-utils.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/security/artifact-integrity-utils.spec.ts src/pages/OutputsPage.spec.tsx src/pages/OutputsParityPage.spec.tsx --reporter=dot
pnpm --filter @isis/web run typecheck
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
Verification Notes#
src/security/artifact-integrity-utils.spec.tspasses.- Page-level suites (
OutputsPage.spec.tsx,OutputsParityPage.spec.tsx) remain blocked by the pre-existing@isis/clientpackage-entry resolution baseline issue in this workspace. - Web workspace typecheck remains red due pre-existing unrelated baseline issues
(RunPod fleet nullability, workflow result typing, and cross-package
rootDircompilation scope).