Skip to main content

Out-of-process Ed25519 signing extension that closes provenance-gate's in-process adversary gap

Project description

provenance-gate-signer

Out-of-process Ed25519 signing extension that closes the in-process adversary gap in provenance-gate without modifying the core package.

The problem it solves

Core provenance-gate signs captured evidence with a process-local HMAC key (see capture.py / SECURITY.md). Any code running inside the same process can read that key and forge T1 evidence. provenance-gate-signer moves signing to a separate privileged process that holds an Ed25519 private key the agent process never sees.

How it works

 agent process                 signing service (separate, privileged)
 --------------                ---------------------------------------
 CaptureClient  --request-->  SigningService
   (pubkey only)  <--signed--   runs cmd, signs with PRIVATE key
                 real output
  • The signing service is the only place the private key exists.
  • The agent can only request capture; it cannot mint a valid signature.
  • Verification uses the service's public key (ServiceVerifier), so verifiers never need the private key.

Usage

# terminal A — run the privileged signing service (key never leaves here)
from provenance_gate_signer import run_service
run_service("/tmp/sign.sock")   # generates + holds Ed25519 key

# terminal B — agent side (public key only)
from provenance_gate_signer import CaptureClient, ServiceVerifier
client = CaptureClient(sock_path="/tmp/sign.sock")
cap = client.capture(["pytest", "-q"])          # runs in the service, signed
assert ServiceVerifier(cap.pubkey).verify(cap)  # True

# drop into core's governance unchanged:
artifact = cap.to_t1_artifact()                 # core EvidenceArtifact(T1)

A compromised agent process holding only the client + public key cannot forge a passing T1 capture: it lacks the private key (see tests/test_signer.py::test_inprocess_adversary_cannot_forge).

Status

v0.1.0 — functional sketch, fully tested. Core provenance-gate is not modified; this is a composable extension.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

provenance_gate_signer-0.1.2.tar.gz (7.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

provenance_gate_signer-0.1.2-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file provenance_gate_signer-0.1.2.tar.gz.

File metadata

  • Download URL: provenance_gate_signer-0.1.2.tar.gz
  • Upload date:
  • Size: 7.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for provenance_gate_signer-0.1.2.tar.gz
Algorithm Hash digest
SHA256 aa08802578bc9d2eed12f9d0d1f2b8be1c2936c733b30378ffe2c68aed4f2ecc
MD5 470a6171f0f1197884407b9b2c9df250
BLAKE2b-256 487ac9f4324613c1161b7007e756c6c8a81399e3037f648687792c4c8c8010ac

See more details on using hashes here.

File details

Details for the file provenance_gate_signer-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for provenance_gate_signer-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b86ea5502dba06f89dccad1980443abcc1af3f5c018c9becf23a205ef1b45a5b
MD5 144057cc42e312559d398a6f066338e4
BLAKE2b-256 291e50fec50f6c0a52c82c0b8da70b84d0f34a6b00b846f284412894c071bb0e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page