# Crate actix_cors

source ·
Expand description

Cross-Origin Resource Sharing (CORS) controls for Actix Web.

This middleware can be applied to both applications and resources. Once built, a `Cors` builder can be used as an argument for Actix Web’s `App::wrap()`, `Scope::wrap()`, or `Resource::wrap()` methods.

This CORS middleware automatically handles `OPTIONS` preflight requests.

## §Crate Features

- `draft-private-network-access`: ⚠️ Unstable. Adds opt-in support for the Private Network Access spec extensions. This feature is unstable since it will follow breaking changes in the draft spec until it is finalized.

## §Example

    use actix_cors::Cors;
    use actix_web::{get, http, web, App, HttpRequest, HttpResponse, HttpServer};

    #[get("/index.html")]
    async fn index(req: HttpRequest) -> &'static str {
        "<p>Hello World!</p>"
    }

    #[actix_web::main]
    async fn main() -> std::io::Result<()> {
        HttpServer::new(|| {
            let cors = Cors::default()
                .allowed_origin("https://www.rust-lang.org")
                .allowed_origin_fn(|origin, _req_head| {
                    origin.as_bytes().ends_with(b".rust-lang.org")
                })
                .allowed_methods(vec!["GET", "POST"])
                .allowed_headers(vec![http::header::AUTHORIZATION, http::header::ACCEPT])
                .allowed_header(http::header::CONTENT_TYPE)
                .max_age(3600);

            App::new()
                .wrap(cors)
                .service(index)
        })
        .bind(("127.0.0.1", 8080))?
        .run()
        .await;

        Ok(())
    }

## Re-exports§

- `pub use crate::middleware::CorsMiddleware;`

## Structs§

- Cors
  Builder for CORS middleware.

## Enums§

- CorsError
  Errors that can occur when processing CORS guarded requests.