Command line password manager in Rust
Rust C
Latest commit d436395 Nov 30, 2015 @miroc Update README.md
Permalink
Failed to load latest commit information.
lib/tweetnacl
src
.gitignore
Cargo.lock Cargo.lock update Nov 30, 2015
Cargo.toml
LICENSE License added Nov 30, 2015
README.md
build.rs bcrypt added Oct 12, 2015

README.md

rustypass

Rustypass is a command line based password manager written in Rust. At this point, it is mainly a prototype done for fun.

Description

  • Rustypass uses NaCl library for its crypto, specifically TweetNacl implementation which is included in the project.
  • The code is small and easily auditable, including all the crypto implementation (not rolling any new crypto here).
  • Database file contains:
    • DB version
    • Salt for Bcrypt
    • NaCl Secretbox structure serialized to bytes, encrypted with password derived from master password using Bcrypt.
  • Secretbox structure uses authenticated encryption (XSalsa20 + Poly1305) and contains database of entries serialized to JSON.
  • Passwords are stored in SecStr structure, which keeps them encrypted in the memory (= obfuscation).

Compilation

First, you need to install Rust with Cargo, see the official page. Nightly build (tested on Nightly 1.6) is required, because Serde JSON serialization library uses some of the nightly features.

To compile and run the project, go to the project directory and run:

cargo build --release
./target/release/rpass

Basic usage

  • rpass create <db_filename> - creates a new database
  • rpass open <db_filename> - opens up an existing database

Once you have your DB opened, you can add, copy or remove entries. To see all the available commands, type help.