actix-web-middleware-redirect-scheme

A middleware for actix-web which forwards all http requests to https and vice versa. Based on actix-web-middleware-redirect-https.

Usage HTTP -> HTTPS

```toml

Cargo.toml

[dependencies] actix-web-middleware-redirect-scheme = "2.3" ```

```rust use actixweb::{App, web, HttpResponse}; use actixwebmiddlewareredirect_scheme::RedirectSchemeBuilder;

App::new() .wrap(RedirectSchemeBuilder::new().build()) .route("/", web::get().to(|| HttpResponse::Ok() .content_type("text/plain") .body("Always HTTPS!"))); ```

By default, the middleware uses answer code "301 Moved Permanently", but you can use "307 Temporary Redirect":

```rust use actixweb::{App, web, HttpResponse}; use actixwebmiddlewareredirect_scheme::RedirectSchemeBuilder;

App::new() .wrap(RedirectSchemeBuilder::new().temporary().build()) .route("/", web::get().to(|| HttpResponse::Ok() .content_type("text/plain") .body("Temporary HTTPS!"))); ```

This is equivalent:

ignore RedirectSchemeBuilder::new().temporary() and ignore RedirectSchemeBuilder::new().permanent(false)

By default, the middleware simply replaces the scheme of the URL with https://, but you may need to it to change other parts of the URL. For example, in development if you are not using the default ports (80 and 443) then you will need to specify their replacement, as below:

```rust use actixweb::{App, web, HttpResponse}; use actixwebmiddlewareredirect_scheme::RedirectSchemeBuilder;

App::new() .wrap(RedirectSchemeBuilder::new().replacements(&[(":8080", ":8443")]).build()) .route("/", web::get().to(|| HttpResponse::Ok() .content_type("text/plain") .body("Always HTTPS on non-default ports!"))); ```

Usage HTTPS -> HTTP

```toml

Cargo.toml

[dependencies] actix-web-middleware-redirect-scheme = "2.3" ```

```rust use actixweb::{App, web, HttpResponse}; use actixwebmiddlewareredirect_scheme::RedirectSchemeBuilder;

App::new() .wrap(RedirectSchemeBuilder::new().httpstohttp().build()) .route("/", web::get().to(|| HttpResponse::Ok() .content_type("text/plain") .body("Always HTTP!"))); ```

This is equivalent:

ignore RedirectSchemeBuilder::new().https_to_http() and ignore RedirectSchemeBuilder::new().http_to_https(false)

By default, the middleware simply replaces the scheme of the URL with http://, but you may need to it to change other parts of the URL. For example, in development if you are not using the default ports (80 and 443) then you will need to specify their replacement, as below:

```rust use actixweb::{App, web, HttpResponse}; use actixwebmiddlewareredirect_scheme::RedirectSchemeBuilder;

App::new() .wrap(RedirectSchemeBuilder::new().httpstohttp().replacements(&[(":8443", ":8080")]).build()) .route("/", web::get().to(|| HttpResponse::Ok() .content_type("text/plain") .body("Always HTTP on non-default ports!"))); ```