1
- # RustCrypto: password hashes ![ Rust Version ] [ rustc-image ] [ ![ Project Chat] [ chat-image ]] [ chat-link ] [ ![ dependency status] [ deps-image ]] [ deps-link ]
1
+ # RustCrypto: Password Hashes [ ![ Project Chat] [ chat-image ]] [ chat-link ] [ ![ dependency status] [ deps-image ]] [ deps-link ]
2
2
3
- Collection of password hashing algorithms, otherwise known as password-based key
4
- derivation functions, written in pure Rust.
3
+ Collection of password hashing algorithms, otherwise known as password-based key derivation functions, written in pure Rust.
5
4
6
- ## Supported algorithms
5
+ ## Supported Algorithms
7
6
8
- | Name | Crates.io | Documentation | Build |
9
- | -----------| ------------| ---------------| -------|
10
- | [ Argon2] ( https://en.wikipedia.org/wiki/Argon2 ) | [ ![ crates.io] ( https://img.shields.io/crates/v/argon2.svg )] ( https://crates.io/crates/argon2 ) | [ ![ Documentation] ( https://docs.rs/argon2/badge.svg )] ( https://docs.rs/argon2 ) | ![ Build ] ( https://github.com/RustCrypto/password-hashes/workflows/argon2/badge.svg?branch=master&event=push ) |
11
- | [ bcrypt-pbkdf] ( https://flak.tedunangst.com/post/ bcrypt-pbkdf) | [ ![ crates.io] ( https://img.shields.io/crates/v/bcrypt-pbkdf.svg )] ( https://crates.io/crates/bcrypt-pbkdf ) | [ ![ Documentation] ( https://docs.rs/bcrypt-pbkdf/badge.svg )] ( https://docs.rs/bcrypt-pbkdf ) | ![ Build ] ( https://github.com/RustCrypto/password-hashes/workflows/bcrypt-pbkdf/badge.svg?branch=master&event=push ) |
12
- | [ PBKDF2] ( https://en.wikipedia.org/wiki/PBKDF2 ) | [ ![ crates.io] ( https://img.shields.io/crates/v/pbkdf2.svg )] ( https://crates.io/crates/pbkdf2 ) | [ ![ Documentation] ( https://docs.rs/pbkdf2/badge.svg )] ( https://docs.rs/pbkdf2 ) | ![ Build ] ( https://github.com/RustCrypto/password-hashes/workflows/pbkdf2/badge.svg?branch=master&event=push ) |
13
- | [ scrypt] ( https://en.wikipedia.org/wiki/Scrypt ) | [ ![ crates.io] ( https://img.shields.io/crates/v/scrypt.svg )] ( https://crates.io/crates/scrypt ) | [ ![ Documentation] ( https://docs.rs/scrypt/badge.svg )] ( https://docs.rs/scrypt ) | ![ Build ] ( https://github.com/RustCrypto/password-hashes/workflows/scrypt/badge.svg?branch=master&event=push ) |
14
- | [ SHA-crypt] ( https://www.akkadia.org/drepper/SHA -crypt.txt ) | [ ![ crates.io] ( https://img.shields.io/crates/v/sha-crypt.svg )] ( https://crates.io/crates/sha-crypt ) | [ ![ Documentation] ( https://docs.rs/sha-crypt/badge.svg )] ( https://docs.rs/sha-crypt ) | ![ Build ] ( https://github.com/RustCrypto/password-hashes/workflows/sha-crypt/badge.svg?branch=master&event=push ) |
7
+ | Algorithm | Crate | Crates.io | Documentation | MSRV |
8
+ | -----------| -------| : ----------: | : -------------: | : ----: |
9
+ | [ Argon2] | ` argon2 ` | [ ![ crates.io] ( https://img.shields.io/crates/v/argon2.svg )] ( https://crates.io/crates/argon2 ) | [ ![ Documentation] ( https://docs.rs/argon2/badge.svg )] ( https://docs.rs/argon2 ) | ![ MSRV 1.51 ] [ msrv-1.51 ] |
10
+ | [ bcrypt-pbkdf] | ` bcrypt-pbkdf ` | [ ![ crates.io] ( https://img.shields.io/crates/v/bcrypt-pbkdf.svg )] ( https://crates.io/crates/bcrypt-pbkdf ) | [ ![ Documentation] ( https://docs.rs/bcrypt-pbkdf/badge.svg )] ( https://docs.rs/bcrypt-pbkdf ) | ![ MSRV 1.51 ] [ msrv-1.51 ] |
11
+ | [ PBKDF2] | ` pbkdf2 ` | [ ![ crates.io] ( https://img.shields.io/crates/v/pbkdf2.svg )] ( https://crates.io/crates/pbkdf2 ) | [ ![ Documentation] ( https://docs.rs/pbkdf2/badge.svg )] ( https://docs.rs/pbkdf2 ) | ![ MSRV 1.51 ] [ msrv-1.51 ] |
12
+ | [ scrypt] | ` scrypt ` | [ ![ crates.io] ( https://img.shields.io/crates/v/scrypt.svg )] ( https://crates.io/crates/scrypt ) | [ ![ Documentation] ( https://docs.rs/scrypt/badge.svg )] ( https://docs.rs/scrypt ) | ![ MSRV 1.51 ] [ msrv-1.51 ] |
13
+ | [ SHA-crypt] | ` sha -crypt` | [ ![ crates.io] ( https://img.shields.io/crates/v/sha-crypt.svg )] ( https://crates.io/crates/sha-crypt ) | [ ![ Documentation] ( https://docs.rs/sha-crypt/badge.svg )] ( https://docs.rs/sha-crypt ) | ![ MSRV 1.51 ] [ msrv-1.51 ] |
15
14
16
- Please see the [ OWASP Password Storage Cheat Sheet] for assistance in selecting
17
- an appropriate algorithm for your use case.
15
+ Please see the [ OWASP Password Storage Cheat Sheet] for assistance in selecting an appropriate algorithm for your use case.
16
+
17
+ ### Minimum Supported Rust Version (MSRV) Policy
18
+
19
+ MSRV bumps are considered breaking changes and will be performed only with minor version bump.
18
20
19
21
## License
20
22
@@ -27,17 +29,21 @@ at your option.
27
29
28
30
### Contribution
29
31
30
- Unless you explicitly state otherwise, any contribution intentionally submitted
31
- for inclusion in the work by you, as defined in the Apache-2.0 license
32
+ Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
32
33
33
34
[ // ] : # ( badges )
34
35
35
- [ rustc-image ] : https://img.shields.io/badge/rustc-1.41+-blue.svg
36
36
[ chat-image ] : https://img.shields.io/badge/zulip-join_chat-blue.svg
37
37
[ chat-link ] : https://rustcrypto.zulipchat.com/#narrow/stream/260046-password-hashes
38
38
[ deps-image ] : https://deps.rs/repo/github/RustCrypto/password-hashes/status.svg
39
39
[ deps-link ] : https://deps.rs/repo/github/RustCrypto/password-hashes
40
+ [ msrv-1.51 ] : https://img.shields.io/badge/rustc-1.51.0+-blue.svg
40
41
41
42
[ // ] : # ( general links )
42
43
44
+ [ Argon2 ] : https://en.wikipedia.org/wiki/Argon2
45
+ [ bcrypt-pbkdf ] : https://flak.tedunangst.com/post/bcrypt-pbkdf
46
+ [ PBKDF2 ] : https://en.wikipedia.org/wiki/PBKDF2
47
+ [ scrypt ] : https://en.wikipedia.org/wiki/Scrypt
48
+ [ SHA-crypt ] : https://www.akkadia.org/drepper/SHA-crypt.txt
43
49
[ OWASP Password Storage Cheat Sheet ] : https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html
0 commit comments