使用 COOP 和 COEP 設定已跨來源隔離環境,並啟用 SharedArrayBuffer、performance.measureUserAgentSpecificMemory() 和高解析度計時器等強大功能,提高精確度。
發布日期:2020 年 4 月 13 日,上次更新日期:2022 年 6 月 21 日
本文說明如何使用 COOP 和 COEP。如要進一步瞭解這項措施的重要性,請參閱「使用 COOP 和 COEP 將網站設為『已跨來源隔離』」一文。
部分 Web API 會提高 Spectre 等旁路攻擊的風險。為降低這類風險,瀏覽器提供名為「跨來源隔離」的隔離環境,使用者可選擇是否加入。在已跨來源隔離狀態下,網頁將能使用特殊權限功能,包括:
| API | 說明 |
|---|---|
SharedArrayBuffer
|
WebAssembly 執行緒的必要條件。這項功能自 Android Chrome 88 起開放使用。電腦版預設會啟用網站隔離功能,但必須處於已跨來源隔離狀態,且在 Chrome 92 中預設為停用。 |
performance.measureUserAgentSpecificMemory()
|
Chrome 89 以上版本適用。 |
performance.now(),performance.timeOrigin
|
適用於多種瀏覽器,解析度限制為 100 微秒以上。如果已跨來源隔離,解析度可達 5 微秒以上。 |
已跨來源隔離狀態也會防止修改 document.domain。(能夠修改 document.domain 可讓相同網站的文件之間進行通訊,這被視為相同來源政策中的漏洞)。
如要選擇加入已跨來源隔離狀態,您必須在主文件上傳送下列 HTTP 標頭:
Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin
這些標頭會指示瀏覽器,封鎖未選擇由跨源文件載入的資源或 iframe,並防止跨源視窗直接與文件互動。這也表示,跨源載入的資源需要選擇加入。
您可以檢查 self.crossOriginIsolated,判斷網頁是否處於已跨來源隔離狀態。
詞彙
本文使用許多名稱和縮寫相似的術語。為釐清這些概念,我們整理了一份迷你詞彙表:
將網站設為跨來源隔離
1. 在頂層文件上設定 Cross-Origin-Opener-Policy: same-origin
在頂層文件啟用 COOP: same-origin 後,除非來源和 COOP 設定相同,否則來源相同和從文件開啟的視窗,會位於不同的瀏覽情境群組。因此,系統會強制隔離開啟的視窗,並停用兩個視窗之間的相互通訊。
瀏覽情境群組是一組可互相參照的視窗。例如,頂層文件和其子文件嵌入 <iframe>。如果網站 (https://a.example) 開啟對話方塊視窗 (https://b.example),開啟工具視窗和對話方塊視窗會共用相同的瀏覽情境,因此可透過 window.opener 等 DOM API 互相存取。

您可以透過開發人員工具,檢查視窗開啟工具和開啟的視窗是否位於不同的瀏覽情境群組。
2. 為資源啟用 CORP 或 CORS
請確認網頁中的所有資源都已載入 CORP 或 CORS HTTP 標頭。這是步驟四:啟用 COEP 的必要步驟。
請根據資源性質採取以下行動:
- 如果資源預期「只能從相同來源」載入,請設定
Cross-Origin-Resource-Policy: same-origin標頭。 - 如果預期資源只會從同一個網站載入,但來源不同,請設定
Cross-Origin-Resource-Policy: same-site標頭。 - 如果資源是從您控制的跨來源載入,請盡可能設定
Cross-Origin-Resource-Policy: cross-origin標頭。 - 對於您無法控制的跨來源資源:
- 如果資源是透過 CORS 提供,請在載入 HTML 代碼中使用
crossorigin屬性。例如<img src="***" crossorigin>。 - 請要求資源擁有者支援 CORS 或 CORP。
- 如果資源是透過 CORS 提供,請在載入 HTML 代碼中使用
- 如果是 iframe,請遵循相同原則,並設定
Cross-Origin-Resource-Policy: cross-origin(或same-site、same-origin,視情況而定)。 - 使用
WebWorker載入的指令碼必須來自相同來源,因此不需要 CORP 或 CORS 標頭。 - 對於使用
COEP: require-corp提供的文件或 worker,在不使用 CORS 的情況下載入的跨源子資源必須設定Cross-Origin-Resource-Policy: cross-origin標頭,才能選擇嵌入。例如,這適用於<script>、importScripts、<link>、<video>、<iframe>等。
在 iframe 中隔離
您可以將 allow="cross-origin-isolated" 權限政策套用至 <iframe> 標記,並符合這些條件,在 iframe 內嵌的文件上啟用跨來源隔離。整個文件鏈 (包括父項框架和子項框架) 也必須已跨來源隔離。
3. 使用 COEP Report-Only HTTP 標頭評估嵌入資源
在完全啟用 COEP 之前,您可以使用 Cross-Origin-Embedder-Policy-Report-Only 標頭進行模擬測試,檢查政策是否確實有效。您會收到報表,但不會封鎖嵌入內容。
請將這項設定遞迴套用至「所有」文件,包括頂層文件、iframe 和 worker 指令碼。如要瞭解 Report-Only HTTP 標頭,請參閱「使用 Reporting API 觀察問題」。
4. 啟用 COEP
確認資源已啟用 CORP 或 CORS 後,才能執行這個步驟。
確認一切正常運作且所有資源都能成功載入後,請將 Cross-Origin-Embedder-Policy-Report-Only 標頭切換為 Cross-Origin-Embedder-Policy 標頭,並為所有文件 (包括使用 iframe 和 worker 指令碼嵌入的文件) 設定相同的值。
判斷隔離是否成功
當網頁處於已跨來源隔離狀態,且所有資源和視窗都在同一個瀏覽情境群組中隔離時,self.crossOriginIsolated 屬性會傳回 true。您可以使用這個 API 判斷是否已成功隔離瀏覽情境群組,並取得 performance.measureUserAgentSpecificMemory() 等功能的存取權。
偵錯
您可能會遇到 COOP 和 COEP 相關問題。您可以使用瀏覽器開發人員工具或 Reporting API 進行偵錯。
使用 Chrome 開發人員工具偵錯
對於在畫面上轉譯的資源 (例如圖片),偵測 COEP 問題相當容易,因為要求會遭到封鎖,且頁面應會指出缺少圖片。不過,對於不一定會影響視覺效果的資源 (例如指令碼或樣式),COEP 問題可能會遭到忽略。如要查看這類要求,請使用開發人員工具的「網路」面板。
如果 COEP 有問題,Status 欄中會顯示 (blocked:NotSameOriginAfterDefaultedToSameOriginByCoep)。

接著,您可以點選項目查看更多詳細資料。

您也可以透過「Application」面板,判斷 iframe 和對話方塊視窗的狀態。前往左側的「Frames」部分,然後展開「top」即可查看資源結構細目。
您可以查看 iframe 的狀態,例如 SharedArrayBuffer 的可用性等。

您也可以查看對話方塊視窗的狀態,例如是否已跨來源隔離。

使用 Reporting API 觀察問題
Reporting API 是另一種可用來偵測各種問題的機制。您可以設定 Reporting API,指示使用者的瀏覽器在 COEP 封鎖資源載入或 COOP 隔離對話方塊視窗時傳送報告。Chrome 自 69 版起支援 Reporting API,可用於多種用途,包括 COEP 和 COOP。
瞭解如何設定 Reporting API,以及設定伺服器來接收報表。
COEP 報表範例
跨源資源遭到封鎖時,COEP 報表酬載範例如下:
[{
"age": 25101,
"body": {
"blocked-url": "https://third-party-test.example.org/check.svg?",
"blockedURL": "https://third-party-test.example.org/check.svg?",
"destination": "image",
"disposition": "enforce",
"type": "corp"
},
"type": "coep",
"url": "https://cross-origin-isolation.example.com/?coep=require-corp&coop=same-origin&",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4249.0 Safari/537.36"
}]
COOP 報表示例
在獨立開啟對話方塊時,COOP 報告酬載範例如下:
[{
"age": 7,
"body": {
"disposition": "enforce",
"effectivePolicy": "same-origin",
"nextResponseURL": "https://third-party-test.example.org/popup?report-only&coop=same-origin&",
"type": "navigation-from-response"
},
"type": "coop",
"url": "https://cross-origin-isolation.example.com/coop?coop=same-origin&",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
}]
當不同的瀏覽情境群組嘗試互相存取時 (僅限「僅限報表」模式),COOP 也會傳送報表。舉例來說,嘗試 postMessage() 時,報表會像這樣:
[{
"age": 51785,
"body": {
"columnNumber": 18,
"disposition": "reporting",
"effectivePolicy": "same-origin",
"lineNumber": 83,
"property": "postMessage",
"sourceFile": "https://cross-origin-isolation.example.com/popup.js",
"type": "access-from-coop-page-to-openee"
},
"type": "coop",
"url": "https://cross-origin-isolation.example.com/coop?report-only&coop=same-origin&",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
},
{
"age": 51785,
"body": {
"disposition": "reporting",
"effectivePolicy": "same-origin",
"property": "postMessage",
"type": "access-to-coop-page-from-openee"
},
"type": "coop",
"url": "https://cross-origin-isolation.example.com/coop?report-only&coop=same-origin&",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
}]
重點整理
您可以結合使用 COOP 和 COEP HTTP 標頭,讓網頁進入特殊的已跨來源隔離狀態。您可以檢查 self.crossOriginIsolated,判斷網頁是否處於已跨來源隔離狀態。
隨著這項已跨來源隔離狀態推出新功能,以及 DevTools 進一步改善 COOP 和 COEP,我們會持續更新這篇文章。
資源
文件更新
- 2022 年 6 月 21 日:啟用跨來源隔離時,也需要注意 Worker 指令碼。新增一些說明。
- 2021 年 8 月 5 日:JS Self-Profiling API 曾被提及為需要跨來源隔離的 API 之一,但反映最近的方向變更,已移除。
- 2021 年 5 月 6 日:根據收到的意見回饋和回報的問題,我們決定調整時間表,在 Chrome M92 中限制非跨來源隔離網站使用
SharedArrayBuffer。 - 2021 年 4 月 16 日:新增 COEP 無憑證模式和 COOP same-origin-allow-popups 的附註,做為跨來源隔離的寬鬆條件。
- 2021 年 3 月 5 日:移除
SharedArrayBuffer、performance.measureUserAgentSpecificMemory()和偵錯功能的限制,這些功能現已在 Chrome 89 中完全啟用。新增即將推出的功能performance.now()和performance.timeOrigin,可提供更高的精確度。 - 2021 年 2 月 19 日:新增關於開發人員工具功能政策
allow="cross-origin-isolated"和偵錯功能的附註。 - 2020 年 10 月 15 日:Chrome 87 起提供
self.crossOriginIsolated。因此,當self.crossOriginIsolated傳回true時,document.domain是不可變的。performance.measureUserAgentSpecificMemory()的來源試用即將結束,並在 Chrome 89 中預設啟用。Android Chrome 的 Shared Array Buffer 將從 Chrome 88 開始提供。