1.CSP 简介
内容安全策略(Content Security Policy,简称CSP)是一种以可信白名单作机制,来限制网站是否可以包含某些来源内容,缓解广泛的内容注入漏洞,比如 XSS。 简单来说,就是我们能够规定,我们的网站只接受我们指定的请求资源。默认配置下不允许执行内联代码(<script>
块内容,内联事件,内联样式),以及禁止执行eval() , newFunction() , setTimeout([string], …) 和setInterval([string], …) 。
2.CSP 使用方式
CSP可以由两种方式指定: HTTP Header 和 HTML。
通过定义在HTTP header 中使用:
"Content-Security-Policy:" 策略集
通过定义在 HTML meta标签中使用:
策略是指定义 CSP 的语法内容。
如果 HTTP 头 与 meta 标签同时定义了 CSP,则会优先采用 HTTP 头的 。
定义后,凡是不符合 CSP策略的外部资源都会被阻止加载。
3.CSP 语法
3.1 策略
每一条策略都是指令与指令值组成:
Content-Security-Policy:指令1 指令值1
策略与策略之间用分号隔开,例如:
Content-Security-Policy:指令1 指令值1;指令2 指令值2;指令3 指令值3
在一条策略中,如果一个指令中有多个指令值,则指令值之间用空号隔开:
Content-Security-Policy:指令a 指令值a1 指令值a2
3.2 CSP 指令
- default-src : 定义针对所有类型(js/image/css/font/ajax/iframe/多媒体等)资源的默认加载策略,如果某类型资源没有单独定义策略,就使用默认的。
- script-src : 定义针对 JavaScript 的加载策略。
- style-src : 定义针对样式的加载策略。
- img-src : 定义针对图片的加载策略。
- font-src : 定义针对字体的加载策略。
- media-src : 定义针对多媒体的加载策略,例如:音频标签
<audio>
和视频标签<video>
。 - object-src : 定义针对插件的加载策略,例如:
<object>
、<embed>
、<applet>
。 - child-src :定义针对框架的加载策略,例如:
<frame>
,<iframe>
。 - connect-src : 定义针对 Ajax/WebSocket 等请求的加载策略。不允许的情况下,浏览器会模拟一个状态为400的响应。
- sandbox : 定义针对 sandbox 的限制,相当于
<iframe>
的sandbox属性。 - report-uri : 告诉浏览器如果请求的资源不被策略允许时,往哪个地址提交日志信息。
- form-action : 定义针对提交的 form 到特定来源的加载策略。
- referrer : 定义针对 referrer 的加载策略。
- reflected-xss : 定义针对 XSS 过滤器使用策略。
3.3 CSP 指令值
指令值 | 说明 |
---|---|
* | 允许加载任何内容 |
'none' | 不允许加载任何内容 |
'self' | 允许加载相同源的内容 |
www.a.com | 允许加载指定域名的资源 |
*.a.com | 允许加载 a.com 任何子域名的资源 |
允许加载 a.com 的 https 资源 | |
https: | 允许加载 https 资源 |
data: | 允许加载 data: 协议,例如:base64编码的图片 |
'unsafe-inline' | 允许加载 inline 资源,例如style属性、onclick、inline js、inline css等 |
'unsafe-eval' | 允许加载动态 js 代码,例如 eval() |
4.CSP 例子
例子1
所有内容均来自网站的自己的域:
Content-Security-Policy:default-src 'self'
例子2
所有内容都来自网站自己的域,还有其他子域(假如网站的地址是:a.com):
Content-Security-Policy:default-src 'self' *.a.com
例子3
网站接受任意域的图像,指定域(a.com)的音频、视频和多个指定域(a.com、b.com)的脚本
Content-Security-Policy:default-src 'self';img-src *;media-src a.com;script-src a.com b.com
在线 CSP编写的网址:
5.CSP 默认特性
阻止内联代码执行
CSP除了使用白名单机制外,默认配置下阻止内联代码执行是防止内容注入的最大安全保障。
这里的内联代码包括:<script>
块内容,内联事件,内联样式。(1) script代码,
<script>……<scritp>
对于
<script>
块内容是完全不能执行的。例如:(2) 内联事件。
(3) 内联样式
虽然CSP中已经对script-src和style-src提供了使用”unsafe-inline”指令来开启执行内联代码,但为了安全起见还是慎用”unsafe-inline”。
EVAL相关功能被禁用
用户输入字符串,然后经过eval()等函数转义进而被当作脚本去执行。这样的攻击方式比较常见。于是乎CSP默认配置下,eval() , newFunction() , setTimeout([string], …) 和setInterval([string], …)都被禁止运行。
比如:alert(eval("foo.bar.baz"));window.setTimeout("alert('hi')", 10); window.setInterval("alert('hi')", 10); new Function("return foo.bar.baz");
如果想执行可以把字符串转换为内联函数去执行。
alert(foo && foo.bar && foo.bar.baz);window.setTimeout(function() { alert('hi'); }, 10);window.setInterval(function() { alert('hi'); }, 10);function() { return foo && foo.bar && foo.bar.baz };
同样CSP也提供了”unsafe-eval”去开启执行eval()等函数,但强烈不建议去使用”unsafe-eval”这个指令。
6.CSP 分析报告
可以用report-uri指令使浏览器发送HTTP POST请求把攻击报告以JSON格式传送到你指定的地址。接下来给大家介绍你的站点如何配置来接收攻击报告。
启用报告
默认情况下,违规报告不会发送。为了能使用违规报告,你必须使用report-uri指令,并至少提供一个接收地址。
Content-Security-Policy: default-src self; report-uri http://reportcollector.example.com/collector.cgi
如果想让浏览器只汇报报告,不阻止任何内容,可以改用Content-Security-Policy-Report-Only头。
违规报告语法
该报告JSON对象包含以下数据:
blocked-uri:被阻止的违规资源document-uri:拦截违规行为发生的页面original-policy:Content-Security-Policy头策略的所有内容referrer:页面的referrerstatus-code:HTTP响应状态violated-directive:违规的指令
违规报告例子
中CSP 规定只能加载cdn.example.com的CSS样式。
Content-Security-Policy: default-src 'none'; style-src cdn.example.com; report-uri /test/csp-report.php
signup.html中的代码类似与这样:
Sign Up ... Content ...你能从上面的代码找出错误吗?策略是只允许加载cdn.example.com中的CSS样式。但signup.html试图加载自己域的style.css样式。这样违反了策略,浏览器会向 发送POST请求提交报告,发送格式为JSON格式。
{ "csp-report": { "document-uri": "http://example.com/signup.html", "referrer": "", "blocked-uri": "http://example.com/css/style.css", "violated-directive": "style-src cdn.example.com", "original-policy": "default-src 'none'; style-src cdn.example.com; report-uri /_/csp-reports", }}
你从上面可以看到blocked-uri给出了详细的阻断地址 加载CSS样式时,浏览器将不会传送完整的路径,只会给出 这个地址。这样做是为了防止泄漏跨域的敏感信息。
服务端csp-report.php代码可以这样写:
$val) { fwrite($file, $key . ': ' . $val . "");}fwrite($file, 'End of report.' . "");fclose($file);?>