HTTP訪問控制（CORS）

引用自HTTP訪問控制（CORS）

當(dāng) Web 資源請(qǐng)求由其它域名或端口提供的資源時(shí)枯芬，會(huì)發(fā)起跨域 HTTP 請(qǐng)求（cross-origin HTTP request）。比如恨锚，站點(diǎn) http://domain-a.com 的某 HTML 頁面通過 < img> 的 src 請(qǐng)求 http://domain-b.com/image.jpg。網(wǎng)絡(luò)上，很多頁面從其他站點(diǎn)加載各類資源（包括 CSS蟆炊、圖片、JavaScript 腳本）瀑志。

出于安全考慮涩搓，瀏覽器會(huì)限制腳本中發(fā)起的跨域請(qǐng)求。比如后室，使用 XMLHttpRequest 和 Fetch 發(fā)起的 HTTP 請(qǐng)求必須遵循同源策略缩膝。因此，Web 應(yīng)用通過 XMLHttpRequest 對(duì)象或 Fetch 僅能向同域資源發(fā)起 HTTP 請(qǐng)求岸霹。 為提升 Web 應(yīng)用的可用性疾层，瀏覽器必須支持跨域請(qǐng)求。 （譯者注：這段描述跨域不準(zhǔn)確贡避，跨域并非不一定是瀏覽器限制了發(fā)起跨站請(qǐng)求痛黎，而也可能是跨站請(qǐng)求可以正常發(fā)起，但是返回結(jié)果被瀏覽器攔截了刮吧。最好的例子是 CSRF 跨站攻擊原理湖饱，請(qǐng)求是發(fā)送到了后端服務(wù)器無論是否跨域！注意：有些瀏覽器不允許從 HTTPS 的域跨域訪問 HTTP杀捻，比如 Chrome 和 Firefox井厌，這些瀏覽器在請(qǐng)求還未發(fā)出的時(shí)候就會(huì)攔截請(qǐng)求，這是一個(gè)特例致讥。）

CORS_principle.png

跨域資源共享（ CORS ）機(jī)制允許 Web 應(yīng)用服務(wù)器進(jìn)行跨域訪問控制仅仆，從而使跨域數(shù)據(jù)傳輸?shù)靡园踩M(jìn)行。瀏覽器支持在 API 容器中（例如 XMLHttpRequest 或 Fetch ）使用 CORS垢袱，以降低跨域 HTTP 請(qǐng)求所帶來的風(fēng)險(xiǎn)墓拜。

這篇文章適用于網(wǎng)站管理員、后端和前端開發(fā)者请契。CORS 需要客戶端和服務(wù)器同時(shí)支持咳榜。目前，所有瀏覽器都支持該機(jī)制爽锥。 對(duì)于服務(wù)端的支持涌韩，開發(fā)者可以閱讀補(bǔ)充材料 cross-origin sharing from a server perspective (with PHP code snippets) 。

跨域資源共享標(biāo)準(zhǔn)（ cross-origin sharing standard ）允許在下列場(chǎng)景中使用跨域 HTTP 請(qǐng)求：

本文概述了跨域資源共享機(jī)制及其所涉及的 HTTP 首部字段擎淤。

概述

跨域資源共享標(biāo)準(zhǔn)新增了一組 HTTP 首部字段奢啥，允許服務(wù)器聲明哪些源站有權(quán)限訪問哪些資源。另外嘴拢，規(guī)范要求桩盲，對(duì)那些可能對(duì)服務(wù)器數(shù)據(jù)產(chǎn)生副作用的 HTTP 請(qǐng)求方法（特別是 GET 以外的 HTTP 請(qǐng)求，或者搭配某些 MIME 類型的 POST 請(qǐng)求）席吴，瀏覽器必須首先使用 OPTIONS 方法發(fā)起一個(gè)預(yù)檢請(qǐng)求（preflight request）赌结，從而獲知服務(wù)端是否允許該跨域請(qǐng)求。服務(wù)器確認(rèn)允許之后孝冒，才發(fā)起實(shí)際的 HTTP 請(qǐng)求柬姚。在預(yù)檢請(qǐng)求的返回中，服務(wù)器端也可以通知客戶端庄涡，是否需要攜帶身份憑證（包括 Cookies 和 HTTP 認(rèn)證相關(guān)數(shù)據(jù)）量承。

接下來的內(nèi)容將討論相關(guān)場(chǎng)景，并剖析該機(jī)制所涉及的 HTTP 首部字段穴店。

若干訪問控制場(chǎng)景

這里撕捍，我們使用三個(gè)場(chǎng)景來解釋跨域資源共享機(jī)制的工作原理。這些例子都使用 XMLHttpRequest 對(duì)象泣洞。

本文中的 JavaScript 代碼片段都可以從 http://arunranga.com/examples/access-control/ 獲得忧风。另外，使用支持跨域 XMLHttpRequest 的瀏覽器訪問該地址球凰，可以看到代碼的實(shí)際運(yùn)行結(jié)果狮腿。

關(guān)于服務(wù)端對(duì)跨域資源共享的支持的討論，請(qǐng)參見這篇文章： Server-Side_Access_Control (CORS)呕诉。

簡(jiǎn)單請(qǐng)求

某些請(qǐng)求不會(huì)觸發(fā) CORS 預(yù)檢請(qǐng)求蚤霞。本文稱這樣的請(qǐng)求為“簡(jiǎn)單請(qǐng)求”，請(qǐng)注意义钉，該術(shù)語并不屬于 Fetch （其中定義了 CORS）規(guī)范。若請(qǐng)求滿足所有下述條件规肴，則該請(qǐng)求可視為“簡(jiǎn)單請(qǐng)求”：

注意: 這些跨域請(qǐng)求與瀏覽器發(fā)出的其他跨域請(qǐng)求并無二致拖刃。如果服務(wù)器未返回正確的響應(yīng)首部删壮，則請(qǐng)求方不會(huì)收到任何數(shù)據(jù)。因此兑牡，那些不允許跨域請(qǐng)求的網(wǎng)站無需為這一新的 HTTP 訪問控制特性擔(dān)心央碟。

注意: WebKit Nightly 和 Safari Technology Preview 為Accept, Accept-Language, 和 Content-Language 首部字段的值添加了額外的限制。如果這些首部字段的值是“非標(biāo)準(zhǔn)”的均函，WebKit/Safari 就不會(huì)將這些請(qǐng)求視為“簡(jiǎn)單請(qǐng)求”亿虽。WebKit/Safari 并沒有在文檔中列出哪些值是“非標(biāo)準(zhǔn)”的菱涤，不過我們可以在這里找到相關(guān)討論：Require preflight for non-standard CORS-safelisted request headers Accept, Accept-Language, and Content-Language, Allow commas in Accept, Accept-Language, and Content-Language request headers for simple CORS, and Switch to a blacklist model for restricted Accept headers in simple CORS requests。其它瀏覽器并不支持這些額外的限制洛勉，因?yàn)樗鼈儾粚儆谝?guī)范的一部分粘秆。

比如說，假如站點(diǎn) http://foo.example 的網(wǎng)頁應(yīng)用想要訪問 http://bar.other 的資源收毫。http://foo.example 的網(wǎng)頁中可能包含類似于下面的 JavaScript 代碼：

var invocation = new XMLHttpRequest();
var url = 'http://bar.other/resources/public-data/';

function callOtherDomain() {
  if(invocation) {    
     invocation.open('GET', url, true);
     invocation.onreadystatechange = handler;
     invocation.send(); 
  }
}

客戶端和服務(wù)器之間使用 CORS 首部字段來處理跨域權(quán)限：

simple_req.png

分別檢視請(qǐng)求報(bào)文和響應(yīng)報(bào)文：

GET /resources/public-data/ HTTP/1.1
Host: bar.other
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3pre) Gecko/20081130 Minefield/3.1b3pre
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
Referer: http://foo.example/examples/access-control/simpleXSInvocation.html
Origin: http://foo.example


HTTP/1.1 200 OK
Date: Mon, 01 Dec 2008 00:23:53 GMT
Server: Apache/2.0.61 
Access-Control-Allow-Origin: *
Keep-Alive: timeout=2, max=100
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: application/xml

[XML Data]

第 1~10 行是請(qǐng)求首部攻走。第10行 的請(qǐng)求首部字段 Origin 表明該請(qǐng)求來源于 http://foo.exmaple。

第 13~22 行是來自于 http://bar.other 的服務(wù)端響應(yīng)此再。響應(yīng)中攜帶了響應(yīng)首部字段 Access-Control-Allow-Origin（第 16 行）昔搂。使用 Origin 和 Access-Control-Allow-Origin 就能完成最簡(jiǎn)單的訪問控制。本例中输拇，服務(wù)端返回的 Access-Control-Allow-Origin: * 表明摘符，該資源可以被任意外域訪問。如果服務(wù)端僅允許來自 http://foo.example 的訪問淳附，該首部字段的內(nèi)容如下：

Access-Control-Allow-Origin: http://foo.example

現(xiàn)在议慰，除了 http://foo.example，其它外域均不能訪問該資源（該策略由請(qǐng)求首部中的 ORIGIN 字段定義奴曙，見第10行）别凹。Access-Control-Allow-Origin 應(yīng)當(dāng)為 * 或者包含由 Origin 首部字段所指明的域名。

預(yù)檢請(qǐng)求

與前述簡(jiǎn)單請(qǐng)求不同洽糟，“需預(yù)檢的請(qǐng)求”要求必須首先使用 OPTIONS 方法發(fā)起一個(gè)預(yù)檢請(qǐng)求到服務(wù)器炉菲，以獲知服務(wù)器是否允許該實(shí)際請(qǐng)求。"預(yù)檢請(qǐng)求“的使用坤溃，可以避免跨域請(qǐng)求對(duì)服務(wù)器的用戶數(shù)據(jù)產(chǎn)生未預(yù)期的影響拍霜。

當(dāng)請(qǐng)求滿足下述任一條件時(shí)，即應(yīng)首先發(fā)送預(yù)檢請(qǐng)求：

注意: WebKit Nightly 和 Safari Technology Preview 為Accept, Accept-Language, 和 Content-Language 首部字段的值添加了額外的限制祠饺。如果這些首部字段的值是“非標(biāo)準(zhǔn)”的，WebKit/Safari 就不會(huì)將這些請(qǐng)求視為“簡(jiǎn)單請(qǐng)求”汁政。WebKit/Safari 并沒有在文檔中列出哪些值是“非標(biāo)準(zhǔn)”的道偷，不過我們可以在這里找到相關(guān)討論：Require preflight for non-standard CORS-safelisted request headers Accept, Accept-Language,and Content-Language, Allow commas in Accept, Accept-Language, and Content-Language request headers for simple CORS, and Switch to a blacklist model for restricted Accept headers in simple CORS requests。其它瀏覽器并不支持這些額外的限制记劈，因?yàn)樗鼈儾粚儆谝?guī)范的一部分勺鸦。

如下是一個(gè)需要執(zhí)行預(yù)檢請(qǐng)求的 HTTP 請(qǐng)求：

var invocation = new XMLHttpRequest();
var url = 'http://bar.other/resources/post-here/';
var body = '<?xml version="1.0"?><person><name>Arun</name></person>';
    
function callOtherDomain(){
  if(invocation)
    {
      invocation.open('POST', url, true);
      invocation.setRequestHeader('X-PINGOTHER', 'pingpong');
      invocation.setRequestHeader('Content-Type', 'application/xml');
      invocation.onreadystatechange = handler;
      invocation.send(body); 
    }
}

......

上面的代碼使用 POST 請(qǐng)求發(fā)送一個(gè) XML 文檔，該請(qǐng)求包含了一個(gè)自定義的請(qǐng)求首部字段（X-PINGOTHER: pingpong）目木。另外换途，該請(qǐng)求的 Content-Type 為 application/xml。因此，該請(qǐng)求需要首先發(fā)起“預(yù)檢請(qǐng)求”军拟。

prelight.png
OPTIONS /resources/post-here/ HTTP/1.1
Host: bar.other
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3pre) Gecko/20081130 Minefield/3.1b3pre
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
Origin: http://foo.example
Access-Control-Request-Method: POST
Access-Control-Request-Headers: X-PINGOTHER, Content-Type


HTTP/1.1 200 OK
Date: Mon, 01 Dec 2008 01:15:39 GMT
Server: Apache/2.0.61 (Unix)
Access-Control-Allow-Origin: http://foo.example
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-PINGOTHER, Content-Type
Access-Control-Max-Age: 86400
Vary: Accept-Encoding, Origin
Content-Encoding: gzip
Content-Length: 0
Keep-Alive: timeout=2, max=100
Connection: Keep-Alive
Content-Type: text/plain

預(yù)檢請(qǐng)求完成之后剃执，發(fā)送實(shí)際請(qǐng)求：

POST /resources/post-here/ HTTP/1.1
Host: bar.other
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3pre) Gecko/20081130 Minefield/3.1b3pre
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
X-PINGOTHER: pingpong
Content-Type: text/xml; charset=UTF-8
Referer: http://foo.example/examples/preflightInvocation.html
Content-Length: 55
Origin: http://foo.example
Pragma: no-cache
Cache-Control: no-cache

<?xml version="1.0"?><person><name>Arun</name></person>


HTTP/1.1 200 OK
Date: Mon, 01 Dec 2008 01:15:40 GMT
Server: Apache/2.0.61 (Unix)
Access-Control-Allow-Origin: http://foo.example
Vary: Accept-Encoding, Origin
Content-Encoding: gzip
Content-Length: 235
Keep-Alive: timeout=2, max=99
Connection: Keep-Alive
Content-Type: text/plain

[Some GZIP'd payload]

瀏覽器檢測(cè)到，從 JavaScript 中發(fā)起的請(qǐng)求需要被預(yù)檢吻谋。從上面的報(bào)文中忠蝗，我們看到，第 1~12 行發(fā)送了一個(gè)使用 OPTIONS 方法的“預(yù)檢請(qǐng)求”漓拾。 OPTIONS 是 HTTP/1.1 協(xié)議中定義的方法阁最，用以從服務(wù)器獲取更多信息。該方法不會(huì)對(duì)服務(wù)器資源產(chǎn)生影響骇两。 預(yù)檢請(qǐng)求中同時(shí)攜帶了下面兩個(gè)首部字段：

Access-Control-Request-Method: POST
Access-Control-Request-Headers: X-PINGOTHER

首部字段 Access-Control-Request-Method 告知服務(wù)器速种，實(shí)際請(qǐng)求將使用 POST 方法。
首部字段 Access-Control-Request-Headers 告知服務(wù)器低千，實(shí)際請(qǐng)求將攜帶兩個(gè)自定義請(qǐng)求首部字段：X-PINGOTHER 與 Content-Type配阵。服務(wù)器據(jù)此決定，該實(shí)際請(qǐng)求是否被允許示血。

第14~26 行為預(yù)檢請(qǐng)求的響應(yīng)棋傍，表明服務(wù)器將接受后續(xù)的實(shí)際請(qǐng)求。重點(diǎn)看第 17~20 行：

Access-Control-Allow-Origin: http://foo.example
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-PINGOTHER, Content-Type
Access-Control-Max-Age: 86400

首部字段 Access-Control-Allow-Methods 表明服務(wù)器允許客戶端使用 POST, GET 和 OPTIONS 方法發(fā)起請(qǐng)求难审。該字段與 HTTP/1.1 Allow: response header 類似瘫拣，但僅限于在需要訪問控制的場(chǎng)景中使用。

首部字段 Access-Control-Allow-Headers 表明服務(wù)器允許請(qǐng)求中攜帶字段 X-PINGOTHER 與 Content-Type告喊。與 Access-Control-Allow-Methods 一樣麸拄，Access-Control-Allow-Headers 的值為逗號(hào)分割的列表。

最后黔姜，首部字段 Access-Control-Max-Age 表明該響應(yīng)的有效時(shí)間為 86400 秒拢切，也就是 24 小時(shí)。在有效時(shí)間內(nèi)秆吵，瀏覽器無須為同一請(qǐng)求再次發(fā)起預(yù)檢請(qǐng)求淮椰。請(qǐng)注意，瀏覽器自身維護(hù)了一個(gè)最大有效時(shí)間纳寂，如果該首部字段的值超過了最大有效時(shí)間实苞，將不會(huì)生效。

預(yù)檢請(qǐng)求與重定向

大多數(shù)瀏覽器不支持針對(duì)于預(yù)檢請(qǐng)求的重定向烈疚。如果一個(gè)預(yù)檢請(qǐng)求發(fā)生了重定向，瀏覽器將報(bào)告錯(cuò)誤：

The request was redirected to 'https://example.com/foo', which is disallowed for cross-origin requests that require preflight
Request requires preflight, which is disallowed to follow cross-origin redirect

CORS 最初要求該行為聪轿，不過在后續(xù)的修訂中廢棄了這一要求爷肝。

在瀏覽器的實(shí)現(xiàn)跟上規(guī)范之前，有兩種方式規(guī)避上述報(bào)錯(cuò)行為：

  • 在服務(wù)端去掉對(duì)預(yù)檢請(qǐng)求的重定向；
  • 將實(shí)際請(qǐng)求變成一個(gè)簡(jiǎn)單請(qǐng)求灯抛。

如果上面兩種方式難以做到金赦，我們?nèi)杂衅渌k法：

  • 使用簡(jiǎn)單請(qǐng)求模擬預(yù)檢請(qǐng)求，用以探查預(yù)檢請(qǐng)求是否重定向到其他 URL（使用 Response.url 或 XHR.responseURL）对嚼；
  • 向上一步中獲得的 URL 發(fā)起請(qǐng)求夹抗。

不過，如果請(qǐng)求由于缺失 Authorization 字段而引起一個(gè)預(yù)檢請(qǐng)求纵竖，則這一方法將無法使用漠烧。這種情況只能由服務(wù)端進(jìn)行更改。

附帶身份憑證的請(qǐng)求

Fetch 與 CORS 的一個(gè)有趣的特性是靡砌，可以基于 HTTP cookies 和 HTTP 認(rèn)證信息發(fā)送身份憑證已脓。一般而言，對(duì)于跨域 XMLHttpRequest 或 Fetch 請(qǐng)求通殃，瀏覽器不會(huì)發(fā)送身份憑證信息度液。如果要發(fā)送憑證信息，需要設(shè)置 XMLHttpRequest 的某個(gè)特殊標(biāo)志位画舌。

本例中堕担，http://foo.example 的某腳本向 http://bar.other 發(fā)起一個(gè)GET 請(qǐng)求，并設(shè)置 Cookies：
var invocation = new XMLHttpRequest();
var url = 'http://bar.other/resources/credentialed-content/';

function callOtherDomain(){
  if(invocation) {
    invocation.open('GET', url, true);
    invocation.withCredentials = true;
    invocation.onreadystatechange = handler;
    invocation.send(); 
  }
}

第 7 行將 XMLHttpRequest 的 withCredentials 標(biāo)志設(shè)置為 true曲聂，從而向服務(wù)器發(fā)送 Cookies霹购。因?yàn)檫@是一個(gè)簡(jiǎn)單 GET 請(qǐng)求，所以瀏覽器不會(huì)對(duì)其發(fā)起“預(yù)檢請(qǐng)求”句葵。但是厕鹃，如果服務(wù)器端的響應(yīng)中未攜帶 Access-Control-Allow-Credentials: true ，瀏覽器將不會(huì)把響應(yīng)內(nèi)容返回給請(qǐng)求的發(fā)送者乍丈。

cred-req.png

客戶端與服務(wù)器端交互示例如下：

GET /resources/access-control-with-credentials/ HTTP/1.1
Host: bar.other
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.1b3pre) Gecko/20081130 Minefield/3.1b3pre
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
Referer: http://foo.example/examples/credential.html
Origin: http://foo.example
Cookie: pageAccess=2


HTTP/1.1 200 OK
Date: Mon, 01 Dec 2008 01:34:52 GMT
Server: Apache/2.0.61 (Unix) PHP/4.4.7 mod_ssl/2.0.61 OpenSSL/0.9.7e mod_fastcgi/2.4.2 DAV/2 SVN/1.4.2
X-Powered-By: PHP/5.2.6
Access-Control-Allow-Origin: http://foo.example
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Pragma: no-cache
Set-Cookie: pageAccess=3; expires=Wed, 31-Dec-2008 01:34:53 GMT
Vary: Accept-Encoding, Origin
Content-Encoding: gzip
Content-Length: 106
Keep-Alive: timeout=2, max=100
Connection: Keep-Alive
Content-Type: text/plain


[text/plain payload]

即使第 11 行指定了 Cookie 的相關(guān)信息剂碴，但是，如果 bar.other 的響應(yīng)中缺失 Access-Control-Allow-Credentials: true（第 19 行）轻专，則響應(yīng)內(nèi)容不會(huì)返回給請(qǐng)求的發(fā)起者忆矛。

附帶身份憑證的請(qǐng)求與通配符

對(duì)于附帶身份憑證的請(qǐng)求，服務(wù)器不得設(shè)置 Access-Control-Allow-Origin 的值為“*”请垛。

這是因?yàn)檎?qǐng)求的首部中攜帶了 Cookie 信息催训，如果 Access-Control-Allow-Origin 的值為“*”，請(qǐng)求將會(huì)失敗宗收。而將 Access-Control-Allow-Origin 的值設(shè)置為 http://foo.example漫拭，則請(qǐng)求將成功執(zhí)行。

另外混稽，響應(yīng)首部中也攜帶了 Set-Cookie 字段采驻，嘗試對(duì) Cookie 進(jìn)行修改审胚。如果操作失敗，將會(huì)拋出異常礼旅。

HTTP 響應(yīng)首部字段

本節(jié)列出了規(guī)范所定義的響應(yīng)首部字段膳叨。上一小節(jié)中，我們已經(jīng)看到了這些首部字段在實(shí)際場(chǎng)景中是如何工作的痘系。

Access-Control-Allow-Origin

響應(yīng)首部中可以攜帶一個(gè) Access-Control-Allow-Origin 字段菲嘴，其語法如下:

Access-Control-Allow-Origin: <origin> | *

其中，origin 參數(shù)的值指定了允許訪問該資源的外域 URI汰翠。對(duì)于不需要攜帶身份憑證的請(qǐng)求龄坪，服務(wù)器可以指定該字段的值為通配符，表示允許來自所有域的請(qǐng)求奴璃。

例如悉默，下面的字段值將允許來自 http://mozilla.com 的請(qǐng)求：

Access-Control-Allow-Origin: http://mozilla.com

如果服務(wù)端指定了具體的域名而非“*”，那么響應(yīng)首部中的 Vary 字段的值必須包含 Origin苟穆。這將告訴客戶端：服務(wù)器對(duì)不同的源站返回不同的內(nèi)容抄课。

Access-Control-Expose-Headers

Access-Control-Expose-Headers 首部字段指定了服務(wù)端允許的首部字段集合。

Access-Control-Expose-Headers: X-My-Custom-Header, X-Another-Custom-Header

服務(wù)器允許請(qǐng)求中攜帶 X-My-Custom-Header 和 X-Another-Custom-Header 這兩個(gè)字段雳旅。

Access-Control-Max-Age

Access-Control-Max-Age 首部字段指明了預(yù)檢請(qǐng)求的響應(yīng)的有效時(shí)間跟磨。

Access-Control-Max-Age: <delta-seconds>

delta-seconds 表示該響應(yīng)在多少秒內(nèi)有效。

Access-Control-Allow-Credentials

Access-Control-Allow-Credentials 首部字段用于預(yù)檢請(qǐng)求的響應(yīng)攒盈，表明服務(wù)器是否允許 credentials 標(biāo)志設(shè)置為 true 的請(qǐng)求抵拘。請(qǐng)注意：簡(jiǎn)單 GET 請(qǐng)求不會(huì)被預(yù)檢；如果對(duì)此類請(qǐng)求的響應(yīng)中不包含該字段型豁，瀏覽器不會(huì)將響應(yīng)返回給請(qǐng)求的調(diào)用者僵蛛。

Access-Control-Allow-Credentials: true

上文已經(jīng)討論了附帶身份憑證的請(qǐng)求。

Access-Control-Allow-Methods

Access-Control-Allow-Methods 首部字段用于預(yù)檢請(qǐng)求的響應(yīng)迎变。其指明了實(shí)際請(qǐng)求所允許使用的 HTTP 方法充尉。

Access-Control-Allow-Methods: <method>[, <method>]*

相關(guān)示例見這里。

Access-Control-Allow-Headers

Access-Control-Allow-Headers 首部字段用于預(yù)檢請(qǐng)求的響應(yīng)衣形。其指明了實(shí)際請(qǐng)求中允許攜帶的首部字段驼侠。

Access-Control-Allow-Headers: <field-name>[, <field-name>]*

HTTP 請(qǐng)求首部字段

本節(jié)列出了可用于發(fā)起跨域請(qǐng)求的首部字段。請(qǐng)注意谆吴，這些首部字段無須手動(dòng)設(shè)置倒源。 當(dāng)開發(fā)者使用 XMLHttpRequest 對(duì)象發(fā)起跨域請(qǐng)求時(shí)，它們已經(jīng)被設(shè)置就緒句狼。

Origin

Origin 首部字段表明預(yù)檢請(qǐng)求或?qū)嶋H請(qǐng)求的源站笋熬。

Origin: <origin>

origin 參數(shù)的值為源站 URI。它不包含任何路徑信息腻菇，只是服務(wù)器名稱突诬。

Note: 有時(shí)候?qū)⒃撟侄蔚闹翟O(shè)置為空字符串是有用的苫拍，例如，當(dāng)源站是一個(gè) data URL 時(shí)旺隙。

注意，不管是否為跨域請(qǐng)求骏令，ORIGIN 字段總是被發(fā)送蔬捷。

Access-Control-Request-Method

Access-Control-Request-Method 首部字段用于預(yù)檢請(qǐng)求。其作用是榔袋，將實(shí)際請(qǐng)求所使用的 HTTP 方法告訴服務(wù)器周拐。

Access-Control-Request-Method: <method>

相關(guān)示例見這里。

Access-Control-Request-Headers

Access-Control-Request-Headers 首部字段用于預(yù)檢請(qǐng)求凰兑。其作用是妥粟，將實(shí)際請(qǐng)求所攜帶的首部字段告訴服務(wù)器。

Access-Control-Request-Headers: <field-name>[, <field-name>]*

相關(guān)示例見這里吏够。

規(guī)范

Specification Status Comment
Fetch CORS Living Standard New definition; supplants CORS specification.
CORS Recommendation Initial definition.
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 人面猴
    序言：七十年代末勾给，一起剝皮案震驚了整個(gè)濱河市，隨后出現(xiàn)的幾起案子锅知，更是在濱河造成了極大的恐慌播急，老刑警劉巖，帶你破解...
    沈念sama閱讀 218,682評(píng)論 6贊 507
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件售睹，死亡現(xiàn)場(chǎng)離奇詭異桩警，居然都是意外死亡，警方通過查閱死者的電腦和手機(jī)昌妹，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,277評(píng)論 3贊 395
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進(jìn)店門捶枢，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人飞崖，你說我怎么就攤上這事烂叔。” “怎么了蚜厉？”我有些...
    開封第一講書人閱讀 165,083評(píng)論 0贊 355
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵长已，是天一觀的道長(zhǎng)。 經(jīng)常有香客問我昼牛，道長(zhǎng)术瓮，這世上最難降的妖魔是什么？ 我笑而不...
    開封第一講書人閱讀 58,763評(píng)論 1贊 295
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任贰健，我火速辦了婚禮胞四，結(jié)果婚禮上，老公的妹妹穿的比我還像新娘伶椿。我一直安慰自己辜伟，他們只是感情好氓侧，可當(dāng)我...
    茶點(diǎn)故事閱讀 67,785評(píng)論 6贊 392
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布。 她就那樣靜靜地躺著导狡，像睡著了一般约巷。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上旱捧，一...
    開封第一講書人閱讀 51,624評(píng)論 1贊 305
  • 城市分裂傳說
    那天独郎，我揣著相機(jī)與錄音，去河邊找鬼枚赡。 笑死氓癌，一個(gè)胖子當(dāng)著我的面吹牛，可吹牛的內(nèi)容都是我干的贫橙。 我是一名探鬼主播贪婉，決...
    沈念sama閱讀 40,358評(píng)論 3贊 418
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼，長(zhǎng)吁一口氣：“原來是場(chǎng)噩夢(mèng)啊……” “哼卢肃！你這毒婦竟也來了疲迂？” 一聲冷哼從身側(cè)響起，我...
    開封第一講書人閱讀 39,261評(píng)論 0贊 276
  • 萬榮殺人案實(shí)錄
    序言：老撾萬榮一對(duì)情侶失蹤践剂，失蹤者是張志新（化名）和其女友劉穎鬼譬，沒想到半個(gè)月后，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體逊脯，經(jīng)...
    沈念sama閱讀 45,722評(píng)論 1贊 315
  • ?護(hù)林員之死
    正文 獨(dú)居荒郊野嶺守林人離奇死亡优质，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評(píng)論 3贊 336
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了军洼。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片巩螃。...
    茶點(diǎn)故事閱讀 40,030評(píng)論 1贊 350
  • 活死人
    序言：一個(gè)原本活蹦亂跳的男人離奇死亡，死狀恐怖匕争，靈堂內(nèi)的尸體忽然破棺而出避乏，到底是詐尸還是另有隱情，我是刑警寧澤甘桑，帶...
    沈念sama閱讀 35,737評(píng)論 5贊 346
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布拍皮，位于F島的核電站，受9級(jí)特大地震影響跑杭，放射性物質(zhì)發(fā)生泄漏铆帽。R本人自食惡果不足惜，卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,360評(píng)論 3贊 330
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一德谅、第九天 我趴在偏房一處隱蔽的房頂上張望爹橱。 院中可真熱鬧，春花似錦窄做、人聲如沸愧驱。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,941評(píng)論 0贊 22
  • 一樁弒父案，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽组砚。三九已至吻商，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間糟红，已是汗流浹背手报。 一陣腳步聲響...
    開封第一講書人閱讀 33,057評(píng)論 1贊 270
  • 情欲美人皮
    我被黑心中介騙來泰國(guó)打工， 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留改化，地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,237評(píng)論 3贊 371
  • 代替公主和親
    正文 我出身青樓枉昏，卻偏偏與公主長(zhǎng)得像陈肛，于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子兄裂，可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,976評(píng)論 2贊 355

推薦閱讀更多精彩內(nèi)容

  • 在Web開發(fā)中句旱，經(jīng)常會(huì)碰到跨站請(qǐng)求。比如A域名下的站點(diǎn)http://domainA通過AJAX請(qǐng)求B域名下的站點(diǎn)h...
    Yvan_Yang閱讀 2,093評(píng)論 1贊 0
  • 本文是《圖解HTTP》讀書筆記的第二篇晰奖，主要包括此書的第六章內(nèi)容谈撒，因?yàn)榈诹碌膬?nèi)容較多，而且比較重要匾南，所以單獨(dú)寫為...
    lijiankun24閱讀 1,366評(píng)論 0贊 6
  • HTTP訪問控制（CORS） 要點(diǎn)摘錄： 跨域資源共享（CORS）機(jī)制允許Web 應(yīng)用服務(wù)器進(jìn)行跨域訪問控制啃匿，從...
    谷子多閱讀 292評(píng)論 0贊 0
  • 前言：對(duì)于跨域請(qǐng)求，很早之前就有去了解過蛆楞，但因?yàn)橐恢标P(guān)注的都是服務(wù)器后端開發(fā)溯乒，故也就僅僅停留在概念的理解上而沒有機(jī)...
    ken_ljq閱讀 89,767評(píng)論 6贊 128
  • CORS是一個(gè)W3C標(biāo)準(zhǔn)，全稱是"跨域資源共享"（Cross-origin resource sharing）豹爹。 ...
    奇特思維家閱讀 1,121評(píng)論 0贊 3