Module auth 

Authentication module for Ferro framework

Provides Laravel-like authentication with guards and middleware.

Overview

Ferro provides a simple, session-based authentication system:

• Auth facade for login/logout operations
• AuthMiddleware for protecting routes
• GuestMiddleware for guest-only routes
• Authenticatable trait for user models
• UserProvider trait for user retrieval

Example

use ferro_rs::{Auth, AuthMiddleware, GuestMiddleware};

// In a controller
if Auth::check() {
    let user_id = Auth::id().unwrap();
}

// Get the currently authenticated user
if let Some(user) = Auth::user().await? {
    println!("User ID: {}", user.auth_identifier());
}

// Get as concrete User type
if let Some(user) = Auth::user_as::<User>().await? {
    println!("Welcome, user #{}!", user.id);
}

// Login
Auth::login(user.id);

// Logout
Auth::logout();

// In routes
group!("/dashboard")
    .middleware(AuthMiddleware::redirect_to("/login"))
    .routes([...]);

group!("/")
    .middleware(GuestMiddleware::redirect_to("/dashboard"))
    .routes([
        get!("/login", auth::show_login),
    ]);

Re-exports

pub use authenticatable::Authenticatable;

pub use extract::AuthUser;

pub use extract::OptionalUser;

pub use guard::Auth;

pub use middleware::AuthMiddleware;

pub use middleware::GuestMiddleware;

pub use provider::UserProvider;

Modules

authenticatable

Authenticatable trait for models that can be authenticated

extract

Typed extractors for authenticated users

guard

Authentication guard (facade)

middleware

Authentication middleware

provider

User provider trait for retrieving authenticated users from storage