紀錄工作經驗、相關知識,解決技術相關問題。

網站相關, 資訊相關

瀏覽器 Same-Origin Policy 同源政策與跨來源限制原理

瀏覽器 Same-Origin Policy 同源政策與跨來源限制原理 特色圖片

如果沒有「同源政策 (Same-Origin Policy)」,任何惡意網站都可以用 JavaScript 讀取你登入中的銀行網頁內容、API 回應與 LocalStorage 資料。這篇文章將帶你從底層原理搞懂這道最重要的網路安全防火牆!


一、 什麼是「同源」?判定三要素

兩個 URL 必須在以下三個維度 完全一致,瀏覽器才會認定為「同源 (Same Origin)」:

  1. 協議 (Protocol / Scheme):例如 http: vs https:(不同源)。
  2. 主機網域名稱 (Host / Domain):例如 seanacnet.com vs api.seanacnet.com(子網域不同,非同源)。
  3. 通訊埠 (Port):例如 :80 vs :443 vs :3000(非同源)。

1.1 經典同源判定對照表(基準:https://example.com/app/index.html)

比較目標 URL是否同源?原因說明
https://example.com/api/users同源 (Yes)協議、網域、通訊埠皆完全一致
https://example.com:443/about同源 (Yes)443 為 HTTPS 預設埠號
http://example.com/app/非同源 (No)協議不同 (http vs https)
https://sub.example.com/app/非同源 (No)子網域不同
https://example.com:8080/app/非同源 (No)通訊埠不同 (8080 vs 443)

二、 同源政策限制了哪些行為?

同源政策主要在三個層面實施嚴格封鎖:

  1. DOM 存取限制:不同源的頁面無法透過 JavaScript 讀取彼此的 DOM。例如在主頁面透過 iframe 載入外部網頁時,主頁面無法存取該 iframe.contentDocument。
  2. 數據存取限制:LocalStorage 與 IndexedDB 依來源(Origin)隔離,JavaScript 無法讀寫其他來源的儲存空間。Cookie 則另有一套以網域(Domain)與路徑(Path)為範圍的規則,不完全依照同源三要素劃分。
  3. 網路請求限制:使用 XMLHttpRequest 或 fetch 發送跨來源請求時,若伺服器未明確回傳合法 CORS 標頭,瀏覽器會直接攔截回應結果。注意同源政策主要限制的是「讀取」:跨來源的連結、重新導向與表單送出等「寫入」通常是允許的。

2.1 關鍵觀念:CORS 請求其實有成功抵達後端,是瀏覽器攔截 Response

許多前端工程師在瀏覽器 Console 看到 CORS error 時,會誤以為後端 API 壞了、伺服器掛了或根本沒有被觸發。實際上,這是一個非常重要的底層觀念盲點:

以「簡單請求」來說,跨來源請求已經成功抵達伺服器並執行完畢(例如資料庫已經完成了 INSERT 或 UPDATE),是「瀏覽器」在接收到伺服器的 Response 後,檢查發現 Response Headers 中缺少 Access-Control-Allow-Origin 授權標頭,因而將資料攔截,不讓前端的 JavaScript 讀取結果。

需要 Preflight 的請求則不同:若 OPTIONS 預檢沒有通過,瀏覽器根本不會送出正式請求,後端只會收到那一筆 OPTIONS(時序見下一節)。

因此,若涉及具備寫入性質的 API(例如結帳、修改密碼),千萬不能單純依賴 CORS 機制來保護後端,因為簡單請求(例如 Content-Type: text/plain 的 POST)照樣會送達並執行,必須在後端配合 Token 驗證或冪等性設計。

2.2 Preflight 預檢請求的觸發條件與時序

當前端發送非簡單請求時,瀏覽器為了安全起見,會自動在正式請求發送前,先發送一個 OPTIONS 方法的預檢請求 (Preflight Request) 來探測伺服器是否允許該跨來源操作。

何時會觸發 Preflight?
若滿足以下任一條件,瀏覽器就會自動發起 Preflight:

  1. HTTP 方法:使用了 GET、HEAD、POST 以外的方法,例如 PUT、DELETE、PATCH。(CONNECT、TRACE、TRACK 是 Fetch 規範的禁用方法,fetch() 會直接拋出 TypeError,不會發出任何請求。)
  2. 非安全清單標頭:手動設定了 CORS-safelisted 以外的標頭。可自由設定的只有 Accept、Accept-Language、Content-Language、Content-Type 與單一範圍的 Range,最常見的觸發來源是 Authorization 或自訂的 X- 標頭。
  3. Content-Type 不在允許值內:Content-Type 只有 application/x-www-form-urlencoded、multipart/form-data、text/plain 三種算簡單請求,因此常見的 Content-Type: application/json 也會觸發 Preflight。

Preflight 運作時序:

  1. Frontend (Browser) ➔ OPTIONS /api/data(詢問伺服器是否允許指定網域、Method 與 Headers)
  2. Backend Server ➔ 回傳 204 No Content 並夾帶 Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers
  3. Frontend (Browser) ➔ 確認伺服器允許後,才發送正式請求(例如 PUT /api/data)
  4. Backend Server ➔ 執行業務邏輯並回傳 Response
  5. Frontend (Browser) ➔ 再次檢查 Response 標頭,若符合規範則交給 JS 讀取,否則直接攔截報錯

三、 合法的跨來源資源互通方案

在合法的業務場景下,若需要與外部伺服器通訊,標準方案包括:

  • CORS (Cross-Origin Resource Sharing):後端配置 Access-Control-Allow-Origin 標頭授權讀取。
  • Window.postMessage:針對跨視窗或內嵌 iframe,以發送事件的方式進行安全的跨源消息傳遞。

四、 跨視窗與 iframe 安全通訊:Window.postMessage 實作範例

當主畫面需要與不同源的 iframe 或彈出視窗(Popup)進行資料交換時,直接存取 DOM 會被同源政策拒絕。此時必須透過 window.postMessage() 來傳遞訊息。發送端必須明確指定目標來源(targetOrigin),接收端必須驗證 event.origin,避免資料外洩給惡意頁面,或因收下偽造訊息而遭受跨站腳本攻擊 (XSS)。

以下為生產環境中安全實作 postMessage 的程式碼範例:

// 【發送端 (Parent Window)】
// 取得目標 iframe 的 window 物件
const iframeWindow = document.getElementById('myFrame').contentWindow;

// 發送資料時,明確指定目標 Origin,嚴禁使用萬用字元 '*'
const targetOrigin = 'https://trusted-partner.com';
const payload = { action: 'UPDATE_TOKEN', token: 'xyz123' };

iframeWindow.postMessage(payload, targetOrigin);

// 【接收端 (iframe 內部)】
window.addEventListener('message', (event) => {
  // 核心安全檢查:驗證訊息來源是否為預期的網域
  if (event.origin !== 'https://my-main-domain.com') {
    console.warn('收到來自不受信任來源的訊息,已攔截:', event.origin);
    return;
  }

  // 確保 origin 安全後,才進行後續處理
  const { action, token } = event.data;
  if (action === 'UPDATE_TOKEN') {
    console.log('成功收到合法父視窗傳遞的 Token:', token);
  }
});

五、 後端伺服器 CORS 標頭設定與實作範例

當前端 JavaScript 透過 fetch 或 XMLHttpRequest 發送跨來源請求時,伺服器必須在 HTTP Response Headers 中帶入對應的 CORS 標頭,瀏覽器才會放行回應資料。

以下為 Node.js (Express) 處理簡單請求與預檢請求 (Preflight Request) 的實作範例:

// Express 伺服器 CORS Middleware 設定範例
const express = require('express');
const app = express();

app.use((req, res, next) => {
  // 授權特定的來源網域,生產環境中切勿無條件設定為 '*'
  res.setHeader('Access-Control-Allow-Origin', 'https://allowed-frontend.com');
  
  // 允許前端請求夾帶的 HTTP 方法
  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
  
  // 允許前端請求夾帶的自訂標頭 (例如 Authorization 憑證或 Content-Type)
  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
  
  // 允許前端在跨來源請求中夾帶 Cookie 憑證
  res.setHeader('Access-Control-Allow-Credentials', 'true');

  // 處理瀏覽器自動發送的 OPTIONS 預檢請求
  if (req.method === 'OPTIONS') {
    return res.sendStatus(204);
  }

  next();
});

app.get('/api/data', (req, res) => {
  res.json({ message: 'CORS 驗證成功,順利取得後端資料!' });
});

app.listen(3000);

六、 跨來源限制的常見排錯情境

在前後端分離架構或整合第三方服務時,開發者經常會遇到同源政策與 CORS 引起的阻斷。以下整理 4 種高頻發生的排錯情境與對應解法:

6.1 瀏覽器 Console 出現 No 'Access-Control-Allow-Origin' header 錯誤

  • 問題原因:前端發送的 fetch 請求網域與後端伺服器不一致,且後端未設定 Access-Control-Allow-Origin 標頭,導致瀏覽器安全機制攔截了 Response。
  • 解法:檢查後端伺服器的 Middleware 設定,確認回應標頭中已正確帶入對應的前端 Origin。若為開發環境,亦可在前端設定 Proxy 伺服器(如 Vite 或 Webpack Dev Server proxy)來繞過瀏覽器限制。

6.2 帶有憑證的請求 (Credentials) 導致 CORS 驗證失敗

  • 問題原因:當前端 fetch 設定 credentials: 'include'(或 xhr.withCredentials = true)準備夾帶 Cookie 時,後端伺服器的 Access-Control-Allow-Origin 絕對不能設定為萬用字元 *。
  • 解法:後端必須明確指定單一來源網域(例如 https://client.com),並額外設定 Access-Control-Allow-Credentials: true。

6.3 OPTIONS 預檢請求返回 404 或 500 錯誤

  • 問題原因:當前端發送非簡單請求(如帶有 Content-Type: application/json 或自訂 Header 的 POST 請求)時,瀏覽器會自動發送 OPTIONS 方法的預檢請求。若後端路由未對 OPTIONS 進行對應處理,就會直接噴錯。
  • 解法:在後端路由或全域 Middleware 中,攔截所有 OPTIONS 請求,帶上 Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers 等標頭後回傳 204 No Content 狀態碼(如第五節範例)。

6.4 postMessage 拋出 DataCloneError 或接收端無法解析資料

  • 問題原因:發送端傳遞的資料包含函式、DOM 節點等無法被 Structured Clone 演算法複製的內容時,postMessage 會在發送端直接拋出 DataCloneError(例如 Failed to execute 'postMessage' on 'Window': () => 1 could not be cloned.),訊息不會送出;另一種情況是接收端未正確解析 event.data 的結構。
  • 解法:確保透過 postMessage 傳遞的 payload 僅包含純資料物件(Plain Object)、字串或陣列,在發送端以 try...catch 捕捉 DataCloneError,並在接收端加上型別防禦檢查。

總結

同源政策並不是要阻止網路互聯,而是透過嚴格限制「誰能讀取敏感數據」,保護使用者的隱私與憑證免遭竊取。理解 CORS、Preflight 機制與 postMessage 的安全邊界,是現代網頁開發者必備的核心防禦能力。

參考資料與延伸閱讀

發佈留言