Struct JwtAuthMiddleware 

pub struct JwtAuthMiddleware { /* private fields */ }

Available on crate feature middleware-auth-jwt and native only.

JWT authentication middleware for stateless token-based auth.

Extracts Bearer tokens from the Authorization header, verifies them using reinhardt_auth::jwt::JwtAuth, and inserts an AuthState into request extensions.

This middleware uses best-effort authentication: valid tokens produce AuthState::authenticated(), while missing or invalid tokens produce AuthState::anonymous(). Requests are never rejected by this middleware — authorization is delegated to endpoint-level guards (Guard<P>, Public).

This is the JWT counterpart to the session-based AuthenticationMiddleware.

Examples

use std::sync::Arc;
use reinhardt_middleware::JwtAuthMiddleware;
use reinhardt_http::MiddlewareChain;

// Create middleware with a secret key
let middleware = JwtAuthMiddleware::from_secret(b"my-secret-key");

// Build middleware chain
let app = MiddlewareChain::new(handler)
    .with_middleware(Arc::new(middleware));

Using a pre-built JwtAuth instance:

use reinhardt_auth::jwt::JwtAuth;
use reinhardt_middleware::JwtAuthMiddleware;

let jwt_auth = JwtAuth::new(b"my-secret-key");
let middleware = JwtAuthMiddleware::new(jwt_auth);

Implementations

impl JwtAuthMiddleware

pub fn new(jwt_auth: JwtAuth) -> JwtAuthMiddleware

Available on (crate features standard or middleware) and crate feature auth-jwt only.

Creates a new JWT authentication middleware with a pre-built JwtAuth instance.

Use this constructor when you need to share a JwtAuth instance or want to configure custom validation settings.

Arguments

• jwt_auth - A configured JWT authentication handler

Examples

use reinhardt_auth::jwt::JwtAuth;
use reinhardt_middleware::JwtAuthMiddleware;

let jwt_auth = JwtAuth::new(b"my-secret-key");
let middleware = JwtAuthMiddleware::new(jwt_auth);

pub fn from_secret(secret: &[u8]) -> JwtAuthMiddleware

Available on (crate features standard or middleware) and crate feature auth-jwt only.

Creates a new JWT authentication middleware from a secret key.

This is a convenience constructor that creates a JwtAuth instance internally. Secret management (environment variables, config files) is the application’s concern.

Arguments

• secret - The secret key used to verify JWT signatures

Examples

use reinhardt_middleware::JwtAuthMiddleware;

let middleware = JwtAuthMiddleware::from_secret(b"my-secret-key");

Trait Implementations

impl Middleware for JwtAuthMiddleware

fn process<'life0, 'async_trait>( &'life0 self, request: Request, next: Arc<dyn Handler>, ) -> Pin<Box<dyn Future<Output = Result<Response, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, JwtAuthMiddleware: 'async_trait,

Processes a request through this middleware.

fn should_continue(&self, _request: &Request) -> bool

Determines whether this middleware should be executed for the given request.