Struct PasswordPolicy 

pub struct PasswordPolicy { /* private fields */ }

An ordered set of PasswordValidators applied to every password.

PasswordPolicy::default is the default set: min-length 8, common-password denylist, all-numeric reject, and user-attribute similarity. Construct a custom policy with PasswordPolicy::new + PasswordPolicy::with, or start from the defaults and tweak.

Implementations

impl PasswordPolicy

pub fn empty() -> Self

An empty policy — no validators, every password passes. Used as the base for a hand-built policy and as the marker for crate::AuthPlugin::disable_password_validation.

pub fn none() -> Self

Alias for PasswordPolicy::empty, read as “no validation”.

pub fn new(validators: Vec<Box<dyn PasswordValidator>>) -> Self

Start a custom policy from a vector of validators.

pub fn with(self, validator: Box<dyn PasswordValidator>) -> Self

Append a validator, returning self for chaining.

pub fn len(&self) -> usize

The number of validators in the policy. 0 means no enforcement.

pub fn is_empty(&self) -> bool

Whether the policy is empty (no enforcement).

pub fn check( &self, password: &str, ctx: &PasswordContext<'_>, ) -> Result<(), Vec<String>>

Run every validator against password and collect all failure reasons. Returns Ok(()) only when every validator passes.

impl PasswordPolicy

The default policy IS the secure-by-default set: a sensible group of password validators that are enabled out of the box.

pub fn recommended_defaults() -> Self

The four built-in validators with their default settings. This is what an unconfigured AuthPlugin enforces.

Trait Implementations

impl Debug for PasswordPolicy

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

Formats the value using the given formatter.

impl Default for PasswordPolicy

fn default() -> Self

Returns the “default value” for a type.