Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/healeycodes/niceware
:lock: Generate or convert random bytes into passphrases. A Rust port of niceware.
https://github.com/healeycodes/niceware
cryptography diceware generator niceware passphrase password
Last synced: 23 days ago
JSON representation
:lock: Generate or convert random bytes into passphrases. A Rust port of niceware.
- Host: GitHub
- URL: https://github.com/healeycodes/niceware
- Owner: healeycodes
- License: other
- Created: 2021-10-05T13:08:36.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-01-29T22:06:18.000Z (almost 3 years ago)
- Last Synced: 2024-10-06T08:18:52.073Z (about 1 month ago)
- Topics: cryptography, diceware, generator, niceware, passphrase, password
- Language: Rust
- Homepage: https://healeycodes.com/porting-niceware-to-rust
- Size: 528 KB
- Stars: 21
- Watchers: 3
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# niceware
[](https://github.com/healeycodes/niceware/actions/workflows/rust.yml) [](https://crates.io/crates/niceware)
> My blog post: [Porting Niceware to Rust](https://healeycodes.com/porting-niceware-to-rust)
_A Rust port of [niceware](https://github.com/diracdeltas/niceware). Sections of this README have been copied from the original project._
This library generates random-yet-memorable passwords. Each word provides 16 bits of entropy, so a useful password requires at least 3 words.
The transformation from bytes to passphrase is reversible.
Because the wordlist is of exactly size 2^16, niceware is also useful for convert cryptographic keys and other sequences of random bytes into human-readable phrases. With niceware, a 128-bit key is equivalent to an 8-word phrase.
Similar to the source, heed this warning:
> WARNING: The wordlist has not been rigorously checked for offensive words. Use at your own risk.
## Sample use cases
- niceware can be used to generate secure, semi-memorable, easy-to-type passphrases. A random 3-5 word phrase in niceware is equivalent to a strong password for authentication to most online services. For instance, `+8svofk0Y1o=` and `bacca cavort west volley` are equally strong (64 bits of randomness).
- niceware can be used to display cryptographic key material in a way that users can easily backup or copy between devices. For instance, the 128-bit random seed used to generate a 256-bit ECC key (~equivalent to a 3072-bit RSA key) is only 8 niceware words. With this 8-word phrase, you can reconstruct the entire public/private key pair.
## Tests
```bash
cargo test
```
## Credits
Rust port:
[@Kixunil](https://github.com/Kixunil) made some fantastic changes w/r/t idiomatic and performant Rust in [#2](https://github.com/healeycodes/niceware/pull/2).
Code, tests, and docs are either straight-up ported/copied from, or inspired by [niceware](https://github.com/diracdeltas/niceware).
Original:
Niceware was inspired by [Diceware](http://world.std.com/~reinhold/diceware.html). Its wordlist is derived from [the SIL English word list](https://web.archive.org/web/20180803153208/http://www-01.sil.org/linguistics/wordlists/english/). This project is based on [diracdeltas] work on OpenPGP key backup for the Yahoo [End-to-End](https://github.com/yahoo/end-to-end) project.