Home

Awesome

[!WARNING] Bank-Vaults has been migrated to a new organization: https://github.com/bank-vaults

See this post for changes and migration steps.

This project does not receive any more updates. We encourage you to upgrade.

<p align="center"><img src="docs/images/logo/bank-vaults-logo-vertical.svg" width="270"></p> <p align="center"> <a href="https://hub.docker.com/r/banzaicloud/bank-vaults/"> <img src="https://img.shields.io/docker/automated/banzaicloud/bank-vaults.svg" alt="Docker Automated build"> </a> <a href="https://hub.docker.com/r/banzaicloud/bank-vaults/"> <img src="https://img.shields.io/docker/pulls/banzaicloud/bank-vaults.svg?style=shield" alt="Docker Pulls"> </a> <a href="https://godoc.org/github.com/banzaicloud/bank-vaults"> <img src="https://godoc.org/github.com/banzaicloud/bank-vaults?status.svg" alt="GoDoc"> </a> <a href="https://circleci.com/gh/banzaicloud/bank-vaults"> <img src="https://circleci.com/gh/banzaicloud/bank-vaults.svg?style=shield" alt="CircleCI"> </a> <a href="https://goreportcard.com/badge/github.com/banzaicloud/bank-vaults"> <img src="https://goreportcard.com/badge/github.com/banzaicloud/bank-vaults" alt="Go Report Card"> </a> <a href="https://gitpod.io/#https://github.com/banzaicloud/bank-vaults"> <img src="https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod" alt="Gitpod Ready-to-Code"> </a> <a href="https://lgtm.com/projects/g/banzaicloud/bank-vaults/alerts/"> <img alt="Total alerts" src="https://img.shields.io/lgtm/alerts/g/banzaicloud/bank-vaults.svg?logo=lgtm&logoWidth=18"/> </a> </p>

Bank Vaults is a thick, tricky, shifty right with a fast and intense tube for experienced surfers only, located on Mentawai. Think heavy steel doors, secret unlocking combinations and burly guards with smack-down attitude. Watch out for clean-up sets.

Bank-Vaults is an umbrella project which provides various tools for Vault to make using and operating Hashicorp Vault easier. It's a wrapper for the official Vault client with automatic token renewal and built-in Kubernetes support, dynamic database credential provider for Golang database/sql based clients. It has a CLI tool to automatically initialize, unseal, and configure Vault. It also provides a Kubernetes operator for provisioning, and a mutating webhook for injecting secrets.


Bank-Vaults is a core building block of the Banzai Cloud Pipeline platform. Some of the usage patterns are highlighted through these blog posts:

Securing Kubernetes deployments with Vault:

We use Vault across our large Kubernetes deployments and all the projects were reinventing the wheel. We have externalized all the codebase into this project and removed all the Pipeline and Hollowtrees dependencies thus this project can be used independently as a CLI tool to manage Vault, a Golang library to build upon (OAuth2 tokens, K8s auth, Vault operator, dynamic secrets, cloud credential storage, etc), Helm chart for a HA cluster, operator, mutating webhook and a collection of scripts to support some advanced features (dynamic SSH, etc).

We take bank-vaults' security and our users' trust very seriously. If you believe you have found a security issue in bank-vaults, please contact us at security@banzaicloud.com.

Bank-Vaults is a core part of Banzai Cloud Pipeline, a Cloud Native application and devops platform that natively supports multi- and hybrid-cloud deployments.

Supported Kubernetes and Vault versions

This project aims to support the latest supported Vault image versions, and three Kubernetes minor versions excluding the latest one.

Installing

You usually don't need to use the CLI directly, rather you should install the charts and create Vault instances with the operator and use the webhook inside Kubernetes to mutate Kubernetes resources.

To grab the bank-vaults and vault-env CLI binaries go to the releases page and download them.

Documentation

Read more about the usage of bank-vaults in the detailed Bank-Vaults documentation and in our blog posts about Bank-Vaults.

Development

If you want to hack with bank-vaults please follow the development documentation.

Bank-Vaults Support

If you encounter any problems that is not addressed in our documentation, open an issue or talk to us on the Banzai Cloud Slack channel #Bank-Vaults.

If you find this project useful, help us:

Engineering Blog

To be up-to-date with Bank-Vaults and the other open source and commercial products of Banzai Cloud, read our blog.

Credits

Kudos to HashiCorp for open sourcing Vault and making secret management easier and more secure.

License

Copyright (c) 2017-2021 Banzai Cloud, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.