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.4.tar.gz (10.4 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.4-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: provenance_gate_signer-0.1.4.tar.gz
  • Upload date:
  • Size: 10.4 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.4.tar.gz
Algorithm Hash digest
SHA256 215fd17838d0034cb3a4b1c2e4c56e352007c0c1e29285e14bafac3c7f74f47a
MD5 d4edc1fe44ee29c3bc8d60ca6795ce7d
BLAKE2b-256 17402a878444c9bd258c2c69280d8bb532d8170e9549e9d62aa5a18016d4f3c4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for provenance_gate_signer-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 b33d8cd90708bdd8b3998f706dff9af8fe45ffd886c94a4fc52c8144520a7098
MD5 409d5a75d291ce1acde33b8cd599a9d4
BLAKE2b-256 c401f8d0fe5386644e97b0d2fad8baaa196cba1a3af3ea82805cf8bb14ed0e43

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