docs: 登记安全-02/03 与复习-03 完成,记录安全-01 暂缓决策
This commit is contained in:
+38
-17
@@ -41,7 +41,7 @@
|
||||
| 标记与元信息 | 标记-01 统一标记存储 | P1 | 待决策 | 可挂对象;标记名受控方式;标记值类型;按标记检索;标记名治理与可见性 |
|
||||
| 复习 | 复习-01 复习回路补全 | 待确认 | 待决策(6 项) | Feed 是否含报告;反馈动作形态;覆盖率口径;待归类呈现;遗漏项语义;排序可配置性 |
|
||||
| | 复习-02 Feed 只读无反馈动作 | P1 | 依赖复习-01 | 反馈动作形态(复习-01 第 2 项) |
|
||||
| | 复习-03 Feed 随机取样 | P3 | 待决策 | id 区间随机 / 候选池 / 时间窗口随机 |
|
||||
| | 复习-03 Feed 随机取样 | P3 | 已完成 | — |
|
||||
| | 复习-04 覆盖率查询拉全量 | P3 | 依赖复习-01 | 覆盖率口径(复习-01 第 3 项) |
|
||||
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径(复习-01 第 1 项) |
|
||||
| | 复习-06 学习引导 | P1 | 已确认待实施 | 依赖 AI-02 / AI-03,以及标记-01 的存储设计 |
|
||||
@@ -54,9 +54,9 @@
|
||||
| | 数据-02 统计聚合在内存 | P3 | 已完成 | — |
|
||||
| | 数据-03 编号撞号风险 | P3 | 已完成 | — |
|
||||
| 导出 | 导出-01 无数据导出 | P1 | 已完成 | — |
|
||||
| 安全 | 安全-01 数据库凭证明文 | P4 | 待决策 + 需你执行 | 是否轮换凭证;历史值清理还是视为已泄露 |
|
||||
| | 安全-02 Actuator 鉴权边界 | P4 | 待决策 | 白名单 / 独立端口 + 网络策略(涉 `lpt-infra`) |
|
||||
| | 安全-03 AI 入站无防护 | P4 | 可直接实施 | 内部鉴权方式(共享 token / 仅网络策略) |
|
||||
| 安全 | 安全-01 数据库凭证明文 | P4 | 已暂缓(维护者决定) | 重新评估前提见条目内「当前决策」 |
|
||||
| | 安全-02 Actuator 鉴权边界 | P4 | 已完成 | — |
|
||||
| | 安全-03 AI 入站无防护 | P4 | 已完成 | — |
|
||||
| | 安全-04 生产打印全部 SQL | P4 | 已完成 | — |
|
||||
| 运维与清理 | 运维-01 备份只在同一 PVC | P4 | 待决策 | 异地 / 对象存储目标选型,需你提供目标 |
|
||||
| | 清理-01 死代码与死表 | P4 | 待决策 | 删除 / 保留并在 `lpt-docs` 说明定位 |
|
||||
@@ -292,12 +292,13 @@
|
||||
|
||||
### 复习-03(原 LPT-16)Feed 使用 `ORDER BY RAND()`
|
||||
|
||||
- [ ] 未完成
|
||||
- [x] 已完成
|
||||
- **完成于** `lpt-be` `251a468`
|
||||
- **涉及仓库**:`lpt-be`
|
||||
- **依据**:`ReviewServiceImpl.getReviewFeed()` 与 `getSmartFeed()` 对报告表和碎片表分别使用 `ORDER BY RAND() LIMIT ...`,smart 模式抽样量为 `limit × 5`(上限 500)。
|
||||
- **影响**:MySQL 上属全表随机排序,单次请求两次全表随机。
|
||||
- **建议**:改为 id 区间随机、预生成候选池或「按时间窗口随机 + 按需补充」。
|
||||
- **验收**:Feed 接口不产生全表随机排序(`EXPLAIN` 可验证)。
|
||||
- **已实施**:采样方式改为「**随机起点 + 顺序取窗口**」:先用 `MIN(id)/MAX(id)`(`StudyReportFragmentsMapper.selectIdRange`)取主键区间,在区间内随机选起点,再按 `id ASC` 取够数量;不足时从头回绕补齐,并按主键去重。`random` 与 `smart` 两种模式共用该方法,全仓已无 `ORDER BY RAND()`。
|
||||
- 起点后的 `id >= ? ORDER BY id LIMIT n` 走主键索引,不再有全表随机排序。
|
||||
- 取舍:删除造成的 id 空洞会让靠后的内容被略微偏重。对「偶遇式」的 Feed 可以接受,换来的是稳定的访问路径;若将来需要严格均匀,可改为预生成候选池。
|
||||
- **验收**:Feed 接口不产生全表随机排序(`EXPLAIN` 可验证)。✅ 落库集成测试覆盖取满数量、页内不重复、确实随机(40 轮取样去重后远多于单页容量)、起点落在末尾时的回绕补齐
|
||||
|
||||
### 复习-04(原 LPT-17)取「每任务最近一次回忆覆盖率」时拉取全部回忆记录
|
||||
|
||||
@@ -341,16 +342,28 @@
|
||||
|
||||
### 安全-01(原 LPT-21)数据库凭证明文入库
|
||||
|
||||
- [ ] 未完成
|
||||
- [ ] 未完成(**维护者决定暂缓,见下方「当前决策」**)
|
||||
- **涉及仓库**:`lpt-be` + `lpt-infra`
|
||||
- **依据**:`application-prod.yml`、`application-dev.yml`、`application-local.yml` 均包含明文数据库账号密码(三个环境同一份)。`lpt-infra` 已通过 `lpt-secrets` 注入 `SPRING_DATASOURCE_PASSWORD` 覆盖,但配置文件仍在 Git 历史中。
|
||||
- **建议**:轮换凭证 → 配置文件只保留占位符/环境变量引用 → 清理历史(或至少视为已泄露处理)。
|
||||
- **验收**:仓库中不再出现明文凭证;本地开发通过环境变量或本地未跟踪配置提供。
|
||||
- **注意**:**不要把任何密码值复制进本文档。**
|
||||
- **2026-10-09 核查补充**(供重新评估时使用,均不含凭证值本身):
|
||||
- 三个环境的 username 与 password 完全相同,且 username 是 `root`(即三环境共用一个 root 账号,爆炸半径为「全库 + 全环境」)。
|
||||
- `application-local.yml` 指向一个公网 MySQL,实测该端口 TCP 可达;这一份**没有 k8s env 覆盖**(本地开发无集群),是「活的」可能性最高的一份。
|
||||
- `application-prod.yml` / `application-dev.yml` 的值在集群内被 `lpt-secrets` 覆盖,可能只是死值;需用一条 `kubectl get secret` 核实是否与文件值相同。
|
||||
- `lpt-infra` 把 MySQL 暴露为 `NodePort`(dev 30306 / prod 30307),这条与「凭证是否泄露」无关,是独立的暴露面。
|
||||
- `lpt-infra` 全仓无 `NetworkPolicy`。
|
||||
- **当前决策(2026-10-09,维护者)**:**暂缓**。项目处于开发阶段,认为该风险可接受;不同环境使用不同密码会给开发带来不必要的精力消耗。
|
||||
- 重新评估的前提:进入对外发布/多人协作阶段,或 `lpt-secrets` 的值与仓库中的值相同(后者意味着公开在 Git 里的就是生产口令)。
|
||||
- 若重新开工,建议顺序:**先轮换凭证**(使历史值作废)→ 再改配置占位符 → 「清 Git 历史」收益很低,可只做整洁性处理(改写历史会让所有已有克隆失效,且已外流的副本不受影响)。
|
||||
|
||||
### 安全-02(原 LPT-22)Actuator 端点鉴权边界未固定
|
||||
|
||||
- [ ] 未完成
|
||||
- [x] 已完成
|
||||
- **完成于** `lpt-be` `251a468`
|
||||
- **已实施**:把暴露清单显式固定为 `health,info`,并写明「`/actuator/**` 不受 `SaInterceptor` 约束,这里是唯一的口子,临时排查请用 local profile 覆盖而不是改这里」。
|
||||
- **方案取舍**:清单给的两个选项里选了「显式固定白名单」,因为集群内没有任何 `NetworkPolicy`(已核实),「独立端口 + 网络策略」当前没有可依赖的基础设施。
|
||||
- **涉及仓库**:`lpt-be`
|
||||
- **依据**:线上只读探测确认 `/api/actuator/health`、`/api/actuator/info` 未登录返回 200,而 `/api/actuator/env` 与业务接口返回 401(已注册的 actuator 端点不受 `SaInterceptor` 约束)。
|
||||
- **影响**:当前探针正常,但一旦放开 metrics/prometheus 等端点,会连带公开。
|
||||
@@ -359,11 +372,19 @@
|
||||
|
||||
### 安全-03(原 LPT-23)`lpt-ai` 缺少入站防护(SSRF 与滥用)
|
||||
|
||||
- [ ] 未完成
|
||||
- **涉及仓库**:`lpt-ai`
|
||||
- **依据**:`POST /fetch-title` 由服务端抓取用户可控 URL(可探测内网/云元数据地址);`/ai/tasks` 与 `/admin` 无鉴权、无速率限制、无请求体上限;`admin/store.ts` 把完整 prompt 与学习内容明文写入 `data/logs.json`。
|
||||
- **建议**:抓取改为白名单/内网地址黑名单 + 协议与重定向校验;入站加鉴权与限流;`/admin` 加访问控制;日志中学习内容按需脱敏或缩短保留期。
|
||||
- **验收**:`/fetch-title` 无法访问内网与元数据地址;未授权请求无法提交 AI 任务。
|
||||
- [x] 已完成
|
||||
- **完成于** `lpt-ai` `f091fe6`、`1c31682`,`lpt-be` `251a468`、`bad7d6b`,`lpt-infra` `9160dd1`
|
||||
- **已实施**:
|
||||
1. **抓取四层校验**(`utils/ssrf-guard.ts`):协议白名单 → 端口白名单(默认只允许 80/443,避免被用来探测内网 Redis/MySQL)→ **DNS 解析后逐个校验每一个解析结果**(防解析到内网与 DNS rebinding)→ **重定向逐跳重新校验**(防「首跳合法、次跳内网」);响应体截断到 512 KiB 且只接受网页类型。
|
||||
覆盖 IPv4 私网/回环/链路本地(含云元数据 169.254.169.254)/CGNAT/组播/保留段,以及 IPv6 回环、ULA、链路本地、组播,并识别 IPv4-mapped 与 NAT64 里内嵌的 IPv4。
|
||||
2. **入站令牌(可选)**:`LPT_AI_TOKEN` 设置后 `/ai/*` 与 `/admin` 都要求携带(header `x-api-token` 或 query `token`);`lpt-be` 侧由 `lpt.ai-service.token` 提供。部署清单用 `secretKeyRef.optional: true` 引用 `lpt-secrets/lpt-ai-token`,**没设这个 key 也能启动**(此时不校验)。
|
||||
3. **限流**:`/ai/tasks` 按来源限流(默认 30 次/分钟,`LPT_AI_RATE_LIMIT`)。
|
||||
4. **请求体上限**:`LPT_AI_BODY_LIMIT_BYTES`,默认 256 KiB。
|
||||
- **两条实现取舍(与维护者确认过)**:
|
||||
- 令牌**默认不启用**:维护者明确表示开发阶段不想为额外凭据付出精力。因此实现为「一条环境变量即可收紧」,并保证未启用时启动告警 + Pod 正常启动。
|
||||
- **不做日志脱敏**:`admin/store.ts` 已按条数限制保留(`MAX_ENTRIES=200`),而按内容脱敏会削弱 `/admin` 面板的排查能力;本项不在验收标准内,留待后续隐私专项。
|
||||
- **顺带发现**:`POST /fetch-title` **全工作区零调用**(`lpt-fe` 走的是 `lpt-be` 的 `/utils/fetch-title`,用 Java 侧 `TitleFetcher`)。保留是为满足本条目验收;如需精简可连同抓取工具一并删除,列入 清理-01 候选。
|
||||
- **验收**:`/fetch-title` 无法访问内网与元数据地址;未授权请求无法提交 AI 任务。✅ 已用单测覆盖内网/回环/元数据/IPv4-mapped/NAT64/端口/协议/域名解析到回环等绕过路径,以及令牌校验的放行与拒绝分支
|
||||
|
||||
### 安全-04(原 LPT-24)生产环境打印全部 SQL
|
||||
|
||||
@@ -403,7 +424,7 @@
|
||||
3. **复习**:先落复习-01 的六项结论(口径与内容边界),复习-07(复习耗时)已独立完成;再做复习-02 / 复习-03 / 复习-04 / 复习-05;复习-06(学习引导)依赖 AI-02 / AI-03 与标记-01,排在 AI 链路之后。
|
||||
4. **AI 链路**:AI-01 / AI-02 / AI-03 / AI-04 均已完成。本模块已收口。
|
||||
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成。本模块已收口。
|
||||
6. **安全与运维清理**:安全-01 ~ 安全-04、运维-01、清理-01,彼此独立,可并行推进。
|
||||
6. **安全与运维清理**:安全-02 / 安全-03 / 安全-04 已完成;安全-01 由维护者决定暂缓(见条目内「当前决策」);剩运维-01(需外部存储目标)与清理-01(需确认是否删除)。
|
||||
7. **学习录音(已暂停)**:模块整体挂起,重启前先定 §12「路线分叉」(依赖 OBS / 自研原生)。
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user