Files
eip4-platform/platform-legacy-core/P2-LIKE注入修复报告.md
zhengwr b9ad18f147 P2-LIKE: 保真层 GeneralPO 值位置单引号转义堵 LIKE 搜索注入
承 P4-4 §坑8.8 + 架构 §四安全第 2 层 LIKE 路径项。GeneralPO 对 String
搜索值裸拼 col like '%值%'(GeneralPO.java:1940)及同形态 5 处(Object 等值
1982/IN 1978/全表模糊 ilike 2075/like 2145/2173)无参数绑定 → 单引号闭合
字面量注入。

修复(保真层最小改动,严格口径):
- StringUtil 新增 escapeSqlLiteral:只把 ' 双写为 ''(SQL 标准转义堵注入)、
  绝不转义通配符 % _(旧系统通配语义保真)、不补外层引号(拼接形态零变化)
- GeneralPO 6 处用户可控值位置各包一层 escapeSqlLiteral,SQL 结构一字未改
- m_IDs(主键)/get_TableName()(标识符,白名单守)非值位置,不在本次范围
- 真参数化(PreparedStatement ?)列 P2 后续热点项,本次只堵值转义注入面

验证:单测 7/7;mvn install 10 模块 + ArchUnit 绿;ParityCli --all 21 实体
全一致 + --privilege 9 正/3 负全过;REST 8091 实测注入负例 200 空结果
不注入不报错(表未被 DROP),a%b/纯 % 仍通配。详见 P2-LIKE注入修复报告.md
+ 迁移手册 §8.10。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 17:26:05 +08:00

176 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# P2-LIKE 注入修复报告:保真层 GeneralPO 值位置单引号转义
> 日期:2026-06-11 | 工作线:platform-legacy-core 保真层
> 工程:eip4-platform/platform-legacy-core(JDK17)
> 来源:P4-4 picker 衔接报告 §坑8.8 定位的注入点;架构设计 §四「安全四层」第 2 层「渐进参数化」的 LIKE 路径项
> 数据源:本地 M0 PG `localhost:5433`;对拍专用库 `eip4like`(本次重建,幂等自举);服务端口 **8091**(验证后已 kill)
---
## 一、一句话结论
保真层 SQL 引擎 `GeneralPO` 的 String 搜索值裸拼 LIKE 注入点(`col like '%值%'`)及同形态 5 处值位置裸拼,统一过 `StringUtil.escapeSqlLiteral`(**只把 `'` 双写为 `''`,绝不转义通配符 `%`/`_`**)。对合法值(含中文/空格/含 `%` 的通配搜索)逐字节零行为变化,注入载荷被降级为字面量。单测 7/7,全模块 `mvn install` + ArchUnit 绿,ParityCli `--all`(21 实体)+ `--privilege`(9 正例/3 负例)全一致,REST 实测注入负例返回 200 空结果(不注入、不报错、表未被 DROP)。
**真参数化(PreparedStatement `?` 占位)作为 P2 后续热点项保留**——本次范围仅为保真层最小改动「值转义堵注入面」,不改引擎拼接形态。
---
## 二、注入点清单(全文件 grep 同类裸拼点登记)
文件:`platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java`
| 行 | 拼接形态 | 值来源 | 用户可控 | 本次处置 |
|----|---------|--------|---------|---------|
| **1940** | `col + " like '%" + obj.toString().trim() + "%'"` | String 列搜索值(`map.get(列名)`) | ✅ | **修(P4-4 热点)** |
| 1982 | `col + " = '" + obj.toString() + "'"` | Object.class 列等值搜索值 | ✅ | **修(同形态明显点)** |
| 1978 | `"'" + subId + "'"`(IN 列表元素) | Object.class 列 List 搜索值 | ✅ | **修(同形态明显点)** |
| 2075 | `" ilike '%" + fuzzyCondition + "%' "` | 全表模糊查询条件(`FUZZY_QUERY`) | ✅ | **修(同形态 LIKE 点)** |
| 2145 | `combidentifierCol + " like '%" + fuzzyCondition + "%' "` | 同上(多实体组合标识列) | ✅ | **修(同形态 LIKE 点)** |
| 2173 | `displayColumnName + " like '%" + fuzzyCondition + "%' "` | 同上(关联实体显示列) | ✅ | **修(同形态 LIKE 点)** |
| 1778 | `"'" + m_IDs[i] + "'"` | 记录主键 `m_IDs`(引擎内部置入,非搜索入参) | ❌ 非用户搜索值 | 不在本次范围 |
| 1849/1858 | `TABLENAME = '" + get_TableName() + "'"` | 表名(元数据标识符,非值) | ❌ 标识符(白名单守,§安全第 1 层) | 不在本次范围 |
| 2106 | 已注释死代码 | — | — | 无 |
> 处置口径:本次只修「用户可控的**值位置**裸拼」。`m_IDs`(主键由引擎流程内部置入)与 `get_TableName()`(标识符,由现代层 `IdentifierWhitelist` 元数据白名单守,属安全第 1 层职责)不属本次「值转义」范围,登记备查。
---
## 三、修复方式(严格遵守口径)
### 3.1 新增最小转义工具(复用既有单引号转义语义)
`StringUtil` 已有 `TO_STRING(txt, maxLen)`:单引号双写 + **补外层 `'...'`**。LIKE 点需要值落在 `'%...%'` 内、通配符 `%` 须在引号外,因此不能直接用 `TO_STRING`(会多补一层引号、破坏拼接形态)。新增同语义但**不补外层引号**的方法(复用同一个 `QUOTE` 常量与 `''` 双写逻辑):
```java
public static String escapeSqlLiteral(String txt) {
if (txt == null) return null;
if (txt.indexOf(QUOTE) < 0) return txt; // 无单引号原样返回(合法值零分配)
StringBuilder out = new StringBuilder(txt.length() + 4);
for (int i = 0; i < txt.length(); i++) {
char c = txt.charAt(i);
if (c == QUOTE) out.append("''"); // ' → ''(SQL 标准转义)
else out.append(c); // % _ 及其余字符原样(保留通配语义)
}
return out.toString();
}
```
- **只转义单引号**(`'`→`''`):闭合引擎拼接的字符串字面量,堵注入。
- **绝不转义 `%` 和 `_`**:旧系统把搜索值里的 `%`/`_` 当通配符是既有行为;转义=改语义=破保真。保持通配语义原样。
- 不补外层引号:调用方原有 `'%` / `%'` / `= '` / `IN ('` 拼接形态零变化,diff 最小。
### 3.2 6 处调用点改造(拼接形态不变,仅值过转义)
```java
// 1940 String LIKE(P4-4 热点)
sb.append(columnName + " like '%" + StringUtil.escapeSqlLiteral(obj.toString().trim()) + "%'");
// 1982 Object 等值
sb.append(columnName + " = '" + StringUtil.escapeSqlLiteral(obj.toString()) + "'");
// 1978 Object IN 元素
sb.append("'").append(StringUtil.escapeSqlLiteral(subId)).append("'");
// 2075 ilike 模糊 / 2145 combidentifier like 模糊 / 2173 displayColumn like 模糊
... .append(" [i]like '%").append(StringUtil.escapeSqlLiteral(fuzzyCondition)).append("%' ");
```
### 3.3 保真层改动纪律登记
- 改 `com.dsasp.*`(保真层),与 framework 源码 diff 控制到最小:`StringUtil` +32 行(1 个静态方法),`GeneralPO` 仅 6 处值位置各包一层 `escapeSqlLiteral(...)`,拼接结构与原 SQL 字符串形态一字未改。
- 不改 `PreparedStatement` 参数化(更大引擎改造)——真参数化列 **P2 后续热点项**(见 §六)。
- ArchUnit「保真层禁依赖现代层」不受影响(改动全在 `com.dsasp` 内,复用本包 `StringUtil`)。
---
## 四、验证(过对拍——纪律)
### 4.1 单测(`StringUtilEscapeSqlLiteralTest`,7/7 通过)
| 用例 | 断言 |
|------|------|
| 单引号双写 | `'`→`''`、`a'b`→`a''b`、`' OR '1'='1`→`'' OR ''1''=''1`、`'; DROP TABLE x--`→`''; DROP TABLE x--` |
| 通配符不动 | `a%b`/`a_b`/`%`/`_`/`100%_done`/`a\b` 原样返回;`a'%b_c`→`a''%b_c`(只双写引号,`% _` 留) |
| 正常值不变 | `张三`/`hello world`/`项目 A-2026`/中文+空格 逐字节不变;无引号值返回入参本身 |
| null | 返回 `null` |
| 拼接形态产物 | `P.NAME like '%'' OR ''1''=''1%'`(注入降级)、`P.NAME like '%a%b%'`(`%` 仍通配)、`P.ID = 'x''; DROP--'`、`IN` 元素转义 |
### 4.2 对拍(本地 8091 + eip4like 库)
**行为保真 + 通配(REST `GET /api/entity/EIP4PT_CUSTOMER/list?NAME2=值`,String 列 NAME2 走引擎 `col like '%值%'` 路径)**
种子库灌入 3 条标定行:`NAME2='a%b'`(含字面 %)、`NAME2="O'Brien 中文"`(含单引号)、`NAME2='张三 项目'`(普通中文+空格)。
| 用例 | 结果 |
|------|------|
| `NAME2=张三`(中文) | HTTP 200 total=1,命中「张三 项目」 |
| `NAME2='张三 项目'`(中文+空格) | HTTP 200 total=1,命中 |
| `NAME2=a%b`(**含 % 字面通配保真**) | HTTP 200 total=1,命中「a%b」(% 仍按通配匹配) |
| `NAME2=%`(**纯通配验证**) | HTTP 200 total=3(匹配全部非空 NAME2,证 % 是通配符**而非**被转义为字面量) |
| `NAME2=O'Brien`(**含单引号字面**) | HTTP 200 total=1,命中「O'Brien 中文」(转义后字面匹配,不报错) |
**注入负例(REST 实测留证)**
| 载荷 | 结果 |
|------|------|
| `NAME2=' OR '1'='1` | HTTP 200 total=0(不返回全表,转义后字面查 0 行) |
| `NAME2='; DROP TABLE x--` | HTTP 200 total=0;**表未被 DROP**(eip4pt_customer 仍 53 行) |
| `NAME2=x' UNION SELECT * FROM sys_usergroup--` | HTTP 200 total=0(UNION 被降级为字面量) |
| picker `?q=' OR 1=1--` | HTTP 200 `total:0`(status:0,干净) |
**引擎实拼 SQL 留证**(app DEBUG 日志,证单引号被双写、载荷整体落在字面量内未闭合):
```
SELECT COUNT(*) AS COU FROM (SELECT P.EIP4PT_CUSTOMER_ID FROM EIP4PT_CUSTOMER AS P
WHERE 1=1 AND P.NAME2 like '%''; DROP TABLE x--%') AS TEMPTABLE
```
`'; DROP TABLE x--` 的 `'` 被双写为 `''`,整条 payload 留在 `'%...%'` 字面量内,无语句中断、无 DROP 执行。app 日志无任何 `PSQLException`/`syntax error`。
**回归对拍**
| 套件 | 结果 |
|------|------|
| ParityCli `--all`(本地 21 实体全量列表对拍) | 21/21 一致率=1.0000 OK,实体级一致率 1.0000 |
| ParityCli `--privilege`(C2 行级权限) | 正例 9/9 全一致,负例 3/3 被拒(错误角色 → REJECTED),✅ 全部通过 |
| `mvn -T1C clean install`(10 模块全量编译+单测+ArchUnit) | BUILD SUCCESS(含 ArchitectureRulesTest 1/1:保真层禁依赖现代层) |
### 4.3 全模块 BUILD SUCCESS
```
platform-legacy-core / platform-converter / platform-metadata / platform-auth /
platform-flow-gateway / platform-ai / platform-parity / platform-app / flowable-service
全 SUCCESS;ArchitectureRulesTest Tests run: 1, Failures: 0
新增 StringUtilEscapeSqlLiteralTest Tests run: 7, Failures: 0
```
---
## 五、与 picker 端 `escapeLikeValue` 的口径区别(重要)
P4-4 metadata 层 `PickerController.escapeLikeValue`(手册 §8.8)对 `q` **剔除** `%`/`_`/`\`(防通配符逃逸,现代层 picker 把搜索框定义为「不可作通配」优先保安全)。本次保真层 `escapeSqlLiteral` **保留** `%`/`_`(保真层职责是「行为对合法值零变化」,旧系统通配语义不能动)。两者是**不同层、不同语义**:
- 现代层 picker `q`:业务定义为模糊关键字,转义器主动剔通配符(产品决策)。
- 保真层引擎 LIKE sink:必须保通配语义(保真硬约束)。
二者最终都汇到本次修的同一引擎 sink;本次修复让该 sink 对**任何**进来的值都堵单引号注入(picker 已先剔通配再进来,entity filter 等其它入口的值则保通配进来),双管不冲突。
---
## 六、真参数化后续项(P2 热点,本次未做)
本次为保真层**最小改动**:只在值位置加单引号转义堵注入面,保持字符串拼接形态。架构设计 §四第 2 层「渐进参数化」、§五「计划缓存抖动(头号性能税)」的根子级修复——把热点路径值位置改 `?` 占位(PreparedStatement)——是更大的引擎改造,**列 P2 后续热点项**:
- 优先级 = C3 压测热点 ∩ 安全风险点(架构 §五「关键协同」)。
- 一次参数化同时还安全(结构稳定不可注入)+ 性能(PG 计划缓存可复用)两笔债。
- 改造时仍须「每改一处过对拍」(本报告的对拍套件可直接复用)。
在此之前,本次的单引号转义是**可回归的注入兜底**(对拍负例守着不退化),等价于把架构 §四第 4 层「检测兜底」的注入负例从一次性人工保证变成 ParityCli/单测断言。
---
## 七、git 提交(只 add 本线自有文件)
- `platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java`(+`escapeSqlLiteral` 静态方法)
- `platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java`(6 处值位置过转义)
- `platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java`(新增单测)
- `platform-legacy-core/P2-LIKE注入修复报告.md`(本报告)
- `docs/迁移手册.md`(§8.10 新坑)