Crate sha_crypt

Pure Rust implementation of the SHA-crypt password hash based on SHA-512, a legacy password hashing scheme supported by the POSIX crypt C library.

Password hashes using this algorithm start with $6$ when encoded using the PHC string format.

Usage

use sha_crypt::{Sha512Params, sha512_simple, sha512_check};

// First setup the Sha512Params arguments with:
// rounds = 10_000
let params = Sha512Params::new(10_000).expect("RandomError!");

// Hash the password for storage
let hashed_password = sha512_simple("Not so secure password", &params)
    .expect("Should not fail");

// Verifying a stored password
assert!(sha512_check("Not so secure password", &hashed_password).is_ok());

Structs

Sha256Params

Algorithm parameters.

Sha512Params

Algorithm parameters.

Enums

CryptError

Error type.

Constants

BLOCK_SIZE_SHA256

Block size for SHA256

BLOCK_SIZE_SHA512

Block size for SHA512

ROUNDS_DEFAULT

Default number of rounds.

ROUNDS_MAX

Maximum number of rounds allowed.

ROUNDS_MIN

Minimum number of rounds allowed.

Functions

sha256_checksimple

Checks that given password matches provided hash.

sha256_crypt

The SHA256 crypt function returned as byte vector

sha256_crypt_b64

Same as sha256_crypt except base64 representation will be returned.

sha256_simplesimple

Simple interface for generating a SHA256 password hash.

sha512_checksimple

Checks that given password matches provided hash.

sha512_crypt

The SHA512 crypt function returned as byte vector

sha512_crypt_b64

Same as sha512_crypt except base64 representation will be returned.

sha512_simplesimple

Simple interface for generating a SHA512 password hash.