Struct DelegatingPasswordEncoder 

pub struct DelegatingPasswordEncoder { /* private fields */ }

Delegating password encoder that supports multiple encoding formats.

Spring Security Equivalent

DelegatingPasswordEncoder

This encoder can verify passwords encoded with different algorithms by detecting the encoding format from a prefix in the stored hash.

Supported formats:

• {argon2}hash - Argon2 encoded password
• {bcrypt}hash - BCrypt encoded password
• {noop}plain - Plain text (for testing only!)

Feature Flag

Requires the argon2 feature (enabled by default).

Example

use actix_security_core::http::security::crypto::{PasswordEncoder, DelegatingPasswordEncoder};

let encoder = DelegatingPasswordEncoder::new();

// Encode with default (argon2)
let hash = encoder.encode("password");
assert!(hash.starts_with("{argon2}"));

// Can verify both formats
assert!(encoder.matches("password", &hash));
assert!(encoder.matches("plain", "{noop}plain"));

Implementations

impl DelegatingPasswordEncoder

pub fn new() -> DelegatingPasswordEncoder

Creates a new delegating password encoder. Default encoding is Argon2.

pub fn default_encoder( self, encoder: DefaultEncoder, ) -> DelegatingPasswordEncoder

Set the default encoder to use for new passwords.

pub fn use_bcrypt(self) -> DelegatingPasswordEncoder

Use BCrypt as the default encoder.

Trait Implementations

impl Clone for DelegatingPasswordEncoder

fn clone(&self) -> DelegatingPasswordEncoder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DelegatingPasswordEncoder

Available on crate feature argon2 only.

fn default() -> DelegatingPasswordEncoder

Returns the “default value” for a type.

impl PasswordEncoder for DelegatingPasswordEncoder

Available on crate feature argon2 only.

fn encode(&self, raw_password: &str) -> String

Encode the raw password.

fn matches(&self, raw_password: &str, encoded_password: &str) -> bool

Verify a raw password against an encoded password.

fn upgrade_encoding(&self, encoded_password: &str) -> bool

Returns true if the encoded password should be upgraded for better security.