Struct RedirectToWww 

pub struct RedirectToWww { /* private fields */ }

Middleware to redirect traffic to www. if not already there.

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 RedirectToWww::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::RedirectToWww;

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

App::new().wrap(mw)

Implementations

impl RedirectToWww

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 RedirectToWww

fn clone(&self) -> RedirectToWww

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RedirectToWww

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

Formats the value using the given formatter.

impl Default for RedirectToWww

fn default() -> RedirectToWww

Returns the “default value” for a type.

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

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 = RedirectToWwwMiddleware<S>

The TransformService value created by this factory

type InitError = ()

Errors produced while building a transform service.

type Future = Ready<Result<<RedirectToWww as Transform<S, ServiceRequest>>::Transform, <RedirectToWww 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