对象存储

  • 对象存储 > 产品手册 > 管理存储空间 > 设置跨域资源共享

    设置跨域资源共享

    最近更新时间:2019-10-17 14:40:26

    跨域访问,或者说JavaScript的跨域访问问题,是浏览器出于安全考虑而设置的一个限制,即同源策略。当来自于A网站的页面中的JavaScript代码希望访问B网站的时候,浏览器会拒绝该访问,因为A、B两个网站是属于不同的域。

    在实际应用中,经常会有跨域访问的需求,比如用户的网站 a.website.com,后端使用了七牛云存储系统。在网页中提供了使用JavaScript实现的上传功能,但是在该页面中,只能向 a.website.com 发送请求,向其他网站发送的请求都会被浏览器拒绝。这样就导致用户上传的数据必须从 a.website.com 中转。如果设置了跨域访问的话,用户就可以直接上传到OSS而无需从 a.website.com 中转。

    跨域资源共享的实现

    跨域资源共享(Cross-Origin Resource Sharing),简称 CORS,是 HTML5 提供的标准跨域解决方案,七牛云存储系统支持 CORS 标准来实现跨域访问。具体的CORS规则可以参考W3C CORS规范。其实现如下:
    1、CORS 通过HTTP请求中附带 Origin 的Header来表明自己来源域,比如上面那个例子,Origin的Header就是 a.website.com 。
    2、服务器端接收到这个请求之后,会根据一定的规则判断是否允许该来源域的请求。如果允许,服务器在返回的响应中会附带上Access-Control-Allow-Origin这个Header,内容为 a.website.com 来表示允许该次跨域访问。如果服务器允许所有的跨域请求,将Access-Control-Allow-Origin的Header设置为 * 即可。
    3、浏览器根据是否返回了对应的Header来决定该跨域请求是否成功,如果没有附加对应的Header,浏览器将会拦截该请求。如果是非简单请求,浏览器会先发送一个 OPTIONS 请求来获取服务器的 CORS 配置,如果服务器不支持接下来的操作,浏览器也会拦截接下来的请求。

    七牛云存储提供了 CORS 规则的配置,从而根据需求允许或者拒绝相应的跨域请求。该规则是配置在Bucket级别的。

    细节分析

    • CORS 相关的Header附加等都是浏览器自动完成的,用户不需要有任何额外的操作。CORS 操作也只在浏览器环境下有意义。
    • CORS 请求的通过与否和七牛云存储的身份验证是完全独立的,即七牛云存储的 CORS 规则仅仅是用来决定是否附加 CORS 相关的Header的一个规则。是否拦截该请求完全由浏览器决定。
    • 使用跨域请求的时候需要关注浏览器是否开启了 Cache 功能。当运行在同一个浏览器上分别来源于a.website.com 和 b.website.com 的两个页面都同时请求同一个跨域资源的时候,如果 a.website.com 的请求先到达服务器,服务器将资源带上 Access-Control-Allow-Origin 的 Header 为 a.website.com 返回给用户。这个时候 b.website.com 又发起了请求,浏览器会将 Cache 的上一次请求返回给用户,此时 Header 的内容和 CORS 的要求不匹配,就会导致后面的请求失败。

    设置

    系统支持创建多条跨域访问规则,当收到跨域访问请求时,会依次检查每一条规则,使用第一条匹配的规则来允许请求并返回对应的 Header。如果所有规则都匹配失败,则不附加任何 CORS 相关的 Header。CORS 规则匹配成功必须满足以下三个条件:

    • 请求的 Origin 必须匹配一个允许来源项。
    • 请求的方法(如GET、PUT等)或者OPTIONS请求的 Access-Control-Request-Method 头对应的方法必须匹配一个允许Methods项。
    • OPTIONS请求的Access-Control-Request-Headers头包含的每个Header都必须匹配一个允许Headers项。

    在空间设置界面,点击「跨域设置」的「设置」按钮,可进入「跨域设置」界面。
    点击「新增规则」,弹出规则创建框如下:

    • 填写来源:指定允许的跨域请求的来源;对应服务端响应头里的 Access-Control-Allow-Origin 字段
      • 必填
      • 允许多条匹配规则,多条规则需换行填写
      • 每条匹配规则允许使用最多一个*通配符
      • 单独填写*通配符,表示允许所有来源的跨域请求
    • 填写允许Methods:指定允许的跨域请求方法;对应服务端响应头里的 Access-Control-Allow-Methods 字段
      • 必填、多选
    • 填写允许Headers:指定允许的跨域请求的响应头;控制在 OPTIONS 请求中 Access-Control-Request-Headers 头中指定的 Header 是否允许,在 Access-Control-Request-Headers 中指定的每个Header都必须在允许Headers中有一条对应的项;对应服务端响应头里的 Access-Control-Allow-Headers 字段
      • 允许多条匹配规则,多条规则需换行填写
      • 如果有通配符*,则单行只能是通配符*
    • 填写暴露Headers:指定允许用户从应用程序中访问的响应头(例如,一个 Javascript 的 XMLHttpRequest 对象)。对应服务端响应头里的 Access-Control-Expose-Headers 字段
      • 允许多条匹配规则,多条规则需换行填写
      • 不允许使用*通配符。
    • 填写缓存时间:指定浏览器对特定资源的预取(OPTIONS)请求返回结果的缓存时间。对应服务端响应头里 Access-Control-Max-Age 字段
      • 单位:秒

    跨域规则以列表形式展示,支持编辑、单条删除和批量删除

    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close