1. 程式人生 > >SpringBoot配置Cors解決跨域請求問題

SpringBoot配置Cors解決跨域請求問題

con w3c -h 兩個 cat set 通信 turn flat

一、同源策略簡介

同源策略[same origin policy]是瀏覽器的一個安全功能,不同源的客戶端腳本在沒有明確授權的情況下,不能讀寫對方資源。 同源策略是瀏覽器安全的基石。

什麽是源

[origin]就是協議、域名和端口號。例如:http://www.baidu.com:80 這個URL。

什麽是同源

若地址裏面的協議、域名和端口號均相同則屬於同源。

是否是同源的判斷

例如判斷下面的URL是否與 http://www.a.com/test/index.html 同源

  • http://www.a.com/dir/page.html 同源
  • http://www.child.a.com/test/index.html 不同源,域名不相同
  • https://www.a.com/test/index.html 不同源,協議不相同
  • http://www.a.com:8080/test/index.html 不同源,端口號不相同

哪些操作不受同源策略限制

  1. 頁面中的鏈接,重定向以及表單提交是不會受到同源策略限制的;
  2. 跨域資源的引入是可以的。但是JS不能讀寫加載的內容。如嵌入到頁面中的<script src="..."></script><img><link><iframe>等。

跨域

受前面所講的瀏覽器同源策略的影響,不是同源的腳本不能操作其他源下面的對象。想要操作另一個源下的對象就需要跨域。 在同源策略的限制下,非同源

的網站之間不能發送 AJAX 請求。

如何跨域

  • 降域

    可以通過設置 document.damain=‘a.com‘,瀏覽器就會認為它們都是同一個源。想要實現以上任意兩個頁面之間的通信,兩個頁面必須都設置documen.damain=‘a.com‘

  • JSONP跨域

  • CORS 跨域

二、CORS 簡介

為了解決瀏覽器同源問題,W3C 提出了跨源資源共享,即 CORS(Cross-Origin Resource Sharing)。

CORS 做到了如下兩點:

  • 不破壞即有規則
  • 服務器實現了 CORS 接口,就可以跨源通信

基於這兩點,CORS

將請求分為兩類:簡單請求和非簡單請求。

1、簡單請求

CORS出現前,發送HTTP請求時在頭信息中不能包含任何自定義字段,且 HTTP 頭信息不超過以下幾個字段:

  • Accept
  • Accept-Language
  • Content-Language
  • Last-Event-ID
  • Content-Type 只限於 [application/x-www-form-urlencodedmultipart/form-datatext/plain ] 類型

一個簡單的請求例子:

GET /test HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate, sdch, br
Origin: http://www.examples.com
Host: www.examples.com

對於簡單請求,CORS的策略是請求時在請求頭中增加一個Origin字段,服務器收到請求後,根據該字段判斷是否允許該請求訪問。

  1. 如果允許,則在 HTTP 頭信息中添加 Access-Control-Allow-Origin 字段,並返回正確的結果 ;
  2. 如果不 允許,則不在 HTTP 頭信息中添加 Access-Control-Allow-Origin 字段 。

除了上面提到的 Access-Control-Allow-Origin ,還有幾個字段用於描述 CORS 返回結果 :

  1. Access-Control-Allow-Credentials: 可選,用戶是否可以發送、處理 cookie
  2. Access-Control-Expose-Headers:可選,可以讓用戶拿到的字段。有幾個字段無論設置與否都可以拿到的,包括:Cache-ControlContent-LanguageContent-TypeExpiresLast-ModifiedPragma

2、非簡單請求

對於非簡單請求的跨源請求,瀏覽器會在真實請求發出前,增加一次OPTION請求,稱為預檢請求(preflight request)。預檢請求將真實請求的信息,包括請求方法、自定義頭字段、源信息添加到 HTTP 頭信息字段中,詢問服務器是否允許這樣的操作。

例如一個DELETE請求:

OPTIONS /test HTTP/1.1
Origin: http://www.examples.com
Access-Control-Request-Method: DELETE
Access-Control-Request-Headers: X-Custom-Header
Host: www.examples.com

CORS 相關的字段有:

  1. 請求使用的 HTTP 方法 Access-Control-Request-Method
  2. 請求中包含的自定義頭字段 Access-Control-Request-Headers

服務器收到請求時,需要分別對 OriginAccess-Control-Request-MethodAccess-Control-Request-Headers 進行驗證,驗證通過後,會在返回 HTTP頭信息中添加 :

Access-Control-Allow-Origin: http://www.examples.com
Access-Control-Allow-Methods: GET, POST, PUT, DELETE
Access-Control-Allow-Headers: X-Custom-Header
Access-Control-Allow-Credentials: true
Access-Control-Max-Age: 1728000

他們的含義分別是:

  • Access-Control-Allow-Methods: 真實請求允許的方法
  • Access-Control-Allow-Headers: 服務器允許使用的字段
  • Access-Control-Allow-Credentials: 是否允許用戶發送、處理 cookie
  • Access-Control-Max-Age: 預檢請求的有效期,單位為秒。有效期內,不會重復發送預檢請求

當預檢請求通過後,瀏覽器會發送真實請求到服務器。這就實現了跨源請求。

三、Spring Boot 配置 CORS

1、使用@CrossOrigin 註解實現

#如果想要對某一接口配置 CORS,可以在方法上添加 @CrossOrigin 註解 :

@CrossOrigin(origins = {"http://localhost:9000", "null"})
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String greetings() {
    return "{\"project\":\"just a test\"}";
}

#如果想對一系列接口添加 CORS 配置,可以在類上添加註解,對該類聲明所有接口都有效:

@CrossOrigin(origins = {"http://localhost:9000", "null"})
@RestController
@SpringBootApplication
public class SpringBootCorsTestApplication {
    
}

#如果想添加全局配置,則需要添加一個配置類 :

@Configuration
public class WebMvcConfig extends WebMvcConfigurerAdapter {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("POST", "GET", "PUT", "OPTIONS", "DELETE")
                .maxAge(3600)
                .allowCredentials(true);
    }
}

另外,還可以通過添加 Filter 的方式,配置 CORS 規則,並手動指定對哪些接口有效。

@Bean
public FilterRegistrationBean corsFilter() {
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(true);   config.addAllowedOrigin("http://localhost:9000");
    config.addAllowedOrigin("null");
    config.addAllowedHeader("*");
    config.addAllowedMethod("*");
    source.registerCorsConfiguration("/**", config); // CORS 配置對所有接口都有效
    FilterRegistrationBean bean = newFilterRegistrationBean(new CorsFilter(source));
    bean.setOrder(0);
    return bean;
}

2、原理剖析

無論是通過哪種方式配置 CORS,其實都是在構造 CorsConfiguration。 一個 CORS 配置用一個 CorsConfiguration類來表示,它的定義如下:

public class CorsConfiguration {
    private List<String> allowedOrigins;
    private List<String> allowedMethods;
    private List<String> allowedHeaders;
    private List<String> exposedHeaders;
    private Boolean allowCredentials;
    private Long maxAge;
}

Spring 中對 CORS 規則的校驗,都是通過委托給 DefaultCorsProcessor實現的。

DefaultCorsProcessor 處理過程如下:

  1. 判斷依據是 Header中是否包含 Origin。如果包含則說明為 CORS請求,轉到 2;否則,說明不是 CORS 請求,不作任何處理。
  2. 判斷 responseHeader 是否已經包含 Access-Control-Allow-Origin,如果包含,證明已經被處理過了, 轉到 3,否則不再處理。
  3. 判斷是否同源,如果是則轉交給負責該請求的類處理
  4. 是否配置了 CORS 規則,如果沒有配置,且是預檢請求,則拒絕該請求,如果沒有配置,且不是預檢請求,則交給負責該請求的類處理。如果配置了,則對該請求進行校驗。

校驗就是根據 CorsConfiguration 這個類的配置進行判斷:

  1. 判斷 origin 是否合法
  2. 判斷 method 是否合法
  3. 判斷 header是否合法
  4. 如果全部合法,則在 response header中添加響應的字段,並交給負責該請求的類處理,如果不合法,則拒絕該請求。

摘自:https://www.cnblogs.com/yuansc/p/9076604.html

SpringBoot配置Cors解決跨域請求問題