Secrets are values stored in a mounted engine. This page covers the common operations that work across KV, database, PKI, and transit.

Reading and writing (KV v2)

vault kv put secret/prod/api-key value=sk_live_...
vault kv get  secret/prod/api-key
vault kv get  secret/prod/api-key -format=json | jq -r .data.value

vault kv list secret/prod
vault kv delete secret/prod/api-key           # soft delete
vault kv metadata delete secret/prod/api-key  # hard delete + all versions
Versions:
vault kv get secret/prod/api-key --version=3
vault kv undelete secret/prod/api-key --versions=3

Dynamic secrets (database)

# One-off short-lived creds
vault read database/creds/prod-postgres
# → {
#     lease_id: "database/creds/prod-postgres/xxx",
#     lease_duration: 3600,
#     data: { username: "v-vault-abc123", password: "..." }
#   }

# Renew the lease
vault lease renew -increment=3600 database/creds/prod-postgres/xxx

# Revoke ahead of expiry
vault lease revoke database/creds/prod-postgres/xxx

Wrapping (single-use hand-off)

# Producer: wrap a KV read into a one-time-use token
WRAP=$(vault kv get -wrap-ttl=60s secret/prod/api-key -format=json | jq -r .wrap_info.token)
echo "$WRAP"

# Consumer: unwrap once
vault unwrap "$WRAP"
If anyone else uses the token first, the unwrap fails and you know the hand-off was compromised.

Engines

Where each secret kind lives.

Sharing

Wrapped hand-offs and cross-workspace grants.