承 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>
176 lines
11 KiB
Markdown
176 lines
11 KiB
Markdown
# 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 新坑)
|