docs: add CipherStash vs HashiCorp Vault comparison#34
Closed
coderdan wants to merge 2 commits into
Closed
Conversation
Adds a Transit-scoped comparison built around the trilemma: no single Vault Transit configuration delivers plaintext-stays-client-side + per-record keys + bulk amortization at once, while ZeroKMS does. Covers Transit's direct vs envelope (datakey) modes, the scattered-read reuse collapse (explained inline), and the trust/capability differences. Performance section is qualitative pending the in-region vault-transit benchmark. Claude-Session: https://claude.ai/code/session_018ag38k33yzmVZhLkVx7CPQ
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Vault's transit/decrypt is batched, so a scattered read unwraps all distinct data keys in one round-trip — it does NOT collapse the way AWS KMS does. The real cost of per-record keys in Vault envelope mode lands on WRITES (datakey has no batch API = one round-trip per record), and the cost of reuse is the security model (shared key, lost per-record audit/revocation). Retitle 'Why the reuse row collapses' -> 'Reading the table' and rewrite accordingly; fix the plaintext and performance notes to match. Claude-Session: https://claude.ai/code/session_018ag38k33yzmVZhLkVx7CPQ
2 tasks
Contributor
Author
|
Superseded by #43, which ports the HashiCorp Vault comparison into the new docs-V2 |
coderdan
added a commit
that referenced
this pull request
Jul 6, 2026
Ports the comparison content from PR #31 (AWS KMS merge + ZeroKMS vs HSM) and PR #34 (HashiCorp Vault) out of the legacy content/stack tree and into the new IA `/compare` section: - content/docs/compare/aws-kms.mdx (from #31) - content/docs/compare/zerokms-vs-hsm.mdx (from #31; retains its WIP TODOs) - content/docs/compare/hashicorp-vault.mdx (from #34) - public/images/hsm.png (from #31) Each page gains v2 facets (type: concept, components, audience, reviewBy — the claims-page review date rather than verifiedAgainst). Intra-comparison links are rewritten to `/compare/*`; all other cross-links keep pointing at the still-served legacy `/stack/...` pages (which hold the real content until their sections migrate). The dead `/stack/cipherstash/secrets` link on the Vault page (no secrets page exists in this repo) is delinked. The comparisons overview and nav (index.mdx, meta.json) list the three ported pages. The FHE comparison stays in the legacy tree for now — it is written against EQL v2 (eql_v2_encrypted, BLAKE3) and needs a v3 content refresh before porting, tracked separately in IA.md (/compare/fhe port). Supersedes #31 and #34 for the v2 branch. Claude-Session: https://claude.ai/code/session_01CqDNqLSEEkCi7xAJFq7HJA
coderdan
added a commit
that referenced
this pull request
Jul 8, 2026
Ports the comparison content from PR #31 (AWS KMS merge + ZeroKMS vs HSM) and PR #34 (HashiCorp Vault) out of the legacy content/stack tree and into the new IA `/compare` section: - content/docs/compare/aws-kms.mdx (from #31) - content/docs/compare/zerokms-vs-hsm.mdx (from #31; retains its WIP TODOs) - content/docs/compare/hashicorp-vault.mdx (from #34) - public/images/hsm.png (from #31) Each page gains v2 facets (type: concept, components, audience, reviewBy — the claims-page review date rather than verifiedAgainst). Intra-comparison links are rewritten to `/compare/*`; all other cross-links keep pointing at the still-served legacy `/stack/...` pages (which hold the real content until their sections migrate). The dead `/stack/cipherstash/secrets` link on the Vault page (no secrets page exists in this repo) is delinked. The comparisons overview and nav (index.mdx, meta.json) list the three ported pages. The FHE comparison stays in the legacy tree for now — it is written against EQL v2 (eql_v2_encrypted, BLAKE3) and needs a v3 content refresh before porting, tracked separately in IA.md (/compare/fhe port). Supersedes #31 and #34 for the v2 branch. Claude-Session: https://claude.ai/code/session_01CqDNqLSEEkCi7xAJFq7HJA
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of CIP-3290 (issue stays open until the doc, backend, and in-region run all land)
Adds a new comparison page: CipherStash vs HashiCorp Vault, scoped to Vault's Transit secrets engine (the encryption-as-a-service analog to ZeroKMS).
What it adds
comparisons/hashicorp-vault.mdx— the doc, registered inmeta.jsonand the overviewindex.mdxcards.datakeymode (plaintext client-side, one key per call), and the scattered-read reuse collapse (explained inline, so the page is self-contained).Draft status
TODOmarks where in-region numbers go once thevault-transitbackend lands incipherstash/benches(kms-app).Notes
main; the AWS KMS data-key-caching/cost sections referenced conceptually live in the separate open PR docs: add ZeroKMS vs HSM comparison + merge Cloud KMS into AWS KMS #31, so this page does not depend on that anchor.https://claude.ai/code/session_018ag38k33yzmVZhLkVx7CPQ