https://github.com/kstenschke/tiny-vault
Tiny Vault - Temporary local password store for Linux
https://github.com/kstenschke/tiny-vault
linux password security tool
Last synced: about 2 months ago
JSON representation
Tiny Vault - Temporary local password store for Linux
- Host: GitHub
- URL: https://github.com/kstenschke/tiny-vault
- Owner: kstenschke
- License: gpl-3.0
- Created: 2021-10-14T09:37:44.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-11-04T11:58:48.000Z (over 4 years ago)
- Last Synced: 2025-05-18T07:40:29.500Z (about 1 year ago)
- Topics: linux, password, security, tool
- Language: C++
- Homepage:
- Size: 3.39 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Tiny Vault
==========
[](#)
[](https://github.com/kstenschke/tiny-vault/blob/master/LICENSE)
[](#)
Temporary local password store for Linux.
## Table of Contents
* [What does it do?](#what-does-it-do)
* [Usage](#usage)
+ [Run and set secret](#run-and-set-secret)
+ [Retrieve secret](#retrieve-secret)
+ [Example usage script](#example-usage-script)
* [Author and License](#author-and-license)
## What does it do?
When starting **Tiny Vault**, the user is asked to enter a secret string,
which is than temporarily (for the runtime of Tiny Vault) stored in the RAM
(and never onto the file system).
**Tiny Vault** than allows to retrieve the secret locally via HTTP request.
## Usage
### Run and set secret
Run on default port 1234: ```tvault```
Run on port 6789: ```tvault 6789```
### Retrieve secret
Retrieve current secret using CURL: ```curl http://localhost:1234```
### Example usage script
```sh
#!/bin/bash
# retrieve secret and store into shell variable
MY_SECRET=$(curl http://localhost:1234)
# type secret string using xdotool
xdotool type $MY_SECRET
# hit enter
xdotool key KP_Enter
# unset variable that held the secret
unset MY_SECRET
```
## Build and install
1. Fetch dependencies: ```git submodule update --init --recursive```
2. Build: ```cmake CMakeLists.txt; make```
3. Install: ```sudo make install```
## Author and License
**Tiny Vault** was written by Kay Stenschke and is licensed under the
[GNU General Public License V3.0](https://www.gnu.org/licenses/licenses.html#GPL)
```
Permissions of this strong copyleft license are conditioned on making available
complete source code of licensed works and modifications, which include larger
works using a licensed work, under the same license. Copyright and license
notices must be preserved. Contributors provide an express grant of patent
rights.
```