你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

将 Azure CDN 与 CORS 一起使用

重要

Microsoft Azure CDN Standard(经典版)将于 2027 年 9 月 30 日停用。 为了避免任何服务中断,请务必在 2027 年 9 月 30 日之前将 Microsoft Azure CDN Standard(经典版)配置文件迁移到 Azure Front Door Standard 层或 Premium 层。 有关详细信息,请参阅 Microsoft Azure CDN Standard(经典版)停用

Edgio Azure CDN 将于 2025 年 1 月 15 日停用。 为了避免服务中断,必须在此日期之前将工作负载迁移到 Azure Front Door。 有关详细信息,请参阅 Edgio 的 Azure CDN 停用常见问题解答

什么是 CORS?

CORS(跨域资源共享)是一项 HTTP 功能,用于支持在一个域下运行的 Web 应用程序访问另一个域中的资源。 为了减少跨站点脚本攻击的可能性,所有现代 Web 浏览器都实现了称为同源策略的安全限制。 此项限制可以防止网页调用其他域中的 API。 CORS 提供了一种安全方式,允许一个源(源域)调用另一个源中的 API。

工作原理

CORS 请求有两种类型:简单请求和复杂请求

简单请求:

  1. 浏览器发送带有其他源 HTTP 请求标头的 CORS 请求。 此请求头的值是为父页面提供服务的源,它被定义为协议、域和端口的组合。当来自 HTTPS://www.contoso.com 的页面尝试访问 fabrikam.com 源中的用户数据时,以下请求标头将发送到 fabrikam.com:

    Origin: https://www.contoso.com

  2. 服务器可能会使用以下任意标头进行响应:

    • 响应中含有 Access-Control-Allow-Origin 标头,指示允许使用哪个源站点。 例如:

      Access-Control-Allow-Origin: https://www.contoso.com

    • 如果服务器在检查源标头之后不允许跨源请求,则会显示 HTTP 错误代码(如 403)

    • 带有通配符的 Access-Control-Allow-Origin 标头,允许所有源:

      Access-Control-Allow-Origin: *

复杂请求:

复杂请求是一个 CORS 请求,它要求浏览器在发送实际 CORS 请求之前发送预检请求(即初步探测)。 如果原始 CORS 请求可以继续并且是对同一 URL 的 OPTIONS 请求,则预检请求会向服务器请求权限。

提示

有关 CORS 流和常见问题的详细信息,请查看 REST API 的 CORS 指南

通配符或单个源场景

当 Access-Control-Allow-Origin 标头设置为通配符 (*) 或单个源时,Azure CDN 上的 CORS 会自动工作,无需其他配置。 CDN 将缓存第一个响应,且后续请求将使用相同的标头。

如果在源上设置 CORS 之前已对 CDN 发出请求,则需要清除终结点内容上的内容,以使用 Access-Control-Allow-Origin 标头重新加载内容。

多个源场景

如果需要 CORS 允许一个特定的源列表,情况会稍微复杂一些。 当 CDN 缓存第一个 CORS 源的 Access-Control-Allow-Origin 标头时,会出现问题。 当不同的 CORS 源发出后续请求时,CDN 将为缓存的 Access-Control-Allow-Origin 标头提供服务,但不匹配。 有多种方法可纠正此问题。

Azure CDN 标准版配置文件

在 Microsoft Azure CDN 标准版中,你可以在标准规则引擎中创建规则以检查请求的“Origin”标头。 如果是有效的源,规则将使用所需的值来设置 Access-Control-Allow-Origin 标头。 在这种情况下,来自文件的源服务器的 Access-Control-Allow-Origin 标头都会被忽略,并且 CDN 的规则引擎会完全管理允许的 CORS 源。

标准规则引擎的规则示例

提示

你可以向规则添加其他操作,以修改其他响应标头,如 Access-Control-Allow-Methods

Edgio 提供的高级 Azure CDN

使用 Edgio 高级规则引擎,你将需要创建一条规则来检查请求的 Origin 标头。 如果是有效的源,规则将使用请求中提供的源设置 Access-Control-Allow-Origin 标头。 如果不允许使用在 Origin 标头中指定的源,规则应忽略 Access-Control-Allow-Origin 标头,这会导致浏览器拒绝请求。

可以通过两种方法解决高级规则引擎中的此问题。 在这两种情况下,来自文件的源服务器的 Access-Control-Allow-Origin 标头都会被忽略,并且 CDN 的规则引擎会完全管理允许的 CORS 源。

一个具有所有有效源的正则表达式

在这种情况下,将创建一个正则表达式,其中包含要允许的所有源:

https?:\/\/(www\.contoso\.com|contoso\.com|www\.microsoft\.com|microsoft.com\.com)$

提示

Edgio 的 Azure CDN 高级版使用兼容 Perl 的正则表达式作为其正则表达式的引擎。 可以使用正则表达式 101 等工具验证正则表达式。 请注意,“/”字符在正则表达式中有效且无需转义,但是转义该字符被认为是最佳实践,并且一些正则表达式验证器也期望对其进行转义。

如果正则表达式匹配,规则将使用发送请求的源替换源中的 Access-Control-Allow-Origin 标头(如有)。 还可以添加其他 CORS 标头,例如 Access-Control-Allow-Methods。

带正则表达式的规则示例

为每个源请求标头规则。

与其使用正则表达式,不如用 Request Header Wildcard 匹配条件 为每个要允许的源创建单独的规则。 与正则表达式方法一样,规则引擎单独设置 CORS 标头。

没有正则表达式的规则示例

提示

在示例中,使用的通配符 * 告知规则引擎匹配 HTTP 和 HTTPS。