跳到正文
零到全栈 · 卷 8 · 从作品到产品

安全清单

本合集目录
本章目录

单册说明:本文件是卷 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、路径、状态码、耗时,敏感字段在写入前脱敏。

下一步

安全是"别出事",接下来是"出事也别慌":让每一次改动都有记录、能回滚、能交接。

→ 卷8-05-迭代与协作.md