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 头添加到对实际（非预检）请求的响应中。最终，浏览器负责向 XHR 客户机公开头。请参阅 W3C 跨源资源共享建议中的 Access-Control-Expose-Headers。