Crates.io | novault |
lib.rs | novault |
version | 0.4.2 |
source | src |
created_at | 2017-09-12 22:54:01.544627 |
updated_at | 2018-03-25 17:32:37.529131 |
description | vaultless password management cli |
homepage | |
repository | https://github.com/vitiral/novault |
max_upload_size | |
id | 31524 |
size | 188,035 |
Note: as of version 0.4.0 it is not expected that there will be breaking changes to this tool. I am now using novault as my own primary password manager.
NoVault is an ultra simple and secure password manager similar to Master Password but made to be much simpler and more auditable for developer minded people.
As the name implies, NoVault does not require storing your passwords in
any kind of file or database. Instead, you remember a single password,
which is cryptographically hashed with Argon2 and converted to a string
using base64url. You only have to (semi-securely) share a tiny novault.secret
file that gets generated at init time among your devices.
NoVault stores your configuration and sites in a human readable toml file, which you can save on sites like google drive, dropbox or even publicly on GitHub.
Advantages to NoVault over other password managers:
novault.sites
file, you only typically only need to remember the
site name to recover the password.(current) disadvantages:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
The only way to install (currently) is through cargo:
cargo install novault
Initialize your NoVault config file:
$ novault init
This will ask for a master password, choose a good one. It is better to make a long password that you can remember than a short one with lots of symbols. "correct horse battery staple" has high entropy but is pretty easy to remember.
This will create a randomly generated secret file at ~/.local/novault.secret
.
Keep this file relatively secure (see the "What you need to keep/remember"
section below). Whatever you do, DON'T loose this file! The purpose of it
is to make it so that an attacker needs both your master-password AND
this file in order to crack your passwords. If you accidentally copy/paste your
master password into Facebook, then that is bad... but you don't have to completely
freak out. See section "I lost my master password..." below.
Once you have chosen your password, add a site:
$ novault loop
>> set vitiral@gmail.com --notes "open source email"
After you have added your first site, a file will be created at
~/.config/novault.sites
. This does not contain ANY information that could be
used to derive your masterpassword, therefore it is safe to store in a public
place (like GitHub).
For another example, setting the password and 4 digit pin of a bank might be done with:
>> set vitiral@bank
>> set pin.vitiral@bank --pin --fmt '{p:.4}'
The
{...}
syntax is the same as rust/pthon's string fmt syntax.p
is the name of the password and everything after:
tells how to formatp
.:.4
says to use "precision 4" which for strings (whichp
is) means string length of 4. If your site requires special characters you can add them like--fmt '{p:.32}!@#'
. Obviously the characters don't provide extra security... but you are using a 32 digit random hash which is about as secure as anything can ever be.
Now you can get the site's password. NoVault will automatically validate that
your password is the same one you used in novault init
.
$ novault loop
>> get vitiral@gmail.com
# ... Run `echo "ok" >> ~/.confg/novault.lock` through a key binding.
# ... NoVault will control your keyboard to type in your password securely
The sites you have added are stored in ~/.config/novault.sites
by default.
It is recommended that you back up this file and distribute it among your
computers. I prefer to keep it in revision control on a public GitHub
repo.
NEVER forget your password or loose your ~/.local/novault.secret
file.
If you do loose either then your passwords are completely unrecoverable.
Tips:
novault.secret
file on a couple USB sticks. I keep one
on my keychain and one in my office. I also keep it on the sdcard
which stays in my laptop.novault.secret
on other computers you trust.If possible, do NOT share your novault.secret
file on the internet. If you
DO put it online, the less public the better. Email/dropbox/google-drive are
PROBABLY fine, but you never know how secure those sites are.
If you think your secret is compromised, you are probably okay... until you
accidentally leak your master password. That is the purpose of the
novault.secret
file, it protects you from yourself -- and on security matters
you are always your own worst enemy.
Note: changing your secret file is the same as changing your master password, ALL site passwords will change as well.
You need to change it, but you can probably finish your cup of coffee first.
The truth is, as long as attackers don't have BOTH your master password and
your novault.secret
file then there is literally no way on earth they will be
able to do anything. The secret file contains a 256 character randomly
generated ASCII string, which is required in order to be able to generate your
site passwords. This means that as long as your secret file is safe, all the
compute power on earth would require literally a billion years to crack
your site passwords.
If a hacker somehow gets them both, then you are screwed. Probably a good idea to generate a new one of both just in case.
So, you have to change your master password but there is no rush. How do you do it?
Run the following:
novault InSeCuRe --export > ~/backup.txt
This will put all your site passwords in plain text. Obviously you should only do this if you are about to change those passwords.
Move ~/.local/novault.secret
to ~/.local/novault.secret.bk
and re-run
novault init
with your new password. Your ~/.config/novault.sites
can stay
the same.
~/.config/novault.sites
You should go to each site and change the password from what is in backup.txt
to a newly generated password gotten with novault get <site>
.
When you are done, you can delete backup.txt
and novault.secret.bk
or keep
them, it doesn't really matter. I recommend keeping them in case you
accidentally forgot to change the password for a site. Probably don't email
them to your hacker ex-lover though...
The deisgn documents are primarily hosted in design/
. You can view them using
artifact using art serve
. They are also rendered here.
I welcome contributors, especially for security review. However, I will be pretty cautious about accepting large changes or new features as I don't want to compromise the security of the application.
The source code in this repository is Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.