P2-4: 多维数据权限全形态实测——R1 风险判定(引擎多维隔离语义成立)

普查(客户库只读):1079 条活跃规则归型——多规则同实体 303/345(角色 OR 88%)、
多条件 op 串联 117、type 分布 CURRENTUSERORGID 323/OWNNERPROJECT 165/CURRENTUSERDEPARTID 27、
SPECIALDEPART/ORG 客户零用;OwnProjectWhere SysConfig 实际值取证。

实测(本地 eip4m0,可写):bootstrap-multidim.sql 构造 7 受控实体 + 规则矩阵,
MultiDimPrivilegeRunner + ParityCli --multidim 多维 ctx 驱动引擎过滤 vs JDBC 等价 WHERE
逐行对拍——14 形态 100% 一致(39 行)+ 7/7 负例被拒。覆盖部门/组织/SPECIALDEPART/
OWNNERPROJECT 单维、op=AND 串联、多规则角色 OR 三态、建筑三维 OWNER×部门×项目。

客户库抽测(只读,P2-1 口径):DM_FILE(299)/SYS_USER(806)组织维 count+行级 MATCH + 负例被拒。

测试通道:EntityController 加 asDepart/asOrg(与 asUser 同性质,不传零回归),
使引擎可解析 CURRENTUSERDEPARTID/CURRENTUSERORGID 维度。

单测:MultiDimDataPrivilegeTest 9 测(getWhereClause 拼接矩阵,FakePOInfo 模式)。
全模块 test + ArchUnit 绿。手册新增 §5.34/§5.35。

R1 判定:引擎多维隔离语义成立,不构成 P2 阻塞;缺口(OWNNERPROJECT 客户库直拍/
生产 ctx 注入/SPECIALDEPART 无真实样本)如实登记跟踪。未触发决策会 S1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 14:05:09 +08:00
parent 82f52c1114
commit b6de637905
8 changed files with 1285 additions and 11 deletions

View File

@@ -109,6 +109,7 @@ com.dsasp.* com.eip4.*
| `Console` | Vaadin 浏览器控制台推送 | `slf4j` | 待查 | 极简 | 日志语义等价 |
| `InstallOrUpdate` | 启动期按版本跑 install SQL | `isDevDB()=false` 桩 | 待查 | 极简 | 生产环境不触发 |
| `GetServicesFunction` 等 3 个 | Groovy 脚本函数库(约 2,600 行) | Java 桩(仅实现 `findCount`);WS3 回迁 | 约 2,600 行 | 最小桩 | P1/P3 阶段补全真实现 |
| `FTPClientTemplate` | FTP 远端存储后端(commons-net + DB 内 FTPServer/FTPPort/FTPUserName/FTPUserPassword 配置)| **本地盘后端**(P2-3,附件横切服务真实现移植)| 308 行 | 约 150 行 | **保包名/类名/对外签名**(`uploadFileAndZip`/`downloadFile`/`delete`/`fileExists`);后端 FTP→本地盘,根目录=`MainApp.destPath`(默认 `./data/files`,经 `eip4.file.root` 配置化注入)。`FileServiceImpl`/`ZipUtil` call site 零改动。安全:`resolveSafe` 归一 canonical path 拒绝 `../` 逃逸出根。详见 §5.36 / platform-auth/P2横切服务实测报告.md |
**注意**:替换时必须**保持包名/类名/方法签名完全一致**,旧引擎代码对这些类的引用不做任何修改——「旧代码零感知」是双层制的核心约定。
@@ -117,9 +118,10 @@ com.dsasp.* com.eip4.*
| 桩 | 包路径 | 当前行为 | P2 真实现要点 |
|----|--------|---------|-------------|
| ~~`dataPrivilegeService`~~ | ~~`com.eip4.poc.stub`~~ | **已由 M0/C2 真实现接管** | 桩已删除;保真层 `com.dsasp.server.privilege.service.DataPrivilegeServiceImpl`(原样移植)提供行级过滤原版语义;P2 在此之上接组织数据源 + 管理 UI(见 §5.8 / platform-auth/C2实测报告.md) |
| `fileService` | `com.eip4.poc.stub` | no-op | 本地盘 / MinIO 接口 |
| `projectSwitchService` | `com.eip4.poc.stub` | no-op | 项目上下文切换 |
| `systemLogManager` | `com.eip4.poc.stub` | slf4j | 业务操作日志入库 |
| ~~`fileService`~~ | ~~`com.eip4.platform.auth.stub`~~ | **已由 P2-3 真实现接管** | 桩已删除;保真层 `com.dsasp.server.file.service.FileServiceImpl`(原样移植,bean `fileService`)接管;存储后端经替换类 `FTPClientTemplate`(本地盘,根目录 `eip4.file.root` 配置化)。详见 §3.1 / §5.36 / platform-auth/P2横切服务实测报告.md |
| `projectSwitchService` | `com.eip4.platform.auth.stub` | no-op(**保留**) | **viewframework 域,非 P2-3 文件/日志/消息范畴**;P2 计划未列其真实现归属,保留桩待 viewFramework 域专项移植接管 |
| ~~`systemLogManager`~~ | ~~`com.eip4.platform.auth.stub`~~ | **已由 P2-3 真实现接管** | 桩已删除;保真层 `com.dsasp.server.log.service.SystemLogManagerImpl`(bean `systemLogManager`)+ `DataOperatorLogger`(bean `dataOperatorLog`)+ `DataLogRecorderImpl`(bean `dataLogRecorder`)原样移植,异步批量落 SYS_LOG / SYS_DATA_LOG / SYS_DATA_LOGITEM。`StubDataOperatorLog` 同步删除 |
| ~~`systemEmailService`~~ | (原无桩) | **P2-3 移植 + 降级装配** | 保真层 `com.dsasp.server.mail.service.SystemEmailServiceImpl`(bean `systemEmailService`)+ `SystemEmail`/`SystemEmailService` 移植;**SMTP 配置缺省时降级 no-op + WARN,不阻塞启动**。详见 §5.37 |
---
@@ -406,6 +408,41 @@ com.dsasp.* com.eip4.*
- **对策**:`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.34 多维权限对拍:引擎需 CURRENTDEPART/CURRENTORG,EntityController 测试通道须加 asDepart/asOrg [NEW 2026-06-11]
- **现象**:P2-4 实测多维隔离(部门/组织/项目维)时,引擎 `DataPrivilegeServiceImpl.getFilterSql` 对 `CURRENTUSERDEPARTID`/`CURRENTUSERORGID` 类型条件读 `ctx.CURRENTDEPART`/`ctx.CURRENTORG`,但 `EntityController.buildCtx` 的 `asUser`/`roles` 测试通道**只注入 CURRENTUSER + ROLES**,部门/机构维 ctx 为空 → 多维过滤拼出 `P.DEPARTID =''`(空串)致结果恒空,无法对拍。
- **根因**:C2/P2-1 仅验单维(CREATEBY/USERID/view-all),测试通道未覆盖部门/机构维 ctx。
- **对策**:`EntityController.list` 增 `asDepart`/`asOrg` 两个**测试通道**查询参(与 `asUser` 同性质,加入 `RESERVED_KEYS` 放行),`buildCtx` 在 asUser 分支可选 `ctx.setProperty(CURRENTDEPART/CURRENTORG, …)`。不传则维持单维行为(零回归)。对拍执行器 `MultiDimPrivilegeRunner`(`ParityCli --multidim`)据此驱动 `asUser+asDepart+asOrg+roles` 多维 ctx vs JDBC 等价 WHERE 逐行 diff。实测 **14 形态(单维部门/组织/SPECIALDEPART/OWNNERPROJECT、op=AND 串联、多规则角色 OR、建筑三维 OWNER×部门×项目)100% 逐行一致 + 7/7 负例被拒**(见 platform-auth/P2多维数据权限实测报告.md)。
- **影响范围**:凡需多维 ctx 的对拍/集成测试同此(测试通道补维度键,生产经 JWT/UserSession 注入真实 ctx,非测试通道);`SPECIALDEPART`/`SPECIALORG` 客户库零使用但引擎支持,本期已补构造验证全覆盖。
### 5.35 多维自举 bootstrap 清理须按精确 id 删属性,LIKE 'a1000000-%' 会误删 bootstrap-sys 的 SYS 自描述元数据 [NEW 2026-06-11]
- **现象**:`bootstrap-multidim.sql` 复用 `bootstrap-privilege` 的 SYS_FILTERRULE 自描述元数据 id(`a1000000-…-08xx/09xx`),清理时若写 `DELETE FROM sys_entityattribute WHERE sys_entityattribute_id LIKE 'a1000000-%'`,会**连带删掉 bootstrap-sys 为 SYS_ENTITY/SYS_USERGROUP/SYS_ENTITYATTRIBUTE 等系统表建的自描述属性**(它们 id 同前缀 `a1000000-…-01xx..07xx`)→ 引擎 `getSYSEntityByTableName` 的 `loadPOJO(…,"SYS_ENTITY",…)` 因 SYS_ENTITY 零属性 → `buildSelect` 产出字面 `null` → **任意实体 list 全盘 HTTP 500**(`PSQLException: syntax error at or near "null"`,Position 1)。
- **根因**:SYS 自描述元数据(SYS_ENTITY 自身的列定义)是引擎解析**所有**实体的前置依赖;bootstrap-sys 与权限/多维 bootstrap 的属性 id 共享 `a1000000-` 前缀,宽前缀 DELETE 跨界误删。
- **对策**:幂等清理**只删本脚本自建**的属性——精确到 `a1000000-…-0008%`/`-0009%`(SYS_FILTERRULE/中间表)+ 自定义前缀 `amd00000-`(多维实体),**绝不**用宽 `a1000000-%`。排错锚点:`SELECT e.tablename, count(a.*) FROM sys_entity e LEFT JOIN sys_entityattribute a … WHERE e.tablename='SYS_ENTITY'`——SYS_ENTITY 属性数为 0 即此坑。
- **影响范围**:所有复用 bootstrap-privilege/bootstrap-sys 固定 id 的增量 bootstrap 脚本;新增自举脚本的 DELETE 一律按**本脚本自有 id 段**收敛,不按共享前缀。
### 5.36 附件 FileService 原版后端=FTP(非本地盘),本地盘默认须经替换类落地;旧依赖 sun.misc.BASE64Decoder/ant zip 在 JDK17 不可用 [NEW 2026-06-11]
- **现象**:framework `FileServiceImpl` 看似「本地盘」,实则 `save` 经 `ZipUtil.ZipFileToDest`→`FTPClientTemplate.uploadFileAndZip` **上传到 FTP 服务器**(地址取自 DB `DBInfoConfigurer.getContextProperty("FTPServer/FTPPort/...")`),`getDocFile` 同样经 FTP 下载;且 `FileServiceImpl` 用 `sun.misc.BASE64Decoder`(JDK 17 已移除)、`ZipUtil` 用 `org.apache.tools.zip`(ant)、`FileUtil.getFileType` 用 `javax.swing.FileSystemView`。直接原样移植在 Boot 3 / JDK 17 既编译不过,也不满足「默认本地盘、不依赖外部服务」。
- **根因**:旧引擎附件层是「DB 元数据(SYS_DOC) + FTP 物理存储」二段式;存储后端被封装在 `FTPClientTemplate`(commons-net),正是 §3.1 可等价替换的耦合点。
- **对策**:按 §3.1「保包名/类名/对外签名」替换类策略——`FileServiceImpl`/`ZipUtil` 主体原样移植(仅 `BASE64Decoder`→`java.util.Base64`、ant zip→`java.util.zip`、`HashCalc` 的 commons-codec→JDK `MessageDigest`,摘要逐字节一致),把 `FTPClientTemplate` 整体换为**本地盘后端**(同包同名同签名 `uploadFileAndZip`/`downloadFile`/`delete`/`fileExists`)。根目录 = `MainApp.destPath`,默认 `./data/files`,经 `eip4.file.root`(application.yml,环境变量 `EIP4_FILE_ROOT` 可覆盖)由 `LegacyXmlWiring` 单向注入(保真层不反向依赖现代层,ArchUnit 约束)。上传仍按原语义把单附件 zip(单条目=文件名)落 `destPath+相对路径`,SYS_DOC 落库(FILEPATH/MD5/软删 ISACTIVE)语义不变。**安全第 1 层**:`resolveSafe` 用 canonical path 比对,拒绝 `../` 逃逸出根(WARN + IOException)。
- **影响范围**:凡涉及附件存储的路径;真实启用 MinIO/对象存储时,同样在 `FTPClientTemplate` 这一替换类处换后端,`FileServiceImpl` 及引擎调用方零改动。`MainApp` 原版写死 Windows 路径(`C:\\...`/`D:\\c\\baseDoc\\`),移植时默认值改为跨平台相对路径并加 setter。
### 5.37 系统/数据日志为异步队列+定时批量落库,bean 名 systemLogManager/dataOperatorLog/dataLogRecorder 三件齐;jdbcTemplate 须 XML 等价 setter 补齐;LOGLEVEL 未配置=整链静默 [NEW 2026-06-11]
- **现象**:`SystemLogManagerImpl.log(LogType,String)` 与 `DataOperatorLogger.insert/update/deleteData` **并不直接写库**,而是入 `ConcurrentLinkedQueue` 后由 `DataLogManager`(单例 Timer,1s 启动 30s 周期)经线程池分批(每批 100)调 `ProcessSysLogThread`/`ProcessLogThread`→ 真正落库的 `systemLogManager.log(List)` / `dataLogRecorder.recorderLogs(List)`。线程任务用 `SpringBeanOsgiServices.getInstance().getBeanByName(...)` 取 bean,故 `systemLogManager`/`dataLogRecorder` **bean 名必须精确**。`SystemLogManagerImpl.log(LogType,String)` 还有两道闸:`UserSession.get()==null` 直接返回,且 `LOGLEVEL` 配置(`com.dsasp.server.log.LOGLEVEL`,逗号分隔 `LogType.value`=Errors/Info/Debug/Warnings)未命中也返回——**未配置 LOGLEVEL = 系统日志整链静默**。
- **根因**:旧引擎日志为「写多读少、容忍延迟」设计,异步批量降数据库压力;`jdbcTemplate` 在 framework 经 service.xml `<property>` setter 注入(非 @Autowired)。
- **对策**:三个 impl(`SystemLogManagerImpl`/`DataOperatorLogger`/`DataLogRecorderImpl`)原样移植 + `DataLogManager`/`ProcessLogThread`/`ProcessSysLogThread` 原样移植;`jdbcTemplate` 经 `LegacyXmlWiring`(SmartInitializingSingleton)等价 setter 补齐(见 §4.1,本次新增 fileService/systemLogManager/dataLogRecorder 三处)。本地验证须在 `sys_application_config` 种 `com.dsasp.server.log.LOGLEVEL='Errors,Info,Debug,Warnings'`(见 bootstrap-xservice.sql),否则系统日志不落。`SYS_DATA_LOGITEM` 为 insert-only 无 UPDATETIME 列(§5.1),`DataLogRecorderImpl` 只走纯 INSERT,符合。数据日志仅当实体 `SYS_ENTITY.ischangelog=1` 才记(`po.get_poInfo().isChangeLog()`)。
- **影响范围**:凡需端到端验证日志落库,须备齐三表(SYS_LOG/SYS_DATA_LOG/SYS_DATA_LOGITEM)+ LOGLEVEL 配置 + changelog 实体 + 请求级 UserSession;异步链路落库有最长 ~30s 延迟,集成测试宜直接调 `log(List)`/`recorderLogs(List)` 同步路径断言。
### 5.38 邮件 SystemEmailServiceImpl 深度依赖外部 SMTP(javax.mail + freemarker + OSGi ConfigUtil),按「配置缺省降级 no-op + WARN」装配,不阻塞启动 [NEW 2026-06-11]
- **现象**:原版 `SystemEmailServiceImpl` 构造期即 `ConfigUtil.getValue("admin_mail")`(经 OSGi `com.dsasp.resource.Activator` 读 bundle 内 properties),发件走 Spring `JavaMailSender`(javax.mail,非 jakarta.mail)+ freemarker 模板 + `TaskExecutor` 异步;`ClientMailServiceImpl` 更是整套 POP3/IMAP 收发件客户端。直接原样移植在 Boot 3 需 javax→jakarta.mail 迁移 + 活的 SMTP/POP3 服务器,且 eip4 当前无任何调用方。
- **根因**:邮件是「深度依赖外部服务」的横切件,与文件/日志(纯本地盘/本地库)性质不同。
- **对策**:按 P2 任务约定——移植 `SystemEmailService` 接口 + `SystemEmail` bean(原样),提供 `SystemEmailServiceImpl`(bean `systemEmailService`)**降级实现**:`sendEmail` 读 SMTP 发件人配置(`SysConfig` 键 `com.dsasp.server.mail.admin_mail`),缺省(默认)时仅打 WARN 后 no-op 返回,**决不抛异常、决不阻塞调用方/启动**;配置就绪时 WARN 提示「真实 SMTP 投递待 JavaMailSender 装配后接通」留口。`ClientMailService`(POP3/IMAP 全客户端)非「横切消息服务」范畴且无调用方,本次不移植。真实启用时在此 impl 接 `JavaMailSender`(jakarta.mail)即可,接口/bean 名零改动。
- **影响范围**:工作流任务提醒、报表订阅等触达邮件的路径;启用前调用方得到的是「静默 no-op + 日志」,不影响主流程正确性。
### 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`。