https://github.com/nlamirault/alan
Bridge between Vault and password managers
https://github.com/nlamirault/alan
galactus keepassxc vault
Last synced: 11 months ago
JSON representation
Bridge between Vault and password managers
- Host: GitHub
- URL: https://github.com/nlamirault/alan
- Owner: nlamirault
- License: apache-2.0
- Created: 2018-04-17T15:01:22.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-01-14T14:35:44.000Z (over 4 years ago)
- Last Synced: 2025-04-05T13:22:15.080Z (about 1 year ago)
- Topics: galactus, keepassxc, vault
- Language: Go
- Homepage:
- Size: 15 MB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 223
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- License: LICENSE
Awesome Lists containing this project
README
# Alan
[![License Apache 2][badge-license]](LICENSE)
[](https://badge.fury.io/gh/nlamirault%2Falan)
* Master : [](https://gitlab.com/nicolas-lamirault/alan/commits/master)
* Develop : [](https://gitlab.com/nicolas-lamirault/alan/commits/develop)
Alan is a bridge between [Hashicorp Vault](https://www.vaultproject.io/) and some password managers :
* [ ] KeepassXC
* [ ] 1password.com
* [ ] Lastpass
* [ ] Pwsafe
## Installation
You can download the binaries :
* Architecture i386 [ [linux](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_linux_386) / [darwin](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_darwin_386) / [freebsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_freebsd_386) / [netbsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_netbsd_386) / [openbsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_openbsd_386) / [windows](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_windows_386.exe) ]
* Architecture amd64 [ [linux](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_linux_amd64) / [darwin](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_darwin_amd64) / [freebsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_freebsd_amd64) / [netbsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_netbsd_amd64) / [openbsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_openbsd_amd64) / [windows](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_windows_amd64.exe) ]
* Architecture arm [ [linux](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_linux_arm) / [freebsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_freebsd_arm) / [netbsd](https://bintray.com/artifact/download/nlamirault/oss/alan-0.1.0_netbsd_arm) ]
## Usage
* CLI help:
$ alan help
### Local usage
* Start a Vault development server :
$ vault server -dev
* Setup Vault :
$ export VAULT_ADDR="http://localhost:8200"
$ vault auth list
Path Type Description
---- ---- -----------
token/ token token based credentials
$ vault auth enable userpass
Success! Enabled userpass auth method at: userpass/
$ vault auth list
Path Type Description
---- ---- -----------
token/ token token based credentials
userpass/ userpass n/a
$ vault secrets list
Path Type Description
---- ---- -----------
cubbyhole/ cubbyhole per-token private secret storage
identity/ identity identity store
secret/ kv key/value secret storage
sys/ system system endpoints used for control, policy and debugging
$ vault policy write alan-policy -<>> foo https://fake.social
Root
* Import a KeepassXC database into the Vault:
$ alan keepassxc import --database alan.kdbx
Please input your password:
Add secret: Dev/Github
Add secret: Dev/Gitlab
Add secret: Social/Twitter
* Check entries :
$ alan vault list
- Dev/
- Social/
$ alan vault list --path Dev
- Github
- Gitlab
* Retrieve a secret :
$ alan vault get --path Dev/Github
Username: foo
Password: bar
URL: https://github.com
## Development
* Initialize environment
$ make init
* Build tool :
$ make build
* Launch unit tests :
$ make test
## Contributing
See [CONTRIBUTING](CONTRIBUTING.md).
## License
See [LICENSE](LICENSE) for the complete license.
## Changelog
A [changelog](ChangeLog.md) is available
## Contact
Nicolas Lamirault
[badge-license]: https://img.shields.io/badge/license-Apache2-green.svg?style=flat