Struct BasicAuthentication 

pub struct BasicAuthentication { /* private fields */ }

Basic Authentication backend

Passwords are hashed with Argon2id before storage. Verification uses the constant-time comparison built into Argon2.

Implementations

impl BasicAuthentication

pub fn new() -> Self

Creates a new BasicAuthentication backend with no users.

Examples

use reinhardt_auth::{HttpBasicAuth, AuthenticationBackend};
use bytes::Bytes;
use hyper::{HeaderMap, Method, Uri, Version};
use reinhardt_http::Request;

let auth = HttpBasicAuth::new();

let request = Request::builder()
    .method(Method::GET)
    .uri("/")
    .body(Bytes::new())
    .build()
    .unwrap();

let result = auth.authenticate(&request).await.unwrap();
assert!(result.is_none());

pub fn add_user( &mut self, username: impl Into<String>, password: impl Into<String>, )

Adds a user with the given username and password.

The password is hashed with Argon2id before storage.

Panics

Panics if password hashing fails (should not happen in practice).

Examples

use reinhardt_auth::{HttpBasicAuth, AuthenticationBackend};
use bytes::Bytes;
use hyper::{HeaderMap, Method, Uri, Version};
use reinhardt_http::Request;

let mut auth = HttpBasicAuth::new();
auth.add_user("alice", "secret123");
auth.add_user("bob", "password456");

// Create a request with valid Basic auth credentials
// "alice:secret123" in base64 is "YWxpY2U6c2VjcmV0MTIz"
let mut headers = HeaderMap::new();
headers.insert("Authorization", "Basic YWxpY2U6c2VjcmV0MTIz".parse().unwrap());
let request = Request::builder()
    .method(Method::GET)
    .uri("/")
    .headers(headers)
    .body(Bytes::new())
    .build()
    .unwrap();

// Authentication should succeed
let result = auth.authenticate(&request).await.unwrap();
assert!(result.is_some());
assert_eq!(result.unwrap().get_username(), "alice");

Trait Implementations

impl AuthenticationBackend for BasicAuthentication

fn authenticate<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 Request, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn User>>, AuthenticationError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Authenticate a request and return a user if successful

fn get_user<'life0, 'life1, 'async_trait>( &'life0 self, user_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn User>>, AuthenticationError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a user by their ID

impl Default for BasicAuthentication

fn default() -> Self

Returns the “default value” for a type.

impl RestAuthentication for BasicAuthentication

fn authenticate<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 Request, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn User>>, AuthenticationError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Authenticate a request and return a user if successful