CORS JSON 配置

編輯您所建立的 cors-rules.json 檔案來配置 CORS。

JSON 檔案必須包含具有兩個內容的單一 JSON 物件：

version {string} 必須等於 "1.0"。

rules {array<object>} 必須是一系列有效的 CORS 規則。

規則物件的語法定義如下：

resource {object}（必要）

說明如何將此規則與要求 URL 進行比對。支援下列內容：
  • path {string} （必要）資源路徑：若沒有 startsWith 或 exact 值，CORS 過濾器會將任何要求與包含此值的路徑進行比對。
  • startsWith {boolean}（選用）當 true 時，CORS 過濾器僅會將要求與以值 path 開頭的路徑進行比對 。
  • exact {boolean}（選用）當 true 時，CORS 過濾器僅會將要求與確切值為 path 的路徑進行比對 。startsWith 與 exact 內容是互斥的。

allowOrigins {string | array<string>}（必要）

指定此資源的所容許原點清單。指定一連串其中每一個元素都是所容許原點主機名稱的字串，例如，"http://this.example.com"。只容許完全符合其中一個元素的原點。例如，指定 "http://this.example.com"、"https://this.example.com" 及 "http://this.example.com:8080"，以容許透過所有這些 URL 進行存取。

值 "*" 容許任何原點。不建議使用它。

allowMethods {array<string>}（必要）

指定此資源及原點的所容許方法清單。請參閱有關「跨原點資源共用」之「W3C 建議」中的 Access-Control-Allow-Methods。

allowCredentials {boolean}（必要）

當 true 時，CORS 過濾器容許此資源及原點的認證。請參閱有關「跨原點資源共用」之「W3C 建議」中的 Access-Control-Allow-Credentials。

exposeHeaders {array<string>}（選用）

指定要公開給 XHR 用戶端的回應標頭清單。此內容會導致 CORS 過濾器將 Access-Control-Expose-Headers 標頭新增至實際（非 Pre-flight）要求的回應。最終，瀏覽器負責將標頭公開給 XHR 用戶端。請參閱有關「跨原點資源共用」之「W3C 建議」中的 Access-Control-Expose-Headers。