rucksack

A terminal-based password manager, generator, and importer (Firefox, Chrome)

Features

Password generator
Encrypted local storage
Concurrent hashmap for use by daemons
Supports Firefox Sync
List secrets (encrypted and decrypted)
Searching secrets (filtering)
Reports (quality, duplicates, etc.)
Add new records to the DB via CLI subcommand
Local network sync

Usage

Password Generator

Use a UUID:

./bin/rucksack gen --type uuid

New password: 229ef9b4-b95b-4d91-a6ac-f6b7ef1cfc47
Password score: 88.50

Augmented UUID:

./bin/rucksack gen --type uuid++

New password: 4C7360%E-4@60-4?03-b559-491C8A52E750
Password score: 100.00

Random:

./bin/rucksack gen --type random

New password: A&6YU?#xk.?)
Password score: 91.22

Lorem-ipsum inspired:

./bin/rucksack gen --type lipsum

New password: Esse-maius-amicitia,-nihil.-]9^,
Password score: 100.00

Importing and Exporting

Import login data from Firefox Sync:

./bin/rucksack import \
  --type firefox \
  --password abc123 \
  --file ~/Downloads/logins.csv

Logins may be exported to files that can then be used to import into browsers:

./bin/rucksack export \
  --type chrome \
  --password abc123 \
  --file /tmp/exported-logins.csv

For both importing and exporting, there are currently two supported types: firefox and chrome.

List Secrets

Show URL/accounts for all secrets:

./bin/rucksack list

Enter db password:

Show URLs, accounts, passwords, and password scores for all secrets:

./bin/rucksack list --db  --decrypt

Enter db password:

In both cases a password may be passed with the --password flag. By default, the salt is the value of the USER environment variable; it may be overridden with --salt.

Note that without --decrypt, only the user and URL are displayed. With --decrypt, those as well as masked password and password score are displayed. To unmask the password, one must also set --reveal.

The default database location used is ./data/creds.db. To use another location, the --db flag is available.

Search / Filter Secrets

Simple filtering is also possible (done using a flag with the list command, with or without sorting):

./bin/rucksack list \
  --password abc123 \
  --filter exa \
  --sort-by score \
  --decrypt

URL                                      | User / Account                 | Password             | Strength
-----------------------------------------+--------------------------------+----------------------+-----------
https://www.bugworld.com                 | hexapod123                     | **********           | 93
https://accounts.cloud.com               | hexapod@thing.systems          | **********           | 90
https://entymology.slack.com             | 6pod@example.com               | **********           | 86
https://bugs.slack.com                   | Alice "Hexapod" Roberts        | **********           | 85
https://twitter.com                      | TheOtherHexapod                | **********           | 83
https://portal-hexapod.testing.app       | alice@example.com              | **********           | 58
http://localhost:3000                    | alice@example.com              | **********           | 30

7 records (of 7 total)

It is also possible to perform negative filtering using --exclude. Additionally, --include is provided as an alias for --filter.

You may sort on score (strength), user, or url. If not provided, url sorting is used. Also note that order-by is provided as an alias for sort-by.

Grouping Results

By Password

For use in auditing, sites+user combinations that share the same password can be reported:

./bin/rucksack list \
  --group-by password \
  --decrypt

+========================================================================

Password: ********** (Score: 99)
Accounts using: 5
Accounts:

URL                                      | User / Account
-----------------------------------------+-------------------------------
https://smile.amazon.com                 | alice@example.com
https://smile.amazon.com/ap/signin       | alice@example.com
https://www.amazon.com                   | alice@example.com
https://www.amazon.com/ap/signin         | alice@example.com
https://mybank.com                       | alice@example.com

+========================================================================

Password: ********** (Score: 86)
Accounts using: 2
Accounts:

URL                                      | User / Account
-----------------------------------------+-------------------------------
https://blurp.com                        | alice
https://bleep.net                        | alice

2 groups (with 7 records out of 16 total)

By User

You may also group by user name (account name):

./bin/rucksack list \
  --group-by user \
  --decrypt

Here are other cargo projects tagged with "password manager" ...

Projects of particular interest:

kbs2 - A secret manager backed by age
RustCrypto - A Github org collecting a handful of pure-Rust encryption libraries
Firefox Sync

License

Apache License, Version 2.0

rucksack 0.5.1