跳到主要内容
api工厂
安全

CSP 内容安全策略部署:从 Report-Only 到强制模式

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:CSP(内容安全策略)是 XSS 的最后一道闸:就算攻击者把脚本注进了页面,浏览器也会拒绝执行未授权的代码。正确部署姿势是三步走——先用 Content-Security-Policy-Report-Only 收集违规报告,再收敛白名单,最后切换强制模式。直接从零上强制模式的团队,大概率会被内联脚本和第三方统计打爆。

一、CSP 管什么

CSP 通过响应头告诉浏览器「哪些来源的资源可以加载执行」。它不仅能挡 XSS,还能限制表单提交目标、iframe 嵌套与插件加载。常用指令速查:

指令作用建议起点
default-src未单独声明时的默认'self'
script-srcJS 来源'self' 加 nonce
style-srcCSS 来源'self'
img-src图片来源'self' data: https:
connect-srcfetch/XHR/WebSocket'self' 加接口域名
frame-ancestors谁能嵌套我'none'
base-uribase 标签限制'self'

原则是从紧到松:先给最小集合,再按报告逐项放行,而不是一上来就 https: 全放行——那等于没配。

二、第一步:Report-Only 观察

Report-Only 模式只报告不拦截,业务零风险:

text
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self'; report-uri /csp-report; report-to csp-endpoint

服务端加一个接收端点,把浏览器 POST 来的违规报告落库:

js
app.post('/csp-report', (req, res) => {
  const report = req.body;
  logger.warn('csp', report['blocked-uri'], report['violated-directive']);
  res.status(204).end();
});

跑一到两周,按 blocked-uri 聚类:自家域名漏配的补白名单;第三方统计、客服组件按域名加;来路不明的外链重点排查——那可能就是存量 XSS 正在活动。报告里的 document-uri 与 violated-directive 能帮你定位到具体页面与指令,别只看总数。

三、第二步:治理内联脚本

强制模式最大的敌人是内联 script 与 eval。三条路线:

  1. nonce 方案:服务端每次响应生成随机 nonce,内联脚本带 nonce 属性,策略写 script-src 'nonce-随机值'。适合服务端渲染,注意 nonce 必须每次响应都不同且不可预测。
  2. hash 方案:对固定不变的内联脚本计算 SHA-256 摘要写进策略,适合静态站点,脚本一改就要重算。
  3. 严格 CSP 进阶:script-src 'nonce-xxx' 'strict-dynamic',信任由可信脚本动态创建的子脚本,第三方脚本连锁加载的问题迎刃而解,白名单维护成本大幅下降。

unsafe-inline 与 unsafe-eval 能不上就不上;上了这两个,CSP 对 XSS 的防御基本归零。

四、第三步:切强制并留后路

把 Report-Only 头换成 Content-Security-Policy 即进入强制模式。推荐双头模式:强制当前策略的同时,保留一个更严格的 Report-Only 头观察下一轮策略,迭代不伤业务。灰度可按路径或流量比例推进,违规率稳定归零后再全量。切换当天安排人值守,重点盯登录、支付、富文本编辑这三类重交互页面。

五、常见翻车点

  1. 第三方脚本连锁加载:A 域名脚本又拉 B 域名资源,白名单永远追不完,strict-dynamic 可解。
  2. 富文本 CMS:后台编辑器的内联样式与脚本需要单独策略,前后台分域名部署最省心。
  3. data: 图片与 blob: 预览:img-src 记得放行,否则头像上传预览全挂。
  4. 浏览器扩展注入:报告里 chrome-extension 等来源可忽略,别为它放宽策略。
  5. 内联事件属性:onclick 这类写法也会被 CSP 拦截,迁移到 addEventListener 是治本方案。

六、与后端平台的配合

接第三方 SDK 时,CSP 白名单要提前规划。例如纯 HTML 项目引入 api工厂的 apifm.min.js(https://www.apifm.com/apifm.min.js),script-src 需放行 www.apifm.com,connect-src 需放行其接口域名。api工厂(https://www.it120.cc/)的 CMS、用户、订单等接口域名固定,白名单一次配好长期稳定,比散落各处、随时变动的自建接口好治理得多;接口统一返回 {code,data,msg},也便于在 connect-src 收紧后快速回归验证。

七、验收清单

  1. 强制模式下核心页面零违规报告,功能回归通过。
  2. 用测试注入点验证:注入的内联脚本与外链脚本均被拦截。
  3. frame-ancestors 生效,页面无法被第三方 iframe 嵌套。
  4. 上报端点可用,违规报告能按页面与指令聚类查询。
  5. 策略变更走代码评审,禁止临时加 unsafe-inline「先上线再说」。

文章标签

CSP内容安全策略XSS前端安全Report-Only

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。