Struct RemoteUserAuthentication 

pub struct RemoteUserAuthentication { /* private fields */ }

Remote user authentication backend

Authenticates users based on a trusted HTTP header (typically REMOTE_USER) set by an upstream authentication layer.

Security Warning

This backend trusts the specified header completely. Only use this when your application is behind a properly configured authentication proxy that prevents clients from spoofing this header.

Examples

use reinhardt_auth::{AuthenticationBackend, SimpleUser};
use bytes::Bytes;
use hyper::{HeaderMap, Method};
use reinhardt_http::Request;

// Create auth backend
let auth = reinhardt_auth::RemoteUserAuth::new();

// Create request with REMOTE_USER header
let mut headers = HeaderMap::new();
headers.insert("REMOTE_USER", "alice".parse().unwrap());
let request = Request::builder()
    .method(Method::GET)
    .uri("/")
    .headers(headers)
    .body(Bytes::new())
    .build()
    .unwrap();

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

Implementations

impl RemoteUserAuthentication

pub fn new() -> Self

Create a new remote user authentication backend

Examples

use reinhardt_auth::RemoteUserAuth;

let auth = RemoteUserAuth::new();

pub fn with_header(self, header: impl Into<String>) -> Self

Set custom header name

Examples

use reinhardt_auth::RemoteUserAuth;

let auth = RemoteUserAuth::new()
    .with_header("X-Auth-User");

pub fn force_logout(self, force: bool) -> Self

Set whether to force logout when header is missing

Trait Implementations

impl AuthenticationBackend for RemoteUserAuthentication

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 RemoteUserAuthentication

fn default() -> Self

Returns the “default value” for a type.