什麼是 CORS 請求標頭檢查器?
跨域資源共享(CORS,Cross-Origin Resource Sharing)是一種瀏覽器安全機制,用於控制一個域名的網頁如何請求不同域名的資源。當 https://myapp.com 上的前端應用嘗試從 https://api.example.com 獲取資料時,瀏覽器會檢查伺服器的 CORS 回應標頭,以確定是否允許該請求。CORS 請求標頭檢查器分析 API 伺服器的回應標頭,評估它們是否正確允許來自你指定來源、HTTP 方法和自訂請求標頭的跨域請求。它能識別常見的配置錯誤,如缺少 Access-Control-Allow-Origin 頭、萬用字元來源與憑據組合使用、以及不允許的方法或請求標頭等問題。
如何使用 CORS 請求標頭檢查器
- 1在'請求來源'欄位中輸入前端應用的來源地址(如 'https://myapp.com')。
- 2選擇應用進行跨域請求時使用的 HTTP 方法。
- 3將 API 伺服器的回應標頭貼上到'回應標頭'文字區域中。每行輸入一個標頭,格式為 'Key: Value'。
- 4檢視下方的分析結果。綠色對勾表示檢查透過,黃色警告提示潛在問題,紅色叉號表示阻止性問題。
常見使用場景
除錯 CORS 錯誤
當瀏覽器主控台顯示 'Access to fetch has been blocked by CORS policy' 時,將回應標頭貼上到此處,快速識別缺失或配置錯誤的內容。
伺服器配置驗證
在部署 API 變更前,驗證 CORS 回應標頭是否正確允許預期的來源、方法和自訂請求標頭,同時不會過度開放許可權。
安全審查
審計 API 的 CORS 配置,確保遵循安全最佳實踐——不將萬用字元來源與憑據一起使用、適當的預檢快取以及最小化的允許請求標頭。
CORS 教學與學習
透過嘗試不同的 CORS 標頭組合並即時檢視分析結果,深入理解不同配置如何影響瀏覽器行為。
常見問題
什麼是 CORS 預檢請求?
預檢請求是瀏覽器在實際請求之前自動傳送的 OPTIONS 請求,當使用非簡單方法(PUT、PATCH、DELETE)、自訂請求標頭或某些內容型別時會觸發。伺服器必須回應適當的 Access-Control-Allow-* 標頭。Access-Control-Max-Age 標頭控制瀏覽器快取預檢結果的時長。
為什麼不能將 Access-Control-Allow-Origin: * 與憑據一起使用?
當請求包含憑據(Cookie 或 HTTP 身份驗證)時,瀏覽器要求伺服器在 Access-Control-Allow-Origin 中返回確切的來源地址,而不是萬用字元 *。這可以防止任何網站向你的 API 發起帶身份驗證的請求。你必須回顯特定的請求來源。
哪些是不需要預檢的 'simple requests'?
簡單請求使用 GET、HEAD 或 POST 方法,且僅包含標準請求標頭(Accept、Accept-Language、Content-Language、Content-Type 的值為 application/x-www-form-urlencoded、multipart/form-data 或 text/plain)。任何其他組合都會觸發預檢 OPTIONS 請求。
這個工具會傳送實際請求來測試 CORS 嗎?
不會,本工具執行純離線分析。你貼上回應標頭,工具會根據你指定的來源和方法進行評估。要獲取實際的回應標頭,你可以使用瀏覽器開發者工具的網路頁籤、帶 -I 引數的 curl 命令或任何 HTTP 客戶端。