You need to enable JavaScript to run this app.
文档中心
API 网关

API 网关

复制全文
下载 pdf
路由策略
配置跨域策略
复制全文
下载 pdf
配置跨域策略
API 网关支持为路由配置跨域策略,您可以为指定路由开启跨域。本文介绍如何为路由配置跨域策略。​
背景信息​
在 HTTP 协议中,跨域(Cross-Origin)是指浏览器出于安全考虑,对不同源(Origin)之间的资源访问实施的限制机制。您可以在 API 网关的路由中开启跨域资源共享 CORS(Cross-Origin Resource Sharing)功能,允许进行跨域访问,从而实现跨域数据安全传输。​
前提条件​
已创建路由,详情可参见 创建路由。​
操作步骤​
  1. 登录 API 网关控制台。​
  1. 在顶部导航栏,选择目标地域。​
  1. 在左侧导航栏选择 路由管理 > 路由列表。​
  1. 在路由列表中,选择目标路由,单击 操作 列下的 编辑。​
  1. 在编辑路由页面的 高级配置 区域,勾选 跨域 后的 开启,开启并配置跨域访问策略。​
  • ​​​
  • ​
    配置项​
    说明​
    AllowCredentials​
    是否允许跨域请求携带验证信息,例如:Cookie、HTTP 认证或客户端 SSL 证书等。​
    AllowOrigins​
    配置允许跨域访问的域名,支持 正则匹配 和 精确匹配。域名的格式为scheme://host:port,例如http://apig-example.com:8080。​
    • 允许使用通配符.*表示任何域名。​
    • 单击 添加,允许配置多个域名,最多支持配置 5 个域名。​
    AllowMethods​
    配置允许跨域访问的方法。支持 GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH 和 CONNECT。​
    AllowHeaders​
    配置客户端在跨域请求中可以携带哪些非 CORS 规范以外的 Header。系统通过该字段告知客户端可以在实际请求中使用这些头信息。只有当客户端使用的自定义头在AllowHeaders列表中时,客户端才会继续发送实际的跨域请求。否则,请求会被拦截,导致跨域失败。​
    • 允许配置多个 Header,配置时支持使用回车或逗号,分割。​
    • 允许使用通配符*表示任何 Header。​
    ExposeHeaders​
    配置服务端在跨域请求的响应中可以携带哪些非 CORS 规范以外的 Header。​
    • 允许配置多个 Header,配置时支持使用回车或逗号,分割。​
    • 允许使用通配符*表示任何 Header。​
    缓存时间​
    配置预检请求结果的有效缓存时间,整数形式,取值范围为 0~86400,单位为秒。取值为 0 时表示不缓存。​
    ​
  1. 单击 确定,完成配置。​
结果验证​
配置完成后,可以使用如下命令,验证跨域策略是否生效。​
​
curl --location --request OPTIONS 'apig-example.com' \ ​
--header 'Origin: http://test.com' \ ​
--header 'Access-Control-Request-Method: POST' \ ​
--data ''​
​
预期响应结果如下。可以看到能够正常访问后端服务,并且响应头中包含了Access-Control-Allow-Origin、Access-Control-Allow-Method等 CORS 相关头信息。​
​
HTTP/1.1 200 OK​
Access-Control-Allow-Origin: http://test.com​
Access-Control-Allow-Method: POST, GET, OPTIONS​
Access-Control-Allow-Headers: Content-Type​
Access-Control-Max-Age: 86400​
...​
​
​
​
最近更新时间:2025.09.09 11:32:33
这个页面对您有帮助吗?
有用
有用
无用
无用