Struct AuthHandler 

pub struct AuthHandler { /* private fields */ }

Handles client-facing authentication interception

Implementations

impl AuthHandler

pub fn new( username: Option<String>, password: Option<String>, ) -> Result<Self, ValidationError>

Create a new auth handler with optional credentials

Authentication behavior:

• None, None → Auth disabled (allows all connections)
• Some(user), Some(pass) → Auth enabled with validation
• Some(user), None or None, Some(pass) → Auth disabled (both must be provided)

Errors

Returns Err if either username or password is explicitly provided but empty/whitespace. This prevents misconfiguration where empty credentials would silently disable auth, which is a critical security vulnerability.

Security

If you explicitly set credentials in config and they’re empty, the proxy will refuse to start rather than silently running with no authentication.

pub fn with_users( user_list: Vec<(String, String)>, ) -> Result<Self, ValidationError>

Create a new auth handler with multiple users

Errors

Returns Err if any username or password is empty/whitespace.

pub fn is_enabled(&self) -> bool

Check if authentication is enabled

pub fn validate_credentials(&self, username: &str, password: &str) -> bool

Validate client credentials

If auth is disabled (no users configured), returns true for all credentials

pub async fn handle_auth_command<W>( &self, auth_action: AuthAction<'_>, writer: &mut W, stored_username: Option<&str>, ) -> Result<(usize, bool)>

where W: AsyncWriteExt + Unpin,

Handle an auth command - writes response to client and returns (bytes_written, auth_success) This is the ONE place where auth interception happens.

Errors

Returns any I/O error from writing the NNTP auth response to the client.

pub const fn user_response(&self) -> &'static [u8]

Get the AUTHINFO USER response

pub const fn pass_response(&self) -> &'static [u8]

Get the AUTHINFO PASS response

Trait Implementations

impl Debug for AuthHandler

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

Formats the value using the given formatter.

impl Default for AuthHandler

fn default() -> AuthHandler

Returns the “default value” for a type.