pwhash 0.3.0

A collection of password hashing routines in pure Rust.
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
60
61
62
63
64
65
66
67

# pwhash

[![Build Status](https://travis-ci.org/inejge/pwhash.svg?branch=master)](https://travis-ci.org/inejge/pwhash)

A collection of password hashing and verification routines.

See the [documentation](https://inejge.github.io/pwhash) for API reference.

## Getting Started

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

```toml
pwhash = "0.3"
```

Also, import the crate in your crate root:

```rust
extern crate pwhash;
```

## Example

```rust
extern crate pwhash;

use pwhash::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`.