Struct RedirectToNonWww 

pub struct RedirectToNonWww { /* private fields */ }

Middleware to redirect traffic away from www. if it’s present.

Security

This middleware constructs absolute redirect URLs from request-derived connection information. If your deployment accepts unvalidated Host or forwarding headers, an attacker can influence the redirect target.

To harden this middleware, configure RedirectToNonWww::allow_hosts. Requests with non-allowlisted hosts receive a 400 Bad Request response instead of a redirect. Without an allowlist, you should validate hosts upstream before requests reach the application.

Examples

use actix_web_lab::middleware::RedirectToNonWww;

let mw = RedirectToNonWww::default();
let mw = RedirectToNonWww::default().allow_hosts(["example.com", "www.example.com"]);

App::new().wrap(mw)

Implementations

impl RedirectToNonWww

pub fn allow_hosts<I, S>(self, hosts: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Restricts redirect behavior to requests whose host matches an allowlist entry.

Requests with non-allowlisted hosts receive a 400 Bad Request response instead of a redirect.

Trait Implementations

impl Clone for RedirectToNonWww

fn clone(&self) -> RedirectToNonWww

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RedirectToNonWww

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RedirectToNonWww

fn default() -> RedirectToNonWww

Returns the “default value” for a type.

impl<S, B> Transform<S, ServiceRequest> for RedirectToNonWww

where S: Service<ServiceRequest, Response = ServiceResponse<B>> + 'static,

type Response = ServiceResponse<EitherBody<B, ()>>

Responses produced by the service.

type Error = <S as Service<ServiceRequest>>::Error

Errors produced by the service.

type Transform = RedirectToNonWwwMiddleware<S>

The TransformService value created by this factory

type InitError = ()

Errors produced while building a transform service.

type Future = Ready<Result<<RedirectToNonWww as Transform<S, ServiceRequest>>::Transform, <RedirectToNonWww as Transform<S, ServiceRequest>>::InitError>>

The future response value.

fn new_transform(&self, service: S) -> Self::Future

Creates and returns a new Transform component, asynchronously