Struct PagesAuthenticator 

pub struct PagesAuthenticator<B>
where
    B: SessionBackend,
{ /* private fields */ }

Available on crate feature websockets-pages and non-WebAssembly only.

Authenticator that integrates with reinhardt-pages’ Cookie/session authentication

This authenticator extracts session information from WebSocket handshake cookies and validates them against reinhardt-pages’ session store.

Type Parameters

• B - The session backend type (e.g., InMemorySessionBackend)

Example

use reinhardt_websockets::integration::pages::PagesAuthenticator;
use reinhardt_auth::sessions::InMemorySessionBackend;

let backend = InMemorySessionBackend::new();
let authenticator = PagesAuthenticator::new(backend);

// During WebSocket handshake, extract cookies from HTTP headers
let cookie_header = "sessionid=abc123; csrftoken=xyz789";
let user = authenticator.authenticate_from_cookies(cookie_header).await?;

Implementations

impl<B> PagesAuthenticator<B>

where B: SessionBackend,

pub fn new(session_backend: B) -> PagesAuthenticator<B>

Create a new PagesAuthenticator with the given session backend

Uses default settings:

• Cookie name: “sessionid”
• Timeout: 30 minutes (1800 seconds)

Arguments

• session_backend - The session backend to use for session validation

Example

use reinhardt_websockets::integration::pages::PagesAuthenticator;
use reinhardt_auth::sessions::InMemorySessionBackend;

let backend = InMemorySessionBackend::new();
let authenticator = PagesAuthenticator::new(backend);

pub fn with_cookie_name(self, name: impl Into<String>) -> PagesAuthenticator<B>

Set a custom cookie name for session ID extraction

Arguments

• name - The cookie name to use (e.g., “my_session_id”)

Example

use reinhardt_websockets::integration::pages::PagesAuthenticator;
use reinhardt_auth::sessions::InMemorySessionBackend;

let backend = InMemorySessionBackend::new();
let authenticator = PagesAuthenticator::new(backend)
    .with_cookie_name("my_session_id");

pub fn with_timeout(self, timeout: Option<u64>) -> PagesAuthenticator<B>

Set a custom session timeout

Arguments

• timeout - Timeout in seconds, or None to disable timeout validation

Example

use reinhardt_websockets::integration::pages::PagesAuthenticator;
use reinhardt_auth::sessions::InMemorySessionBackend;

let backend = InMemorySessionBackend::new();
let authenticator = PagesAuthenticator::new(backend)
    .with_timeout(Some(3600)); // 1 hour timeout

pub async fn authenticate_from_cookies( &self, cookies: &str, ) -> Result<Box<dyn AuthUser>, AuthError>

Authenticate a user from Cookie header string

This method extracts the session ID from the Cookie header and validates it against the session store to retrieve user information.

Arguments

• cookies - Cookie header string (e.g., “sessionid=abc123; csrftoken=xyz789”)

Returns

Returns the authenticated user on success, or an error if:

• Session ID is missing or invalid
• Session has expired
• User ID is not found in session

Errors

• AuthError::AuthenticationFailed - Session ID not found in cookies
• AuthError::TokenExpired - Session has timed out
• AuthError::AuthenticationFailed - Session store error or missing user ID

Example

use reinhardt_websockets::integration::pages::PagesAuthenticator;
use reinhardt_auth::sessions::InMemorySessionBackend;

let backend = InMemorySessionBackend::new();
let authenticator = PagesAuthenticator::new(backend);

let cookies = "sessionid=valid_session_id; csrftoken=xyz789";
let user = authenticator.authenticate_from_cookies(cookies).await?;
println!("User {} authenticated", user.username());

Trait Implementations

impl<B> WebSocketAuthenticator for PagesAuthenticator<B>

where B: SessionBackend + 'static,

fn authenticate<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _connection: &'life1 Arc<WebSocketConnection>, credentials: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn AuthUser>, AuthError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, PagesAuthenticator<B>: 'async_trait,

Authenticate a WebSocket connection