https://github.com/falcosuessgott/vkv
vkv enables you to list, compare, move, import, document, backup & encrypt secrets from a HashiCorp Vault KV engine
https://github.com/falcosuessgott/vkv
go hashicorp hashicorp-vault key-value secrets vault vault-api vault-client
Last synced: 6 months ago
JSON representation
vkv enables you to list, compare, move, import, document, backup & encrypt secrets from a HashiCorp Vault KV engine
- Host: GitHub
- URL: https://github.com/falcosuessgott/vkv
- Owner: FalcoSuessgott
- License: mit
- Created: 2021-11-28T13:57:48.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2025-03-28T08:06:15.000Z (6 months ago)
- Last Synced: 2025-03-30T04:09:51.624Z (6 months ago)
- Topics: go, hashicorp, hashicorp-vault, key-value, secrets, vault, vault-api, vault-client
- Language: Go
- Homepage: https://falcosuessgott.github.io/vkv/
- Size: 12.9 MB
- Stars: 93
- Watchers: 2
- Forks: 11
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
vkv
`vkv` is a little CLI tool written in Go, which enables you to list, compare, import, document, backup & encrypt secrets from a [HashiCorp Vault KV engine](https://developer.hashicorp.com/vault/docs/secrets/kv):
**Checkout the [Docs](https://falcosuessgott.github.io/vkv/) to learn more about `vkv`**
## Quickstart
```bash
# Installation. For MacOS: "brew install falcosuessgott/tap/vkv"
version=$(curl https://api.github.com/repos/falcosuessgott/vkv/releases/latest -s | jq .name -r)
curl -OL "https://github.com/FalcoSuessgott/vkv/releases/download/${version}/vkv_$(uname)_$(uname -m).tar.gz"
tar xzf vkv_$(uname)_$(uname -m).tar.gz
chmod u+x vkv
./vkv version
# set required env vars
> export VAULT_ADDR=https://vault-server:8200
> export VAULT_TOKEN=
# verify connection
> vault status
Key Value
--- -----
Seal Type shamir
Initialized true
Sealed false
Total Shares 1
Threshold 1
Version 1.12.1
Build Date 2022-10-27T12:32:05Z
Storage Type inmem
Cluster Name vault-cluster-ffd05212
Cluster ID 42ef92d5-eb21-0cb5-dd0b-804dac04e505
HA Enabled false
# list secrets recursively from a KV engine
> vkv export --path
secret/ [desc=key/value secret storage] [type=kv2] # engine description & type
├── admin [v=1] [key=value] # secret version & metadata, every secret is a hyperlink o Vaults UI
│ └── sub=********
├── demo [v=1]
│ └── foo=***
└── sub
├── demo [v=1]
│ ├── demo=***********
│ ├── password=******
│ └── user=*****
└── sub2
└── demo [v=2] [admin=false key=value]
├── admin=***
├── foo=***
├── password=********
└── user=****
```