使用 COOP 和 COEP 將網站設為「已跨來源隔離」

使用 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。
  • 如果是 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)。

網路面板「狀態」欄中的 COEP 問題。

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

在「網路」面板中點選網路資源後,「標頭」分頁會顯示 COEP 問題的詳細資料。

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

您可以查看 iframe 的狀態,例如 SharedArrayBuffer 的可用性等。

Chrome 開發人員工具 iframe 檢查器。

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

Chrome 開發人員工具對話方塊視窗檢查器

使用 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 開始提供。