给页面加上 CSP 后,最先坏掉的往往是自己写的按钮。模板里有内联脚本,旧组件依赖 onclick,构建工具还可能在开发模式使用动态求值。团队为了尽快恢复功能,一路加入允许项,最后浏览器虽然收到了安全响应头,真正需要挡住的执行路径却重新打开了。
本文做一个很小的页面:Node.js 输出问候语和确认按钮,用每次响应独立生成的 nonce 标记可信脚本。重点不在于把策略写得很长,而是让响应头、HTML、缓存和验证方式讲同一种规则。读者可以运行完整服务,检查正常输出,再用刻意缺失 nonce 的夹具验证失败路径。
先说明验证范围:下文服务及十五项 HTTP 检查已在 Node.js v24.22.1 上实际运行通过。尝试启动 Chromium 做浏览器验证时,环境因 socket 权限限制未能启动,所以浏览器阻断、控制台报告及点击交互没有获得实测结果。对应步骤会单独标为待验证,不把响应头正确当成浏览器防护已经验收。运行时版本只是本次实验记录,不是生产环境版本推荐;部署前应使用仍受支持且安装安全修复的运行时。
先确定谁有资格获得 nonce
假设这个页面会显示用户填写的昵称。昵称可以是普通文字,也可以包含尖括号和引号。我们希望这些字符被显示出来,而不是变成新的 HTML 元素。输出编码承担第一道责任,CSP 则限制意外出现的脚本能否执行。两道检查针对不同阶段,不应互相替代。Google 的严格 CSP 指南同样将 CSP 定位为纵深防护,而非修复输出注入问题的替代品。严格 CSP 指南
一个常见错误是先生成整页 HTML,再用正则给所有 script 标签补上 nonce。如果页面里混进了不可信标签,这一步相当于替它盖章。正确方向是:只有模板作者明确控制的脚本节点才能取得当前响应的 nonce;用户内容的渲染路径不接触这个值。对于富文本,必须先经过适合 HTML 的净化器,不能沿用本文只用于属性和文本片段的简单转义函数。
nonce 不是用户会话标识,不应该从用户名、时间戳或登录令牌推导。它的生命周期与一次页面响应绑定。W3C 的 CSP Level 3 工作草案要求每次发送策略生成独立值,并建议编码前至少有 128 位、来自密码学安全随机源。本文使用十六个随机字节,编码成 Base64 后同时交给响应头和模板。nonce 安全要求
这里有个值得分清的细节:合法读者可以看到自己的页面及 nonce,它不是藏在服务器里的长期秘密。防护依赖的是攻击者无法提前预测受害者这次响应的值,以及应用不会把可信标记随便送给不可信节点。把它藏进难读的变量名、压缩 HTML 或做一层可逆编码,均无法替代这两个条件。
完整服务:一次生成,两处使用
把下面保存为 server.mjs,不需要安装运行依赖。它只绑定本机地址,用来做隔离实验,不是完整登录系统。probe 和 reportOnly 只接受程序调用参数,不能通过 URL 开启,避免普通请求改变防护模式。
import http from 'node:http';
import { randomBytes } from 'node:crypto';
import { pathToFileURL } from 'node:url';
export const escapeHTML = value => String(value).replace(/[&<>"']/g,
c => ({'&':'&', '<':'<', '>':'>', '"':'"', "'":'''}[c]));
export function createApp({ reportOnly = false, probe = false } = {}) {
return http.createServer((req, res) => {
const url = new URL(req.url, 'http://localhost');
res.setHeader('X-Content-Type-Options', 'nosniff');
if (req.method !== 'GET') { res.writeHead(405, { Allow: 'GET' }); res.end(); return; }
if (url.pathname === '/app.css') {
res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8', 'Cache-Control': 'no-store' });
res.end('body{font-family:system-ui;margin:2rem}'); return;
}
if (url.pathname !== '/') { res.writeHead(404); res.end(); return; }
const name = url.searchParams.get('name') ?? '访客';
if (name.length > 200) { res.writeHead(400); res.end('name too long'); return; }
const nonce = randomBytes(16).toString('base64');
const policy = [
"default-src 'none'", `script-src 'nonce-${nonce}'`,
"script-src-attr 'none'", "style-src 'self'", "connect-src 'self'",
"img-src 'self'", "base-uri 'none'", "object-src 'none'",
"form-action 'self'", "frame-ancestors 'none'"
].join('; ');
res.setHeader(reportOnly ? 'Content-Security-Policy-Report-Only' : 'Content-Security-Policy', policy);
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
res.end(`<!doctype html><html lang="zh-CN"><meta charset="utf-8">
<title>CSP nonce 实验</title><link rel="stylesheet" href="/app.css">
<h1 id="title" data-name="${escapeHTML(name)}">等待脚本</h1>
<button id="ok" type="button">确认</button><output id="result"></output>
<script nonce="${nonce}">
document.querySelector('#title').textContent = '你好,' + document.querySelector('#title').dataset.name;
document.querySelector('#ok').addEventListener('click', () => {
document.querySelector('#result').textContent = '已确认';
});
window.appReady = true;
</script>
${probe ? `<script>window.probeInline = true;</script>
<script nonce="wrong-value">window.probeWrong = true;</script>
<button id="probe" onclick="window.probeAttr=true">测试夹具</button>` : ''}
</html>`);
});
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
createApp().listen(3000, '127.0.0.1', () => console.log('http://127.0.0.1:3000'));
}
启动方式如下。端口被占用时应换一个空闲端口,并同步修改访问地址,不要为了这个实验结束其他服务。
node server.mjs
curl -i 'http://127.0.0.1:3000/?name=Alice'
正常情况下,响应应为 HTML,带有 Content-Security-Policy 和 Cache-Control: no-store。响应头里 'nonce-…' 后面的值必须与本次 HTML 的 script 属性一致;再次请求应得到另一个值。Node 的 randomBytes 提供这里使用的随机字节能力,代码没有拿 Math.random() 充当安全随机源。Node.js crypto 文档
浏览器的预期表现是标题变为问候语,点击确认显示“已确认”。标题使用 textContent,事件使用 addEventListener,不依赖内联事件属性。数据先进入经过编码的 data-name 属性,再由脚本读取,不直接拼接进 JavaScript 源码。这样做也便于审查:模板中的程序和用户提供的数据有清楚的分界。
转义函数的范围必须守住。它适用于本文这个双引号包围的 HTML 属性,不意味着可以拿来生成 SQL、CSS、URL 或脚本字符串。假如以后把昵称改成链接地址,应另做协议和目标验证;改成富文本则需要净化。安全问题经常发生在功能扩展时,因为开发者保留了函数名字,却悄悄换了它所在的语法环境。
为什么这里没有加入 strict-dynamic
这页只有一个已知脚本,不需要运行时加载更多脚本。策略先保持为 nonce-only,更容易解释哪些节点获准执行。样式通过同源样式表读取,连接和图片也分别限制到同源,其他资源默认不放行。这是当前演示的需求清单,不是要求所有网站照搬的通用清单。
如果未来采用拆包加载器,必须确认它怎样创建 script 元素。strict-dynamic 可以让获信任脚本创建的某些动态脚本继续执行,但这也把审查重点移到加载器:若脚本地址来自可操纵的数据,信任可能沿着加载链扩散。W3C 草案明确提醒检查这种动态地址来源。仅为了消除控制台错误就加入它,等于还没调查就扩大授权。动态脚本信任规则
对一个固定页面,我更愿意先列清楚入口脚本,再决定要不要动态信任。对确实依赖模块加载的应用,应使用框架支持的 nonce 传递方式,覆盖服务器输出、流式片段及客户端接管所需脚本,并测试生产构建。开发构建能跑,不代表生产策略正确;反过来,为开发热更新开出的允许项,也不该自动进入生产配置。
如果团队决定使用哈希而非 nonce,那么修改脚本的空白、内容或构建产物后,也要同步更新策略。这种方案更适合内容稳定、希望缓存整页的场景。选择依据应是部署方式和更新路径:动态响应天然能够分配 nonce,静态内容更适合让构建阶段生成固定内容的哈希。两种方案都需要把可信脚本来源交代清楚。nonce 与哈希方案选择
缓存问题比随机数生成更容易漏
这份服务对 HTML 使用 no-store,首先是为了让实验没有缓存歧义,并不代表所有生产页面都必须永久放弃缓存。真正需要决定的是缓存哪一层,以及谁负责生成最终响应。可以缓存不含个人信息的页面数据,再在请求到来时渲染新的 HTML;也可以缓存模板,但在发送前以受控渲染流程填入 nonce。直接缓存含 nonce 的完整页面,再让很多访问共享,违背了每次响应生成新值的设计。
更难排查的情况是响应头和正文来自不同版本。应用服务器输出正文 A,边缘层重新生成响应头 B,两边 nonce 不同,可信脚本就可能全部失效。故障看起来像前端偶发白屏,根因却在缓存与响应组合。上线验收不能只从应用进程旁边 curl,一定要经过用户真实访问的代理和 CDN 路径,再比较同一响应里的头和正文。
不要用“每次只改响应头”的方式给缓存页面刷新 nonce,也不要对压缩后的字节做盲目替换。对流式渲染而言,响应头一旦发出,后续片段只能使用同一份请求上下文中的值。若中途异步组件自行生成另一份随机数,第一页骨架可能正常,晚到的组件却无法执行。请求作用域比全局变量重要:全局 nonce 既容易复用,也容易在并发响应之间串值。
本文的 CSS 也设为不存储,只为缩小演示变量。生产中的版本化静态 CSS、图片和脚本可以设计各自的缓存策略,不需要跟着动态 HTML 一起禁用缓存。应当分别计算数据查询成本、模板渲染成本和网络传输成本,然后决定缓存落点,而不是为了命中率把安全上下文一起冻结。
从只报告到阻断,不能跳过业务验收
把 createApp({ reportOnly: true }) 用在隔离测试实例,就会输出只报告策略。这个模式适合发现不兼容执行路径,但它不负责阻止违规操作。浏览器继续执行不合规代码,并不说明策略没有匹配,可能只是还处于观察模式。两类响应头必须在发布检查里分别核对。CSP 策略投递
观察阶段要覆盖用户真正会走的分支:初次加载、登录后页面、表单错误提示、懒加载组件、支付或客服等第三方入口。只打开首页没有报错,几乎无法说明结账页面也安全可用。若某条违规来自业务必须使用的组件,先确认组件加载方式和所需资源,再做最小范围修改;不要看到一个外部域名就把整个协议或所有子域放进允许列表。
同样,违规数量并不等于漏洞数量。浏览器扩展、旧缓存、历史版本页面都可能产生噪声。较好的排查记录至少包含页面版本、有效指令、阻断资源类别、浏览器版本和复现步骤。报告可能涉及页面 URL 和数据片段,采集时应限制长度、去除查询参数中的私人数据,并控制访问权限。本文没有实现报告收集服务,也没有声称已验证远端上报链路。
正式阻断建议按应用已有的发布体系逐步放量,观察关键操作成功率,而不只看控制台清不清净。回退时恢复上一个已经验证的策略版本,比临时全局加 unsafe-inline 更容易控制风险。如果必须降低防护来恢复关键业务,应记录受影响页面与恢复期限,避免临时例外成为永久配置。这个取舍需要结合业务严重程度,不能靠一条统一命令替团队决定。
已执行的十五项检查与待做的浏览器矩阵
下面测试只用 Node 自带能力,保存成同目录的 http-test.mjs,运行 node http-test.mjs。测试启动临时端口并在结束时关闭,不需要把服务暴露给公网。
import assert from 'node:assert/strict';
import { createApp, escapeHTML } from './server.mjs';
const server = createApp();
await new Promise(r => server.listen(0, '127.0.0.1', r));
const base = `http://127.0.0.1:${server.address().port}`;
let n=0;
const check=(name,fn)=>{fn();console.log('PASS',++n,name)};
try {
const r=await fetch(base); const html=await r.text();
const nonce=html.match(/<script nonce="([^"]+)"/)[1];
const csp=r.headers.get('content-security-policy');
check('200',()=>assert.equal(r.status,200));
check('header matches nonce',()=>assert.ok(csp.includes(`'nonce-${nonce}'`)));
check('128 bits',()=>assert.equal(Buffer.from(nonce,'base64').length,16));
const html2=await (await fetch(base)).text();
check('response nonce changes',()=>assert.notEqual(html2.match(/<script nonce="([^"]+)"/)[1],nonce));
check('no-store',()=>assert.equal(r.headers.get('cache-control'),'no-store'));
check('no weak fallback',()=>assert.ok(!csp.includes('unsafe-inline')&&!csp.includes('unsafe-eval')));
check('base and frame restricted',()=>assert.ok(csp.includes("base-uri 'none'")&&csp.includes("frame-ancestors 'none'")));
check('escape special chars',()=>assert.equal(escapeHTML('&<>"\''),'&<>"''));
const input='\"><script>window.injected=true</script>';
const malicious=await (await fetch(base+'?name='+encodeURIComponent(input))).text();
check('input escaped in HTML',()=>assert.ok(malicious.includes(escapeHTML(input))));
check('one trusted script element',()=>assert.equal((malicious.match(/<script /g)||[]).length,1));
check('no test fixtures in normal app',()=>assert.ok(!html.includes('probeInline')));
const long=await fetch(base+'?name='+'x'.repeat(201));
check('oversize 400',()=>assert.equal(long.status,400));
const post=await fetch(base,{method:'POST'});
check('method 405',()=>assert.equal(post.status,405));
const css=await fetch(base+'/app.css');
check('CSS content type',()=>assert.match(css.headers.get('content-type'),/^text\/css/));
const missing=await fetch(base+'/missing');
check('404',()=>assert.equal(missing.status,404));
console.log(process.version, n+' checks passed');
} finally { await new Promise(r=>server.close(r)); }
此次实际输出为 v24.22.1 15 checks passed。这些断言证明服务生成了匹配的响应头与脚本标记,每次请求生成新值,并且昵称中的危险字符在本文属性上下文被编码。它们还验证了长度限制、方法限制和基本路由。测试只抽取两次 nonce 做差异检查,不是随机数质量统计;随机源的安全性来自所选密码学 API,而不是这两次结果刚好不一样。
更重要的是,HTTP 客户端不会执行 CSP。因此仍要在支持目标范围内的真实浏览器完成以下矩阵:正常脚本与按钮应运行;无 nonce 的 script、错误 nonce 的 script,以及 onclick 属性应在阻断模式下受到限制;切换到只报告模式后,同样的测试片段应继续执行,同时产生相应违规信息。probe: true 正是为这个矩阵插入固定、无外部访问的夹具,不应该部署为面向用户的常规页面。
做浏览器测试时,不要在开发者控制台直接运行一段代码,然后把它当成网页脚本的等价情况。应让测试代码真实出现在服务返回的 HTML 中,检查它是否改变预先约定的标记,并观察 securitypolicyviolation 事件。还应在用户昵称传入含标签字符的字符串,确认页面显示原文、没有新增不可信脚本节点。这能分别覆盖输出编码与执行限制,而不是只验证其中一层。
跨浏览器、代理缓存、流式框架、报告端点以及生产 HTTPS 路径,本次均未完成实测。这个范围说明应当跟测试结果一起保留,不能在发布复盘里只剩一个绿色勾。对于准备迁移现有应用的团队,这份代码提供的是可审查的起点:先把每一个可信脚本如何获得授权说清楚,再验证缓存和构建是否改变了它,最后才把策略推向真实流量。
最后看故障时能否解释
CSP 上线之后,如果用户说“按钮没反应”,排查应能沿着同一条链走下去:这次响应采用哪个策略版本,脚本节点有没有正确标记,头和正文是否一致,是否经过旧缓存,脚本本身有没有运行错误。缺少其中任何一环,团队都容易把所有前端故障归咎于策略,最终选择关闭它。
我会把 nonce 一致性检查放进接口测试,把阻断矩阵放进浏览器回归,把经过 CDN 的最终响应检查放进上线验收。三者各自覆盖不同故障面。本文没有通过增加一长串域名让页面“先跑起来”,而是把这个小页面需要的执行权限定在一个明确入口里。以后每增加一个依赖,都能指出它从哪里进入、谁为它担保、出问题时怎样撤回,这才是策略能够长期维护的基础。
评论
暂无评论。