Crate libpasta

Pasta - Password Storage

Making passwords painless

This is a library designed to make secure password storage easy.

For a more comprehensive introduction, see the homepage

Examples

The basic functionality for computing password hashes is:

extern crate libpasta;
// We re-export the rpassword crate for CLI password input.
use libpasta::rpassword::*;

fn main() {
    let password = prompt_password_stdout("Please enter your password:").unwrap();
    let password_hash = libpasta::hash_password(password);
    println!("The stored password is: '{}'", password_hash);
}

Supported formats

libpasta attempts to support some legacy formats. For example, the bcrypt format $2y$....

Re-exports

pub use config::Config;

Modules

config	Configuration
errors	libpasta errors.
hashing	Password hashing functionality
key	The key module is for managing key sources.
primitives	Primitive in libpasta refers to the raw hashing algorithms as implemented in many libraries.
rpassword	Re-export rpassword for convenience.
sod	Module to define the Static or Dynamic Sod enum.

Enums

HashUpdate

On migrating a hash with the password entered, we reach three possible states:

Functions

hash_password	Generates a default hash for a given password.
migrate_hash	Migrate the input hash to the current recommended hash.
verify_password	Verifies the provided password matches the inputted hash string.
verify_password_update_hash	Verifies a supplied password against a previously computed password hash, and performs an in-place update of the hash value if the password verifies. Hence this needs to take a mutable String reference.