敏感数据保护与安全配置：加密、密钥管理与 HTTP 响应头基线

0. 元信息

• 主题路径：docs/topics/web-security/subtopics/web-security-crypto-and-config/
• 父主题：web-security
• 主分类：安全与可靠性
• 辅助分类：Web 与后端
• 适合对象：后端开发者、运维、平台工程师
• 建议周期：1～1.5 周（每周 6～8 小时）
• 前置知识：network / rest-api-design；理解 HTTP、TLS、数据库
• 最终目标：能为应用部署 KMS/HSM 密钥管理、字段级加密、传输 TLS、日志脱敏；并能让 HTTP 响应头基线（CSP、HSTS、cookie Secure/HttpOnly/SameSite、Referrer-Policy、X-Frame-Options）通过 securityheaders.com A/A+ 评分

1. 学习路线

密码学积木（对称/非对称、AEAD、HKDF）
  → TLS 1.2/1.3 与证书（链、SNI、HSTS）
  → KMS / HSM / Vault
  → 密钥轮换与分层
  → 字段级加密（envelope encryption）
  → 日志脱敏与结构化日志
  → HTTP 响应头基线：CSP、HSTS、cookie、Referrer-Policy、X-Frame-Options
  → Permissions-Policy 与 CORP/COEP
  → 自动化校验：securityheaders.com、Observatory、testssl.sh

2. 阶段周数分配

建议周期 8 周，每周 6 天、每天 1.5～2 小时（每周约 9～12 小时），第 7 天用于复盘和补测：第 1 周基础模型与威胁边界；第 2～3 周核心机制；第 4～5 周防御实现；第 6 周检测、测试与审计；第 7 周综合演练；第 8 周项目收尾、复盘与最终验收。

3. 九阶段表

关键陷阱：HSTS 首次访问前不生效；CSP nonce 需每次请求换；密钥一旦泄漏就要换；HSTS preload 是单向门。

4. 第一周：基础与威胁建模（每天 1.5～2 小时）

5. 阶段通用验收

• 阶段 1 验收：完成概念地图；提交威胁模型；能用 10 分钟解释核心资产、信任边界和主要攻击面。
• 阶段 2 验收：完成核心机制最小实现；提交 3 组正向与负向测试；测试输出包含成功和拒绝结果。
• 阶段 3 验收：完成防御实现；提交配置/代码审计清单；所有高风险输入均经过验证、编码或安全 API。
• 阶段 4 验收：完成检测或安全测试规则；提交日志/扫描/测试输出；能从证据定位触发点和影响范围。
• 阶段 5 验收：完成一次事件或攻击链演练；提交时间线、处置动作和恢复验证；复现者按 README 可独立运行。
• 阶段 6 验收：完成综合项目核心功能；边界测试全通过；README、notes/design.md、notes/test.md、notes/retrospective.md 均存在且非空。
• 阶段 7～8 验收：修复复盘发现的问题；重新执行全部命令；最终报告记录版本、命令和结果。

6. 最终验收

学完后应能完成威胁建模、选择合适的安全机制、实现最小防御链路、编写负面测试、读取日志或扫描证据，并向团队解释安全权衡和残余风险。

量化标准：

• 完成至少 24 道相关练习，其中 12 道基础、8 道中等、4 道综合/高难；每题保留测试或答案证据。
• 独立写出至少 4 个可运行 demo，每个包含成功路径和至少 3 个拒绝/异常测试。
• 完成 1 次 60 分钟攻击—防御演练，能在 15 分钟内讲清威胁模型、核心流程和修复理由。
• 综合项目的自动化检查通过率 100%，高危问题数 0，README 可让他人在 10 分钟内复现。

7. 综合项目

首选项目：安全 Web 服务实验室（本主题对应的 “）。实现一个最小 HTTP/API 服务，故意保留一条可控弱点，再用安全实现和自动化测试修复它。

备选项目：安全审计 CLI。读取请求、配置或依赖清单，输出风险、证据、严重性和修复建议。

必做要求：

• 输入：明确的 JSON/HTTP 请求、配置文件或依赖清单；拒绝缺失字段、超长值、非法编码和越权对象。
• 输出：机器可读 JSON 报告或 API 响应，并包含状态、错误码、证据、修复建议；日志不得泄露密码、令牌或密钥。
• 算法/工具：按 §3 选择标准库安全 API、参数化查询、策略匹配、哈希/签名、规则扫描或事件时间线；在 README 说明选择理由与复杂度/局限。
• 验收标准：成功路径通过；至少 10 个边界/负面测试通过；高风险输入被拒绝；运行静态检查或扫描无新增高危；输出可复现。

项目根目录必须包含 README.md、notes/design.md、notes/test.md、notes/retrospective.md。README 需写需求说明、数据结构/工具选择理由、核心流程、模块化实现、边界测试、编译/运行说明、目录结构和复盘记录；notes/design.md 写威胁模型与流程图，notes/test.md 写每组输入/期望/实际输出，notes/retrospective.md 写用时、难点、收获和下一步。

本主题贡献

• 职责 1（KMS + 字段级 Envelope Encryption）：所有 PII / API key / DB 备份字段走 Envelope encryption——KEK 在 AWS KMS / HashiCorp Vault，DEK 用 AES-256-GCM 加密数据并落库，DEK 可独立轮换（§3 阶段 3~4、§9.6.3）；密钥永不落代码或 .env（呼应 §9.4 #10 与 §10 误区）。
• 职责 2（TLS + HSTS Preload + 安全响应头基线）：TLS 1.3 + Mozilla SSL Configuration Generator “Modern” 等级，证书链 + OCSP Stapling 配齐；HSTS max-age=63072000; includeSubDomains; preload（§3 阶段 2 / 8），提交 hstspreload.org 前评估所有子域；CSP 走 default-src 'self' + nonce + strict-dynamic，先 Content-Security-Policy-Report-Only 收集违规再 enforce（§3 阶段 6、§9.3.5）。
• 职责 3（Cookie + Referrer-Policy + Permissions-Policy + 日志脱敏）：所有 Set-Cookie 强制 Secure; HttpOnly; SameSite=Strict + __Host- 前缀（§3 阶段 7）；Referrer-Policy: strict-origin-when-cross-origin、X-Frame-Options: DENY、Permissions-Policy 显式关 camera/microphone/geolocation；日志用 pino + 字段白名单 + 集中脱敏中间件，grep -E 'token|password|sk-' 命中 0 条（§3 阶段 5）。
• 交付物 1：可运行 demo apps/crypto-lab/ 跑通 “KMS 生成 DEK → AES-GCM 加密 PII → 落库 → KMS 解封 DEK → 解密回读”，含 5 个负面测试（IV 重放、AAD 缺失、KEK 越权、轮换后老 DEK 仍可解、ECB 模式禁止）。
• 交付物 2：infra/nginx.conf 或 Next.js next.config.mjs 完整 CSP / HSTS / Permissions-Policy / Referrer-Policy / COEP-CORP-COOP 基线，README 给出每条头“为什么这么写”。
• 交付物 3：scripts/check-headers.mjs 用 curl -I + cheerio 解析响应头并在 CI 中跑，输出 securityheaders.com 风格的 A/A+ 评分；同脚本校验 Set-Cookie 三属性。
• 交付物 4：notes/test.md 含 testssl.sh --openssl 与 observatory.mozilla.org API 跑通的截图 / JSON，证据可复现。
• 指标 1：securityheaders.com 评分 ≥A（目标 A+），testssl.sh 评 A+；CI 中任一头缺失 / 配置错误即失败。
• 指标 2：HSTS preload 提交后 hstspreload.org 状态为 “Eligible / Pending / Preloaded”，且 includeSubDomains 全覆盖——所有 *.example.com 在 curl -I 中必返回 strict-transport-security 头。
• 指标 3：字段级加密覆盖率 100%——所有标 @pii 注解的字段（邮箱 / 手机号 / 身份证 / 银行卡）落库前必走 envelope encryption，CI 用自定义 ESLint / ast-grep 规则扫“明文 PII 落库”模式，命中即红；密钥轮换周期 ≤365 天，文档化在 notes/retrospective.md。

8. 推荐开源资料

许可证提示：使用 OWASP、ZAP 或其他开源资料与源码前，先打开仓库或页面的 LICENSE/版权说明；默认只引用链接和思路，复制代码时保留版权与许可证文本。

默认使用顺序：先读 §1 与 OWASP 入门资料建立模型 → 用 MDN/规范查 API 和约束 → 在本地项目实现 → 用 ZAP 或对应扫描工具验证 → 到 PortSwigger 做练习 → 将证据和复盘写入 notes/。

9. 学习资料汇聚（v0.3 自包含）

9.1 背景与动机

OWASP Top 10 2021 把”A02 Cryptographic Failures”与”A05 Security Misconfiguration”放在前列。前者关心”数据怎么保护”，后者关心”配置默认值能不能直接上线”。

历史上踩过的坑：

• 2017 Equifax：Apache Struts OGNL 注入 + 未及时打补丁；
• 2018 Tesla AWS 凭证泄露：Kryptowire 研究公开暴露；
• 2019 Facebook 密码明文存储：内部日志可读；
• 2021 Log4j 默认开启 JNDI：默认配置就是漏洞；
• 2022 LastPass 主密码库泄露：加密 vault + 解密密码一起丢；
• 大量网站至今仍缺 CSP / HSTS / cookie Secure。

这些事件把”密钥管理、默认配置、安全响应头”从可选项变成必需品。

9.2 概念地图

flowchart LR
  Crypto[加密与数据保护] --> TLS
  Crypto --> KMS[KMS / HSM / Vault]
  Crypto --> FieldEnc[字段级加密]
  Crypto --> LogMask[日志脱敏]
  TLS --> Cipher[Cipher Suite]
  TLS --> Cert[证书链]
  TLS --> HSTS
  KMS --> Vault[HashiCorp Vault]
  KMS --> AWS[AWS KMS / Secrets Manager]
  KMS --> HSM[Cloud HSM / YubiHSM]
  KMS --> Rotate[密钥轮换]
  FieldEnc --> Envelope[Envelope encryption]
  FieldEnc --> DEK[Data Encryption Key]
  FieldEnc --> KEK[Key Encryption Key]
  LogMask --> Pino[pino]
  LogMask --> Winston[winston]
  LogMask --> SLog[结构化日志]
  Config[安全配置响应头] --> CSP
  Config --> HSTS
  Config --> Cookie[Set-Cookie]
  Config --> Referrer[Referrer-Policy]
  Config --> XFO[X-Frame-Options]
  Config --> PP[Permissions-Policy]
  CSP --> Nonce[nonce]
  CSP --> Hash[sha256]
  CSP --> Report[report-uri / report-to]
  CSP --> FrameAncestors[frame-ancestors]
  Cookie --> Secure
  Cookie --> HttpOnly
  Cookie --> SameSite
  Cookie --> HostPrefix[__Host- 前缀]
  HSTS --> Preload[HSTS preload]
  HSTS --> IncludeSub[includeSubDomains]
  Audit[自动化校验] --> Observatory
  Audit --> SecurityHeaders[securityheaders.com]
  Audit --> TestSSL[testssl.sh]

关系说明：加密与数据保护负责”数据怎么存、怎么传”；安全配置负责”HTTP 层默认放什么”；两者必须同时上，单一边都留空。

9.3 基础知识讲解

9.3.1 经典论文 / 标准

主推：OWASP Secure Headers + Cryptographic Storage + RFC 6797。备查：NIST SP 800-57、W3C CSP Level 3。

9.3.2 经典书籍

主推：Ristić《Bulletproof TLS and PKI》。备查：Ferguson《Cryptography Engineering》、Aumasson《Serious Cryptography》。

9.3.3 优秀博客 / 文档

主推：Mozilla SSL Generator + securityheaders.com + testssl.sh。备查：MDN CSP/HSTS、HSTS preload、Scott Helme。

9.3.4 核心人物

主推：Ivan Ristić、Scott Helme。备查：Niels Provos、Colin Percival。

9.3.5 开发方法

9.4 经典问题与经典案例

9.5 学习难点

概念难点

思维难点

工程难点

9.6 技术标准与接口

9.6.1 Entity

9.6.2 Scope

• CSP：浏览器侧内容源控制；不替代输入校验；不能挡住所有 XSS；
• HSTS：让浏览器强制 HTTPS；不修复证书错误；
• TLS：保护传输层；不隐藏 IP、流量大小、时序；
• KMS / HSM：管理密钥生命周期；不替代业务访问控制；
• 字段级加密：保护存储层；密钥要单独管；
• 日志脱敏：减少日志泄露面；不替代最小权限数据访问。

9.6.3 Structure

必会字段、接口、API：

• CSP 指令：default-src、script-src、style-src、img-src、connect-src、frame-ancestors、base-uri、form-action、report-uri、report-to；
• cookie 属性：Secure; HttpOnly; SameSite=Strict/Lax/None; __Host- 前缀、Domain、Path、Max-Age；
• HTTP 响应头：Strict-Transport-Security、Referrer-Policy、X-Frame-Options、Permissions-Policy、Cross-Origin-Resource-Policy、Cross-Origin-Opener-Policy、Cross-Origin-Embedder-Policy；
• 加密 API：libsodium、cryptography（Python）、crypto（Node）、Go crypto/tls、Java JCE；
• KMS API：AWS KMS / Secrets Manager、GCP KMS、Vault transit；
• 字段级加密：envelope encryption；DEK/KEK；AAD；版本化字段。

9.6.4 Ecosystem

• TLS 库：OpenSSL、BoringSSL、LibreSSL、rustls、Go crypto/tls；
• 密钥管理：HashiCorp Vault、AWS KMS、AWS Secrets Manager、GCP Secret Manager、Azure Key Vault；
• CSP 工具：csp-html-webpack-plugin、csp-evaluator、CSP 生成器；
• 安全扫描：securityheaders.com、Mozilla Observatory、testssl.sh、SSL Labs、Observatory API；
• 结构化日志：pino、winston、logback、structlog；
• 事实标准 vs 标准本身：浏览器 HSTS preload、CSP Level 3 实现差异、SameSite 默认行为（Lax）；这些不是 RFC 但部署时要知道。

9.6.5 Depth Tiers

本计划目标：L3。

9.6.6 Source

• OWASP 仓库：https://github.com/OWASP/
• NIST 仓库：https://csrc.nist.gov/publications
• W3C CSP：https://www.w3.org/TR/CSP3/
• IETF RFC Editor：https://www.rfc-editor.org/
• HSTS Preload：https://hstspreload.org/
• 引用版本快照日期：2026-07-30。

10. 常见误区

• 用 MD5 / SHA1 存密码；
• 字段”加密”用 ECB 模式；
• 自己写 IV / nonce；
• 密钥写在代码或 .env 进 git；
• KMS 密钥权限过宽（* resource）；
• 字段加密但密钥与数据存在同一数据库；
• 不轮换密钥；密钥泄露了也没轮换流程；
• CSP 用 unsafe-inline + unsafe-eval；
• HSTS 启用但没 includeSubDomains；
• cookie 没 __Host- 前缀却写 Domain；
• Referrer-Policy: unsafe-url；
• X-Frame-Options: ALLOW-FROM（已废弃）；
• 以为 HSTS 能阻止首次降级；
• 以为 CSP 能挡住所有 XSS；
• Permissions-Policy 一次性放过所有特性；
• 报告模式（Report-Only）上线即视为完成；
• 部署 HTTPS 但没强制 HTTPS（缺 HSTS / preload）；
• 旧版 TLS 1.0/1.1 仍启用；
• 用 * 通配符 CORS + credentials；
• 在前端 JS 中验证 CSP / 加密（应在后端）。

11. 所有知识点分类（统一规则）

1. 编程语言
2. 数据结构与算法
3. 计算机基础
4. 工程技术
5. Web 与后端
6. 前端与客户端
7. 数据与人工智能
8. 项目与职业能力
9. 安全与可靠性

本计划归属：安全与可靠性 主 + Web 与后端 辅。