Eve library

ISIS v2 WS13-005: Signed Artifact Manifesting and Tamper-Evident Output Metadata

Guide

Revision 1

On this page

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.ts
    • apps/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#

  1. 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.
  1. 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.
  1. 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.
  1. 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.
  • 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.ts passes.
  • Page-level suites (OutputsPage.spec.tsx, OutputsParityPage.spec.tsx) remain blocked by the pre-existing @isis/client package-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 rootDir compilation scope).