Skip to content

Content Security Policy

CSP 是什么?

  • Content Security Polic (CSP) 的实质就是白名单制度,开发者明确告诉客户端,哪些外部资源可以加载和执行,等同于提供白名单。它的实现和执行全部由浏览器完成,开发者只需提供配置

CSP 解决了什么问题?

  • 跨域脚本攻击 XSS 是最常见、危害最大的网页安全漏洞,了防止它们,要采取很多编程措施,非常麻烦。很多人提出,能不能根本上解决问题,浏览器自动禁止外部注入恶意脚本,这就是"网页安全政策"的来历

CSP 如何启用?

  • 通过 HTTP 头信息的 Content-Security-Policy 的字段
http
Content-Security-Policy: script-src 'self'; object-src 'none';style-src cdn.example.org third-party.org; child-src https:
  • 通过网页的<meta>标签
html
<meta
  http-equiv="Content-Security-Policy"
  content="script-src 'self'; object-src 'none'; style-src cdn.example.org third-party.org; child-src https:"
/>

上述配置解释

  • 脚本:只信任当前域名
  • <object>标签:不信任任何 URL,即不加载任何资源
  • 样式表:只信任 cdn.example.org 和 third-party.org
  • 框架(frame):必须使用 HTTPS 协议加载
  • 其他资源:没有限制

CSP 如何配置?

资源加载限制配置

指令描述
script-src外部脚本
style-src样式表
img-src图像
media-src媒体文件(音频和视频)
font-src字体文件
object-src插件(比如 Flash)
child-src框架
frame-ancestors嵌入的外部资源(比如<frame><iframe><embed><applet>
connect-srcHTTP 连接(通过 XHR、WebSockets、EventSource 等)
worker-srcworker 脚本
manifest-srcmanifest 文件

default-src

  • default-src 用来设置上面各个选项的默认值

URL 限制

  • 网页会跟其他 URL 发生联系,这时也可以加以限制

    指令描述
    frame-ancestors限制嵌入框架的网页
    base-uri限制<base#href>
    form-action限制<form#action>

其他限制

指令描述
block-all-mixed-contentHTTPS 网页不得加载 HTTP 资源(浏览器已经默认开启)
upgrade-insecure-requests自动将网页上所有加载外部资源的 HTTP 链接换成 HTTPS 协议
plugin-types限制可以使用的插件格式
sandbox浏览器行为的限制,比如不能有弹出窗口等

report-uri

  • report-uri 就用来告诉浏览器,应该把注入行为报告给哪个网址

CSP 如何配置选项值?

每个限制选项可以设置以下几种值,这些值就构成了白名单

指令描述
主机名example.org, https://example.com:443
路径名example.org/resources/js/
通配符.example.org, 😕/.example.com:
协议名https:, data:
关键字'self''self'
关键字'none''none'

多个值也可以并列,用空格分隔

http
Content-Security-Policy: script-src 'self' https://apis.google.com

script-src 的特殊值

指令描述
'unsafe-inline'允许执行页面内嵌的<script>标签和事件监听函数
'unsafe-eval'允许将字符串当作代码执行,比如使用 eval、setTimeout、setInterval 和 Function 等函数。
nonce 值每次 HTTP 回应给出一个授权 token,页面内嵌脚本必须有这个 token,才会执行
hash 值列出允许执行的脚本代码的 Hash 值,页面内嵌脚本的哈希值只有吻合的情况下,才能执行。

注意事项

  • script-src 和 object-src 是必设的,除非设置了 default-src

    因为攻击者只要能注入脚本,其他限制都可以规避。而 object-src 必设是因为 Flash 里面可以执行外部脚本

  • script-src 不能使用 unsafe-inline 关键字(除非伴随一个 nonce 值),也不能允许设置 data:URL

    html
    <!-- 两个恶意攻击的例子 -->
    <img src="x" onerror="evil()" />
    <script src="data:text/javascript,evil()"></script>
  • 必须特别注意 JSONP 的回调函数

    html
    <!-- 加载的脚本来自当前域名,但是通过改写回调函数,攻击者依然可以执行恶意代码 -->
    <script src="/path/jsonp?callback=alert(document.domain)//"></script>

拓展:Content-Security-Policy-Report-Only

  • 除了 Content-Security-Policy,还有一个 Content-Security-Policy-Report-Only 字段,表示不执行限制选项,只是记录违反限制的行为。它必须与 report-uri 选项配合使用
http
Content-Security-Policy-Report-Only: default-src 'self'; ...; report-uri /my_amazing_csp_report_parser;

参考文献

Released under the MIT License.