安全清单
本合集目录
本章目录
单册说明:本文件是卷 8 的第 4 章,可独立阅读。前置:第 3 章(性能与缓存)。本章给出一张十类风险的自查表,每条都落到「读到」的具体位置、验证命令和最小修法,最后附一个可执行的自查脚本。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 8 · 从作品到产品(第 4 / 6 章) |
| 前置章节 | 8.3 性能与缓存 |
| 本章产出 | 一张跑过的安全自查表 + 至少两处真实修复 + Nginx 安全头配置 |
| 对应代码 | scripts/security_check.py(标准库,可直接对线上域名运行) |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 能对十类风险各说出"在哪、怎么验、怎么修",并知道每个安全头的代价 |
8.4.1 一句话结论:假设每个输入都是恶意的,每个 id 都是别人猜的
上线第 3 天,日志里出现一串请求:
GET /api/notes/1 200
GET /api/notes/2 200
GET /api/notes/3 200
(中间连续 54 条,id 逐个加一)
GET /api/notes/57 200
来源是同一个 IP,间隔 200 毫秒。这不是你自己的测试,是有人在遍历 id——如果你的接口只按 id 查、不校验归属,他刚刚把全站用户的摘录读了一遍。
一句话结论:安全不是"上了 HTTPS"就结束,而是"每个入口都假设对方有恶意";最小的动作往往最有效——查询带上 user_id、Cookie 加 SameSite、错误页不回栈。
安全事故的共同点:功能测试全绿。因为功能测试测的是"正常用户能不能用",而攻击者从不按正常路径走。
8.4.2 原理与方法
十类风险:在哪、怎么验、怎么修
| # | 风险 | 在「读到」的哪里 | 怎么验 | 最小修法 |
|---|---|---|---|---|
| 1 | XSS(把脚本注入页面) | 摘录正文渲染、来源网址展示 | 存一条 <img src=x onerror=alert(1)>,看列表是否弹窗 |
不碰 dangerouslySetInnerHTML;必须渲染富文本时先过滤 |
| 2 | SQL 注入 | 搜索、标签筛选 | 搜索框输入 ' OR 1=1 -- |
全部参数化查询,不拼字符串 |
| 3 | 越权(IDOR,改 id 读别人的数据) | GET/DELETE /api/notes/{id} |
两个账号交叉请求对方的 id | 查询带 user_id 或做归属判断 |
| 4 | 弱口令与撞库 | 注册、登录 | 注册 123456;连发 20 次错密码看是否被限 |
最小长度 10、弱口令黑名单、登录限速 |
| 5 | 敏感信息泄漏 | .env、报错页、用户接口 |
curl /.env;故意触发 500 看响应体 |
.gitignore、统一错误响应、字段白名单 |
| 6 | CSRF(借你的登录态发请求) | 所有写操作(POST/DELETE) | 另一个站点用表单跨站提交 | SameSite=Lax + 校验 Origin |
| 7 | 开放重定向 | 登录后的 ?next= 跳转 |
改成 https://evil.test 看是否跳走 |
只允许以单个 / 开头的站内路径 |
| 8 | 目录穿越 | 附件/导出下载 | ?file=../../etc/passwd |
取 basename + 校验解析后的绝对路径前缀 |
| 9 | 依赖漏洞 | requirements.txt、package.json |
pip-audit、npm audit |
升级有漏洞的版本,删掉没用的依赖 |
| 10 | 日志泄漏 | 应用日志、Nginx 访问日志 | grep -i "password|cookie|token" app.log |
只记 user_id 与事件,不记凭据 |
前三条值得单独展开
XSS 的本质是"把用户输入当代码执行"。React 默认会转义 {content},所以「读到」的风险不在普通渲染,而在两个地方:一是为了显示换行或 Markdown 用了 dangerouslySetInnerHTML;二是把 source_url 直接塞进 href,而它是 javascript:alert(1)。
// 危险:任何 HTML 都会被执行
<div dangerouslySetInnerHTML={{ __html: note.content }} />
// 安全:保留换行,不解析 HTML
<div className="whitespace-pre-wrap">{note.content}</div>
来源网址也要校验协议,只允许 http: 和 https:。javascript: 开头的链接点一下就会执行脚本,而它看起来只是一个普通链接。
SQL 注入在用了参数化之后基本绝迹,但有一种写法会把它带回来:
# 错:把用户输入拼进 SQL
sql = f"SELECT * FROM notes WHERE title LIKE '%{q}%'"
# 对:值用占位符,通配符拼在参数里
sql = "SELECT * FROM notes WHERE user_id = ? AND title LIKE ?"
db.execute(sql, (uid, f"%{q}%"))
注意表名、列名不能用占位符(那是结构,不是值),如果确实要动态排序,用白名单映射,不要接收前端传来的字段名。
越权是「读到」最该防的一条,因为它不需要任何技术,改一个数字就行。修法有两种,选一种并保持一致:
# 写法 A:先查再判断归属(能区分 404 和 403)
row = db.execute("SELECT id, user_id FROM notes WHERE id = ?", (note_id,)).fetchone()
if row is None:
raise HTTPException(status_code=404, detail="摘录不存在")
if row["user_id"] != uid:
raise HTTPException(status_code=403, detail="无权访问")
# 写法 B:把归属写进 WHERE(不暴露 id 是否存在)
row = db.execute(
"SELECT id, title FROM notes WHERE id = ? AND user_id = ?", (note_id, uid)
).fetchone()
if row is None:
raise HTTPException(status_code=404, detail="摘录不存在")
「读到」用 A,因为第 2 章的测试断言了 403。关键的从来不是状态码,而是"查询条件里有没有 user_id"——漏了这一条,前端藏得再好也没用。
弱口令与撞库:限制次数比限制复杂度有用
用户会用 123456 和 password,这是事实,靠一句"请设置强密码"改不了。有效的组合是三条:
| 动作 | 具体做法 | 挡住什么 |
|---|---|---|
| 最小长度 | 10 位起,不强制大小写混排 | 挡住最常见的弱口令,同时不逼用户写便利贴 |
| 弱口令名单 | 拒绝 1234567890、password12 这类高频词 |
挡住撞库字典的前几百条 |
| 登录限速 | 按 IP 限制每分钟尝试次数 | 让在线爆破从"每秒十次"变成"每分钟几次" |
限速放在 Nginx 层最省事,也最难绕过:
limit_req_zone $binary_remote_addr zone=login:10m rate=10r/m;
location = /api/auth/login {
limit_req zone=login burst=5 nodelay;
limit_req_status 429;
}
rate=10r/m 是每分钟 10 次,burst=5 允许短时突发 5 次。超过就返回 429,应用层不用写一行代码。
还有一个容易忽略的细节:注册接口返回"邮箱已注册"等于提供了账号枚举接口。「读到」为了可用性保留了这个提示;如果哪天面向陌生人开放,改成"已发送确认邮件"更稳妥。这是可用性与隐私的取舍,知道自己在选什么就行。
依赖与日志:两类慢性的泄漏
依赖漏洞不会立刻爆,但会一直存在。两条命令,加依赖时跑一次,之后每月一次:
python -m pip install pip-audit
pip-audit -r requirements.txt
npm audit --omit=dev
不要为了"零告警"盲目升级大版本——升级前先跑第 2 章的 9 条测试,绿了再合。真正该优先处理的是"有公开利用代码、且在你的调用路径上"的那些,而不是列表里所有的红字。
日志泄漏则是自己写进去的。检查一遍:
grep -inE "password|passwd|cookie|authorization|token" logs/app.log | head
命中并不可怕,可怕的是命中的是明文。日志里应该只有 user_id、路径、状态码、耗时;请求体、Cookie、Authorization 头一律在写入前删掉或打码。
安全头:每个都有代价
安全头是"一行配置换一层防护",但没有一个是免费的。配之前先知道它会打断什么:
| 头 | 作用 | 代价 | 「读到」的建议值 |
|---|---|---|---|
Content-Security-Policy |
限制脚本、样式、图片的来源,XSS 的最后一道闸 | 内联脚本、第三方统计、字体都可能被拦,Next 的内联运行时需要 nonce 或 hash | 先 Report-Only 观察一周,再逐条放行 |
Strict-Transport-Security |
让浏览器以后只走 HTTPS | 不可逆:max-age 期内即使证书坏了也回不去 HTTP |
全站 HTTPS 稳定后,先 max-age=300,再逐步加长 |
X-Content-Type-Options |
禁止浏览器猜 MIME 类型 | 几乎没有;类型写错的文件会拒绝执行(这是好事) | nosniff |
Referrer-Policy |
控制跳转外链时带多少来源信息 | 外站拿不到完整路径(通常正是目的) | strict-origin-when-cross-origin |
X-Frame-Options |
禁止被别的站点用 iframe 嵌入 | 自己的页面也不能被嵌(若有嵌入需求改用 CSP frame-ancestors) |
DENY |
CSP 是最容易被配成事故的一个。default-src 'self' 一把梭上线,Next 的页面很可能直接白屏——控制台一堆 Refused to execute inline script。正确顺序是:先发 Content-Security-Policy-Report-Only,收集一周违规报告,再逐条加白名单,最后切成强制模式。
密钥轮换:不是"出事才做"
需要轮换的东西至少有四类:会话签名密钥、第三方 API Key、邮箱/短信服务凭据、数据库密码(如果用了)。轮换的目标是不停机、不掉数据,所以步骤固定:
| 阶段 | 动作 | 注意 |
|---|---|---|
| 1 | 生成新密钥,与旧密钥并行接受 | 代码要支持"两个都认" |
| 2 | 新签发的会话/请求用新密钥 | 旧的仍能验证 |
| 3 | 观察一个完整周期(至少一个会话有效期) | 看 401 是否异常升高 |
| 4 | 撤销旧密钥 | 这一步之后旧会话全部失效 |
会话密钥轮换会让所有用户掉线,因为旧 Cookie 验不过了。选低峰期做,并在页面上给一句提示。第三方 API Key 轮换则要注意:旧 Key 撤销前,确认没有定时任务还在用它。
8.4.3 动手:跑一遍,修两处
第一步:跑自查脚本
"""上线后最小的安全自查:只看响应头与几个不该公开的路径。"""
import sys
import urllib.error
import urllib.request
TIMEOUT = 8
HEADER_CHECKS = [
("strict-transport-security", "缺 HSTS:首次 http 访问可能被降级"),
("content-security-policy", "缺 CSP:XSS 少了一道闸"),
("x-content-type-options", "缺 nosniff:浏览器可能猜错类型"),
("referrer-policy", "缺 Referrer-Policy:外链会带走完整地址"),
]
BAD_PATHS = ["/.env", "/.git/config", "/api/users"]
def fetch(url: str):
req = urllib.request.Request(url, headers={"User-Agent": "dudao-selfcheck"})
try:
with urllib.request.urlopen(req, timeout=TIMEOUT) as resp:
return resp.status, dict(resp.headers)
except urllib.error.HTTPError as exc:
return exc.code, dict(exc.headers)
except Exception as exc: # 网络不通、证书错误
return None, {"error": str(exc)}
def main(base: str) -> int:
base = base.rstrip("/")
status, headers = fetch(base + "/")
if status is None:
print(f"[失败] 连不上 {base}:{headers['error']}")
return 1
lower = {k.lower(): v for k, v in headers.items()}
fails = 0
for name, hint in HEADER_CHECKS:
if name in lower:
print(f"[通过] {name}: {lower[name][:60]}")
else:
print(f"[失败] {name} 未设置 —— {hint}")
fails += 1
server = lower.get("server", "")
if any(ch.isdigit() for ch in server):
print(f"[警告] Server 头暴露版本:{server} —— 改成 nginx 即可")
else:
print(f"[通过] Server 头未暴露版本:{server or '(空)'}")
for path in BAD_PATHS:
code, _ = fetch(base + path)
if code == 200:
print(f"[失败] {path} 可公开访问 —— 立刻在 Nginx 里 deny")
fails += 1
else:
print(f"[通过] {path} 返回 {code}")
code, _ = fetch(base + "/docs")
if code == 200:
print("[警告] /docs 公开可访问 —— 上线后建议关掉或加访问限制")
print(f"结论:{fails} 项失败")
return 1 if fails else 0
if __name__ == "__main__":
if len(sys.argv) != 2:
print("用法:python scripts/security_check.py https://你的域名")
raise SystemExit(2)
raise SystemExit(main(sys.argv[1]))
python scripts/security_check.py https://dudao.example.com; echo "exit=$?"
输出形如:
[失败] strict-transport-security 未设置 —— 缺 HSTS:首次 http 访问可能被降级
[失败] content-security-policy 未设置 —— 缺 CSP:XSS 少了一道闸
[失败] x-content-type-options 未设置 —— 缺 nosniff:浏览器可能猜错类型
[失败] referrer-policy 未设置 —— 缺 Referrer-Policy:外链会带走完整地址
[通过] Server 头未暴露版本:nginx
[通过] /.env 返回 404
[通过] /.git/config 返回 404
[通过] /api/users 返回 404
[警告] /docs 公开可访问 —— 上线后建议关掉或加访问限制
结论:4 项失败
第一次跑通常是四个头全缺。按第二步补齐后重跑,结论应为 0 项失败。退出码 1 可以直接当发布门禁:失败项没修完,不允许上线。
第二步:加安全头
add_header Strict-Transport-Security "max-age=300" always; # 稳定一周后再改成 31536000
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header X-Frame-Options "DENY" always;
add_header Content-Security-Policy "default-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; script-src 'self'" always;
location ~ /\.(env|git) {
deny all;
return 404;
}
always 不是可选项。不加它,Nginx 只在 2xx/3xx 上添加这些头——而 4xx/5xx 恰恰是攻击者最常触发的响应。很多人配完用首页验证通过,一扫不存在的路径,头全没了。
第三步:修两处真实问题
修复一:给所有"按 id 取数据"的接口补归属判断。 除了 GET /api/notes/{id},还包括 PATCH、DELETE、以及导出、批量打标签这类"看起来不像详情页"的接口。检查方法:
grep -rn "WHERE id = ?" backend/app | grep -v user_id
每一条命中的 SQL 都要问一句:这个 id 是用户传进来的吗?是,就必须带 user_id。
修复二:显式设置 Cookie 属性。
response.set_cookie(
"sid",
token,
httponly=True, # JS 读不到,XSS 偷不走
secure=True, # 只走 HTTPS(本地 http 调试时用环境变量关掉)
samesite="lax", # 跨站 POST 不带 Cookie
max_age=60 * 60 * 24 * 7,
path="/",
)
现代浏览器对未声明 SameSite 的 Cookie 默认按 Lax 处理,但不要依赖默认值:不同浏览器、不同版本的行为不完全一致,显式写出来才是契约。
再补一道写操作的来源校验(成本很低,能挡住绝大多数 CSRF):
from urllib.parse import urlparse
def check_origin(request):
origin = request.headers.get("origin")
if origin and urlparse(origin).netloc != request.headers.get("host"):
raise HTTPException(status_code=403, detail="跨站请求被拒绝")
8.4.4 三个坑
坑 1:add_header 加了,4xx 响应里没有
症状:首页 curl -I 能看到 CSP,随便访问一个不存在的路径,响应头干干净净。
成因:add_header 默认只对 200、201、204、206、301、302、303、304、307、308 生效,4xx/5xx 不在其中。
修法:每一条都加 always。另外注意 add_header 在 location 里会覆盖继承来的所有头,如果某个 location 单独加了一条,要把它需要的头重新写全,或者用 include 抽成公共片段。
坑 2:CSP 一把梭,上线白屏
症状:部署 default-src 'self' 后首页白屏,Console 里十几条 Refused to execute inline script,样式也丢了一半。
成因:页面里有内联脚本(框架运行时、统计代码)和内联样式,全被 CSP 拦了。
修法:先上 Content-Security-Policy-Report-Only,只报告不拦截,观察一周;把真实需要的来源逐条加入白名单;内联脚本改用 nonce 或 hash;最后再切强制模式。CSP 是"调"出来的,不是"抄"出来的。
坑 3:HSTS 在测试域名上开了一年
症状:在 test.你的域名 上加了 max-age=31536000,后来想改回 HTTP 调试,浏览器直接拒绝,清缓存也没用。
成因:HSTS 是浏览器本地策略,一旦记住,在过期前强制 HTTPS,服务器无法撤销。
修法:先在主域名用 max-age=300 试水,确认证书续期、子域全覆盖都没问题,再逐步加到一年。includeSubDomains 更要最后加——它会把所有子域一起锁死。
本章验收
-
security_check.py跑过一遍,失败项都有处理结论 -
/.env、/.git/config返回 404,不是 200 - 所有按 id 取数据的接口都带了
user_id判断(用 grep 验证过) - Cookie 显式设置了
HttpOnly、Secure、SameSite - 四个安全头在 200 和 404 响应里都存在(用
curl -I各验一次) - 能说出 CSP 与 HSTS 各自的代价,以及为什么先 Report-Only / 先短 max-age
自测
Q1:接口返回 403 和返回 404,哪个更安全?
看答案
404 略微更安全,因为它不告诉攻击者"这个 id 真实存在",能减少枚举的信息量。但差别有限:攻击者仍可通过响应时间、列表接口等侧信道推断。真正决定安全的是"查询有没有带 user_id",不是状态码。选一个并在全站保持一致,别一处 403、一处 200。Q2:已经有 HTTPS 了,为什么还需要 HSTS?
看答案
HTTPS 只保证"这次连接是加密的",但用户第一次输入 `http://` 时,请求仍以明文发出,可被中间人劫持后重定向到伪造站点(SSL stripping)。HSTS 告诉浏览器"这个域名以后只准走 HTTPS",把第一次之后的降级路径堵死。它防的是"降级",不是"窃听"。Q3:为什么"日志里记了完整请求体"也算安全事故?
看答案
请求体里常有密码、验证码、Token。日志会被备份、被下载、被同事看到、被日志平台采集,等于把凭据复制到了很多不该有它的地方。一旦某台机器或某个账号被攻破,攻击者不需要再破解密码。正确做法是只记 user_id、路径、状态码、耗时,敏感字段在写入前脱敏。下一步
安全是"别出事",接下来是"出事也别慌":让每一次改动都有记录、能回滚、能交接。