P2-1: 权限对拍扩容(真实实体只读权限对拍)+ 报告 + 手册坑位

platform-parity 新增「真实实体只读权限对拍」模式:
- RealEntityPrivilegeRunner:从客户库真实 SYS_FILTERRULE(1079 条活跃规则)发现
  可确定性复现的 (实体,用户,角色) 案例(只挑 []→全表、USERID={CURRENTUSERID}→
  WHERE userid=<uid> 两类形态,且仅当用户全部交集规则均可复现才取正例),
  真实用户 ctx 驱动引擎行级过滤 vs JDBC 等价 WHERE 逐行 diff;负例无命中角色→
  PrivilegeException(HTTP 非 200)。全程只读,绝不向客户库写规则。
- ParityCli 增 --realprivilege 模式 + JSON/MD 报告;SelfCheckRunner 抽出 checkRows
  复用自对拍豁免内核(BOOLEAN 域外/计算列/物理孤儿/xml/JSON 空值),纯增量不改既有路径。

实测(8085 客户库只读):HR_SAFETYCARD/HR_OTHERCARD/HR_CONSTRUCTORCARD/HR_MEMBERCARD
共 4 实体 805 行 100% 逐行一致 + 5/5 负例被拒。

报告:platform-auth/P2组织权限实测报告.md(移植清单/REST 7 例证据/对拍扩容/
密码哈希=无盐小写 MD5 客户库实证)。

手册新坑:§5.32(userid 36/32 长度不一致 varchar 等值)、§5.33(真实规则形态多样
只纳入可复现形态对拍)、§5.OTP(私有 jar 模块内仓库)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 13:39:17 +08:00
parent 8d1d2ab0f7
commit 82f52c1114
5 changed files with 705 additions and 0 deletions

View File

@@ -392,6 +392,27 @@ com.dsasp.* com.eip4.*
- **落地**:platform-auth 在 `com.eip4` 侧**逐字节复刻** `PasswordHasher.md5Hex`(保真层 EncryptUtil 一行不改),用平台默认字符集 `getBytes()` 与旧系统一致;比对用 `MessageDigest.isEqual` 常量时间防时序侧信道。验证:`MD5("123456")=e10adc3949ba59abbe56e057f20f883e` 单测断言。
- **注意**:无盐 MD5 是**待现代化项**(口令存储弱),但本任务目标是兼容验证既有客户库口令,口令强化属后续独立议题(可在改密路径渐进迁移)。角色解析复刻 `RoleServiceImpl#findRolesByUserId`(`sys_usergrouprole ⋈ sys_usergroupuser`),org 表未移植时降级空角色不阻断登录。
### 5.32 客户库 sys_usergroupuser.userid 列长度不一致(36 padding vs 32),varchar 等值只匹配同表示行 [NEW 2026-06-11]
- **现象**:P2-1 组织模块移植后,`GET /api/org/user/{id}/roles`(底座 `RoleServiceImpl.findRolesByUserId`)某用户返回 360 角色,但「直觉版」对账 SQL(给 userid 加 trim 或不加)得 0 或别的数,难以对账。
- **根因**:`sys_usergroupuser.userid` 是 `character varying` 但**数据混存两种长度**——36 字符(空格补足到 36 位,客户库 5101 行)与 32 字符(无补足,198 行)。`findRolesByUserId` 的 `WHERE ugu.userid='<32位id>'` 走 varchar `=`(**PG varchar 等值不忽略尾空格**,区别于 bpchar),只命中 32 位的非补足行 → 该用户得 215 条 direct 角色,再经 `SYS_ROLE_ROLE`(OPERATORROLE IN 215)派生 145 → 列表共 **360**(含重)。用 DB 完整复现引擎两步 SQL(保持「'<32位id>' 不补空格、varchar 等值」语义)= 360,**逐字节一致**。**新旧系统行为相同**(同一引擎 SQL),非移植缺陷;是客户库历史数据 ID 表示不一致。
- **对策**:① 对账/对拍此类用户-角色关系**必须用引擎精确 SQL**(不擅自加 trim/pad,否则与引擎口径背离产生假差异);② OrgController 用户-角色端点直接委托保真层 `roleService`,语义零偏移;③ 数据治理时这批 32/36 混存 ID 应与客户确认统一(决策会红线 3 口径)。
- **影响范围**:所有按 userid 等值过滤 `sys_usergroupuser` 的路径(角色解析、岗位用户查询);凡跨 char/varchar 等值比较且数据有补足不一致的列(对照 §5.7 混合大小写表名,此为「长度/补足不一致」同族坑)。
### 5.33 真实数据权限规则形态多样,对拍只纳入可确定性复现形态做正例 [NEW 2026-06-11]
- **现象**:P2-1 权限对拍扩容做「真实实体只读权限对拍」时,客户库 `SYS_FILTERRULE` 有 **1079 条活跃规则**(`SELECT entityid,count(*) FROM sys_filterrule WHERE isactive=1 GROUP BY 1` 反查 tablename:PM_PAYMENTAPPLY 31/VIEW_PM_CONTRACT 23/PM_CONTRACTACCOUNTS 22/HR_SAFETYCARD 13…),`filterrule` 列 JSON 形态多样:`[]`(查看全部)、`[{USERID={CURRENTUSERID}}]`(查看自己)、`[{KIND=N}]`(静态)、`[{USERID in (select … where userorgid={CURRENTUSERORGID})}]`(本公司)、OWNNERPROJECT 等。
- **根因**:`{CURRENTUSERORGID}`/`{CURRENTUSERDEPART}`/OWNNERPROJECT 等动态规则的等价 WHERE 依赖运行期 ctx(org/depart/project)且含子查询,在对拍侧**精确重建脆弱**(易因 ctx 取值口径偏差产生假阳性);而引擎 OR-合并用户**全部**命中角色的规则,单条难隔离。
- **对策**:`RealEntityPrivilegeRunner`(`ParityCli --realprivilege`)只挑两类**可确定性复现等价 WHERE** 的形态做正例:① `[]`→全表;② `[{USERID={CURRENTUSERID}}]`→`WHERE userid='<uid>'`。且**仅当真实用户对该实体的全部交集规则都属可复现形态**才取为正例(否则引擎 OR 进不可复现规则,等价 WHERE 不成立);其余真实形态语义虽真实,**如实登记不纳入正例**(避免假阳性)。负例(无命中角色→`PrivilegeException`)对所有有规则实体均可验。**全程只读,绝不向客户库写规则**(任务红线)。实测:HR_SAFETYCARD/HR_OTHERCARD/HR_CONSTRUCTORCARD/HR_MEMBERCARD 共 4 实体 805 行 100% 逐行一致 + 5/5 负例被拒(见 platform-auth/P2组织权限实测报告.md §七)。
- **影响范围**:所有真实规则权限对拍;`{CURRENTUSERORGID}`/OWNNERPROJECT 等动态形态的对拍待 P2 管理 UI 落地后,用「写规则→读回 ctx 一致性」闭环验(届时有真实 ctx 来源),非本期只读对拍能覆盖。
### 5.OTP P2 organize 移植:OTP 库 jotpverify.jar 无公网坐标,经模块内私有仓库解析 [NEW 2026-06-11]
- **现象**:`UserOtpServiceImpl`(动态令牌认证)依赖 `ft.otp.verify.OTPVerify`(`framework/com.dsasp.server.organize/lib/jotpverify.jar`),Maven 中央仓库无此坐标,模块编译期 `package ft.otp.verify does not exist`。
- **根因**:旧系统私有第三方令牌库,无公网 Maven 坐标。
- **对策**:置 jar 于 `platform-legacy-core/local-libs/`(标准 Maven repo 布局 `ft/otp/jotpverify/1.0.0/jotpverify-1.0.0.{jar,pom}`),在 **platform-legacy-core 模块 pom** 加 `file://${project.basedir}/local-libs` 私有仓库 + 依赖坐标 `ft.otp:jotpverify:1.0.0`。**父 pom 不动**,模块自包含、构建可复现(随工程进版本库)。`UserOtpServiceImpl` 代码原样保留一行未改。**注意**:offline(`-o`)首次构建会拒绝 file:// 仓库(未缓存),需联网构建一次(无网络下载,仅解析本地 file 仓库)。
- **影响范围**:凡移植带私有 lib jar 的 framework 模块同此法(模块 local-libs 私有仓库),勿往父 pom 加 system-scope 或全局坐标。
## 六、Flowable 升级三坑
> 来源:eip4-poc WS4 实测,flowable-poc / flowable5-poc 工程(2026-06-10)