bcrypter 0.1.0

The bcrypt password hashing function in pure Rust. Supports no_std
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
68
69
70
71




# BCrypter

[![Crates.io](https://img.shields.io/crates/v/rustc-serialize.svg)](https://crates.io/crates/bcrypter) [![Build Status](https://travis-ci.com/MitchellBerry/BCrypter.svg?branch=master)](https://travis-ci.com/MitchellBerry/BCrypter) ![Crates.io](https://img.shields.io/crates/l/rustc-serialize.svg)

A pure rust implementation of the bcrypt hashing function based on the Blowfish cipher. Full API documentation can be found at 

## Installation

Modify your Cargo.toml file:

```toml
[dependencies]
bcrypter = "0.1.0"
```

## Usage

#### Basic hash
```rust
extern crate bcrypter;
use bcrypter::password;

let pw = "hunter2".to_string();
let result = password(pw).hash().unwrap();
let bcrypt_hash_string = result.hash_string;
```

#### Custom cost
```rust
let result = password(pw)
                .cost(6)
                .hash()
                .unwrap();
```

#### Custom salt
```rust
let salt = [0u8; 16];
let result = password(pw)
                .salt(salt)
                .cost(8)
                .hash()
                .unwrap();
```
#### Verify password
```rust
let known_hash = "$2a$04$7eAf8viXin8zazyvaU2HLuZGEbvaHy/lsnlG.HFWkBST5irHhXKJO".to_string();
let correct_password : bool = password(pw)
                                .verify(known_hash)
                                .unwrap()
```

#### Raw digest
```rust
let result = password(pw).hash().unwrap();
let digest_bytes : [u8: 24] = result.digest;
```

#### Notes

* The default cost is 12 

* A random 16 byte array is used when no salt parameter is provided.

* The maximum password input is 72 bytes, anything over that will be truncated rather than raise an error. If you need larger inputs consider hashing it beforehand.