pw_hash 0.1.1

A collection of password hashing routines in pure Rust. Fork of pwhash by inejge.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# pw_hash

A collection of password hashing and verification routines.

This is a fork of the currently unmaintained `pwhash`, with updated dependencies.

See the [documentation](https://docs.rs/pw_hash/) for API reference.

## Getting Started

Add the following to the `[dependencies]` section of your `Cargo.toml`:

```toml
pw_hash = "0.1"
```

## Example

```rust
use pw_hash::bcrypt;

// Hash a password with default parameters.
let h_new = bcrypt::hash("password").unwrap();

// Verify a password against an existing hash.
let h = "$2y$05$bvIG6Nmid91Mu9RcmmWZfO\
         5HJIMCT8riNW0hEp8f6/FuA2/mHZFpe";
assert!(bcrypt::verify("password", h));
```

## Summary

The following algorithms are currently implemented (in alphabetical order):

* bcrypt

* bsdi_crypt

* md5_crypt

* sha1_crypt

* sha256_crypt

* sha512_crypt

* unix_crypt

Each algorithm resides in its eponymous module, and provides the following
interface:

* `verify()`: verify a password against a hash.

* `hash()`: hash a password with default algorithm-spacific parameters.

* `hash_with()`: hash a password with customized parameters.

There is also a convenience module `unix` which provides the functions
`unix::crypt`, a __crypt__(3) work-alike, and `unix::verify`.