Struct PasswordHasher 

pub struct PasswordHasher { /* private fields */ }

Argon2id password hashing service.

Construct with PasswordConfig (or use Default for OWASP-recommended settings), register with app.service(hasher), and extract in handlers via modo::Service<PasswordHasher>.

Both hash_password and verify_password run on a blocking thread via tokio::task::spawn_blocking to avoid stalling the async runtime.

Implementations

impl PasswordHasher

pub fn new(config: PasswordConfig) -> Result<Self, Error>

Create a new hasher with the given Argon2id parameters.

Returns an error if the parameter values are invalid (e.g., zero memory or parallelism).

pub async fn hash_password(&self, password: &str) -> Result<String, Error>

Hash a password using Argon2id with a random salt.

Returns a PHC-formatted string that embeds the algorithm, parameters, salt, and hash. Each call produces a unique output even for the same input.

Runs on a blocking thread to avoid stalling the Tokio runtime.

pub async fn verify_password( &self, password: &str, hash: &str, ) -> Result<bool, Error>

Verify a password against a PHC-formatted hash string.

Returns Ok(true) on match, Ok(false) on mismatch. Returns Err only for malformed hash strings.

The parameters embedded in the hash are used for verification, not the parameters this hasher was constructed with.

Runs on a blocking thread to avoid stalling the Tokio runtime.

Trait Implementations

impl Clone for PasswordHasher

fn clone(&self) -> PasswordHasher

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PasswordHasher

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PasswordHasher

fn default() -> Self

Returns the “default value” for a type.