Documentation
Docs
Technical documentation for the Confium engine, its three deployment modes, and the principles that shape every crate.
-
Architecture
Confium's engine, plugin loader, versioned interfaces, coordinator, and the principles that shape every crate.
-
Migrate from HSM-only
You have an HSM today. You want threshold signing without replacing the HSM. This guide walks the migration path — same HSM, same consumers, threshold signing behind it.
-
Migrate from Sigstore
You use Sigstore (cosign + Rekor + Fulcio) for container / artifact signing. Here's what Confium adds, what to keep, and how to run both side-by-side during migration.
-
Three deployment modes
Mode 1 (Peer-to-Peer TC), Mode 2 (PKI Drop-in), Mode 3 (Sovereign PKI). One engine, three integration shapes.
-
Migrate from KMS-only
You use a cloud KMS (AWS KMS, GCP KMS, Azure Key Vault) for signing keys. The KMS holds the key; your app calls the API. Here's how to add threshold control without losing the KMS benefits.
-
Mode 1 — Peer-to-Peer TC
Nodes do threshold cryptography directly. Hours to value. The simplest deployment shape.
-
Mode 2 — PKI Drop-in
Replace single-party keys with threshold keys. Existing PKCS#11 / OpenSSL / JCE consumers keep working unchanged.
-
Four deployment modes
Confium supports four deployment modes — Peer-to-Peer TC, PKI Drop-in, Sovereign PKI, and Keyless Threshold.
-
Mode 3 — Sovereign PKI
Custom certificate formats for institutions where no single party can be trusted. Sovereign over formats, delegation, archival, quorum.
-
Components
The 57-crate Confium Rust workspace, grouped by category. Engine, threshold crypto, PKI, storage, network, Mode 2 adapters, transparency log infrastructure, deployment, benchmarks, Mode 4 keyless, operators, IaC, verification services, fuzzing.
-
Security model
Confium's threat model, trust assumptions, and defense-in-depth layers. What the framework protects against and what it expects of operators.
-
Post-quantum migration
Migrate from classical to post-quantum signatures via composite signatures. Software upgrade, not HSM replacement. No certificate re-issuance flag day.
-
Transparency logs
RFC 6962 Merkle transparency logs. Inclusion proofs, consistency proofs, witness gossip, OTS anchoring. How split-view attacks are detected.
-
Getting started
Quickstart hub for Confium — Ruby, Rust, and WASM install commands and pointers into per-binding docs.
-
Quickstart
Five-minute quickstarts for Confium in every supported language. Pick yours, copy-paste, verify your first signature. No prior threshold-crypto knowledge required.
-
Comparison
Confium vs HSMs, conventional CAs, KMS, Sigstore, and commercial threshold solutions. Where each fits, where each falls short.
-
Compliance
FIPS 140 mode, jurisdictional algorithm policies, audit log format, and regulatory mapping to eIDAS, HIPAA, FedRAMP, and Common Criteria.
-
Confium CLI
The confium command-line tool — install, manage, and operate Confium plugins, signers, and the local configuration store.
-
FAQ
Common questions about Confium — what it is, how it works, when to use it, and the limits of threshold-native trust infrastructure.
-
Mode 4 — Keyless Threshold
Combining Confium threshold signing with Sigstore-style keyless signing. OIDC-verified ephemeral quorums, Fulcio-style short-lived certs, Rekor-style transparency log. No persistent shares, no key management, no share-rotation ops.
-
confium version
Print the version of the confium CLI and the underlying engine.
-
Troubleshooting
Operational gotchas, common errors, and their fixes for Confium deployments and consumers.
-
confium install
Install a Confium plugin from the registry. Currently a stub awaiting the confium-net HTTP-fetching crate.
-
Deployment
Run confiumd in production. Docker Compose for single-host evaluation, Helm chart for Kubernetes, Grafana dashboards for observability.
-
Benchmarks
Criterion benchmarks for the confium hot paths. Composite signature verification, transparency log operations. Run locally or in CI.
-
confium remove
Remove an installed Confium plugin from the local store.
-
confium update
Update an installed plugin to the latest version. Currently a stub awaiting the confium-net HTTP-fetching crate.
-
confium list
List installed Confium plugins, optionally filtered by interface or algorithm.
-
confium info
Show detailed information about an installed Confium plugin.
-
confium search
Search the Confium plugin registry for available plugins.
-
Examples
Copy-paste code samples for the 10 most common Confium tasks. Each is self-contained, runs against a real coordinator, and links to the relevant docs page for the full story.
-
confium trust
Manage the trusted-publisher list — which publishers' plugins the local install will accept.
-
Rust API reference
The Confium Rust API surface — confium-core, confium-composite, confium-transparency, confium-pki, confium-attributes. Types, traits, and entry points for embedded use.
-
confium config
Read and write local Confium configuration.
-
WASM API reference
The @confium/confium-wasm API surface — browser-side verifier for composite signatures, transparency logs, attribute predicates, and PKI. Verifier-only by design: browsers verify, servers sign.
-
confiumd
The confiumd daemon — long-running JSON-RPC service for signing sessions, transparency log interaction, and PKI operations.
-
confium-publish
The plugin author's publishing tool — wraps a plugin artifact, signs the manifest, and prepares it for submission to the Confium registry.
-
Tooling
Binaries and adapter libraries shipped by the Confium workspace — beyond the CLI.
-
confium-pkcs11-server
PKCS#11 v3.0 server — exposes Confium threshold signing to existing PKCS#11 consumers (OpenSSL ENGINE, Java SunPKCS11, nginx).
-
confium-openssl-provider
OpenSSL 3.0 provider — exposes Confium threshold signing to modern OpenSSL consumers (nginx, curl, custom C).
-
confium-jce-provider
Java Cryptography Extension provider — exposes Confium threshold signing to Java applications via KeyStore / Cipher / Signature APIs.
-
confium-tls-signer
TLS 1.3 signature callback — high-value domain protection with threshold signing for handshakes.
-
confium-test-harness
NIST MPTS evaluation harness + multi-party threshold simulation runner.
-
Adapters
Deep dives into the Mode 2 adapters — PKCS#11, OpenSSL 3.0, JCE, TLS 1.3. How they wire existing consumers into Confium.
-
PKCS#11 adapter
PKCS#11 v3.0 adapter — expose Confium as a virtual HSM to OpenSSL, Java, nginx, and custom consumers.
-
OpenSSL 3.0 provider adapter
OpenSSL 3.0 provider — expose Confium to modern OpenSSL consumers in-process.
-
JCE provider adapter
Java Cryptography Extension provider — expose Confium to Java applications via KeyStore / Cipher / Signature APIs.
-
TLS 1.3 signer adapter
TLS 1.3 signature callback — threshold signing for high-value domain TLS handshakes.