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.3.tar.gz (9.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.3-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: provenance_gate_signer-0.1.3.tar.gz
  • Upload date:
  • Size: 9.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.3.tar.gz
Algorithm Hash digest
SHA256 8e94b5bd7f831f0c79b0ecde3a748749aaa2b3f60457c8fb5082a6bffb5a9832
MD5 742afc7bc4c929dc2a7d0f6f47640e83
BLAKE2b-256 82c96ad87ec76aa1efad11e78067b0cf7cf3dca2b7d57fd1a18f0f5a5098600f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for provenance_gate_signer-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c307c17628599d3c046c903ffde4296df427e80bc7db2257e232fd375a803db7
MD5 b13f253f623bc12ea0ffb7da7a080f1d
BLAKE2b-256 bbf11d1ae5ecf6955bd3665d78e8d232477fbb8cad355bee8a149361c2272864

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