Configure Vault transit engine convergent encryption with a derived key and verify deterministic output

domain: vaultproject.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a transit key with convergent encryption and key derivation enabled: 'vault write transit/keys/conv-key type=aes256-gcm96 convergent_encryption=true derived=true'
  2. Generate a unique per-record 96-bit (12-byte) context value encoded as base64 and store it alongside the record
  3. Encrypt the same plaintext twice with the same context: 'vault write transit/encrypt/conv-key plaintext=$(base64 <<< "SSN: 123-45-6789") context=<BASE64_CONTEXT>'
  4. Confirm both encryption calls return identical ciphertext, confirming determinism
  5. Decrypt by supplying the same context: 'vault write transit/decrypt/conv-key ciphertext=<VAULT_CIPHERTEXT> context=<BASE64_CONTEXT>'
  6. Store the context in a separate column or store from the ciphertext to maintain the security property that context + ciphertext are required together

Known gotchas

Related routes

Use the Vault transit engine to re-encrypt (rewrap) ciphertext after a key rotation without decrypting to plaintext
vaultproject.io · 6 steps · unrated
Encrypt and rewrap secrets using HashiCorp Vault Transit secrets engine
developer.hashicorp.com · 6 steps · unrated
Use HashiCorp Vault transit engine to encrypt and decrypt application data without exposing keys
developer.hashicorp.com/vault/docs/secrets/transit · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans