Struct PasswordHasher 

pub struct PasswordHasher { /* private fields */ }

Password hasher using Argon2id

Provides secure password hashing with configurable parameters. All methods are constant-time to prevent timing attacks.

Implementations

impl PasswordHasher

pub fn new() -> Self

Create a new password hasher with default parameters

Example

use acton_htmx::auth::password::PasswordHasher;

let hasher = PasswordHasher::new();

pub const fn with_config(config: PasswordHashConfig) -> Self

Create a password hasher with custom configuration

Example

use acton_htmx::auth::password::{PasswordHasher, PasswordHashConfig};

let config = PasswordHashConfig {
    memory_cost: 32 * 1024, // 32 MB
    iterations: 3,
    parallelism: 2,
    output_length: 32,
};

let hasher = PasswordHasher::with_config(config);

pub fn builder() -> PasswordHasherBuilder

Create a builder for configuring password hasher parameters

Example

use acton_htmx::auth::password::PasswordHasher;

let hasher = PasswordHasher::builder()
    .memory_cost(32 * 1024)
    .iterations(3)
    .parallelism(2)
    .build()?;

pub fn hash(&self, password: &str) -> Result<String, PasswordError>

Hash a password using Argon2id

Errors

Returns error if:

• Random number generation fails
• Parameters are invalid
• Hashing operation fails

Example

use acton_htmx::auth::password::PasswordHasher;

let hasher = PasswordHasher::new();
let hash = hasher.hash("my-secret-password")?;
println!("Password hash: {}", hash);

pub fn verify(&self, password: &str, hash: &str) -> Result<bool, PasswordError>

Verify a password against a hash

Uses constant-time comparison to prevent timing attacks.

Errors

Returns error if:

• Hash format is invalid
• Verification operation fails

Example

use acton_htmx::auth::password::PasswordHasher;

let hasher = PasswordHasher::new();
let hash = hasher.hash("correct-password")?;

assert!(hasher.verify("correct-password", &hash)?);
assert!(!hasher.verify("wrong-password", &hash)?);

pub const fn config(&self) -> &PasswordHashConfig

Get the current configuration

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 Default for PasswordHasher

fn default() -> PasswordHasher

Returns the “default value” for a type.