winpat / vault-client

A command-line interface to HashiCorp's Vault

Vault Client

vc is a command-line interface to HashiCorp's Vault inspired by pass.

• Makes secrets from generic backends easy accessible
• Support for comments through # line prefix
• Features auto completion for bash and zsh

Demo

Installation

1. Download the latest release.
2. Unzip and move vc into a directory of choice.

Build Instructions

To build vault-client you need a Go compiler and Git.

$ apt-get install git go
$ git clone https://github.com/adfinis-sygroup/vault-client.git
$ cd vault-client
$ make build

make build will install Go dependencies and build vault-client. After you should have a binary vc in your working directory.

Configuration

The configuration happens through a simple yaml file.

$ echo "host: HOST (default: 127.0.0.1)
port: PORT (default: 8200)
token: PASSWORD
auth_backend: <ldap|token>
auth_method: <ldap|token>
tls: <true|false>
verify_tls: <true|false>" >  ~/.vaultrc

$ chmod 600 ~/.vaultrc

Development

1. To hack on vault-client you need docker and docker-compose. This allows you to easily spin up a container running the vault server:

$ docker-compose up

2. You also need a minimal .vaultrc that points to vault running inside the docker container:

$ echo "host: 127.0.0.1
port: 8200
tls: false
token: password

$ chmod 600 ~/.vaultrc

3. Finally you want to export the path of your development .vaultrc as an environment variable:

$ cd vault-client
$ export VAULT_CLIENT_CONFIG="${PWD}/.vaultrc"

4. You should now be able to run the test suite:

$ make test

Contributions

Contributions are more than welcome! Please feel free to open new issues or pull requests.

License

Copyright (C) 2017 Adfinis SyGroup AG

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

See the LICENSE file.