Lockbox is both an executable binary that can be run, and a library that can be used in Rust programs.
Installing the lockbox executable
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install lock_boxIt will make the lockbox command available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall lock_box uninstalls.
Adding lock_box library as a dependency
Run this command in a terminal, in your project's directory:
cargo add lock_boxTo add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:
lock_box = "0.1.3"The lock_box library will be automatically available globally.
Read the lock_box library documentation
Back to the crate overview .
Readme
Lockbox
Lockbox is a command-line tool for generating and managing passwords. It uses strong encryption algorithms to securely store your passwords, so you can be sure that your data is safe.
Join the Rust Lockbox discord community! Here's the Invite
Project Features
Secure : Lockbox uses the cutting-edge AES-GCM (Advanced Encryption Standard with Galoise Counter Mode) encryption algorithm to ensure that your passwords are always safe and secure. You can rest easy knowing that your data is protected by the best.One Master Key : With Lockbox, you only need to remember one master password. The advanced PBKDF2 (Password-Based Key Derivation Function 2) key derivation function takes care of the rest, allowing you to access all your passwords with ease.Command-Line Power : Lockbox comes with a fully functional command-line interface (CLI) and a Read-Eval-Print Loop (REPL), giving you complete control over your password management through the terminal.Tested and Verified : Lockbox’s codebase is thoroughly tested and verified, with code coverage reports available for all to see. You can trust that Lockbox is reliable and dependable.
Install
cargo install lock_box
Usage
To use Lockbox, first make sure you have Rust installed on your system.
Then, clone this repository with git clone [email protected] :SonuBardai/lockbox.git
You can run it using cargo run
Usage: lockbox < COMMAND >
Commands:
add Add a new password to the password manager
generate Generate a random password.
list List all passwords in the password manager
remove Remove a password from the password manager
show Show a specific password in the password manager
update- master Update the master password
repl Start an interactive REPL session
help Print this message or the help of the given subcommand ( s)
You can directly trigger the lockbox REPL by simply running lockbox
$ lockbox
Welcome to L🦀CKBOX !
Please enter the master password
> >
Enter [ 1 ] add password [ 2 ] generate random password [ 3 ] list passwords [ 4 ] remove password [ 5 ] show password [ 6 ] update master password [ 7 ] exit
> > add
[ 1 ] generate random password [ 2 ] enter your own password [ 3 ] cancel
> > 1
Please enter the service name
> > github
Please enter the username ( Optional)
> > MyAwesomeGithubProfile
Random password generated and copied to clipboard
Password added successfully
Enter [ 1 ] add password [ 2 ] generate random password [ 3 ] list passwords [ 4 ] remove password [ 5 ] show password [ 6 ] update master password [ 7 ] exit
> > show
Please enter the service name
> > github
Please enter the username ( Optional)
> > MyAwesomeGithubProfile
Password: RkZpFSRPHlFHpK7y
Enter [ 1 ] add password [ 2 ] generate random password [ 3 ] list passwords [ 4 ] remove password [ 5 ] show password [ 6 ] update master password [ 7 ] exit
> > exit
How it works
Store
Contributing
Contributions are welcome! If you’d like to contribute, please feel free to open an issue or submit a pull request. Checkout our CONTRIBUTING file for details on how to contribute.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Changelog
You can find the changelog for all lockbox versions here .