MDP 主数据平台 V1.4.0 版本升级日志
V1.4.0 重构开放平台安全加密方案,区分接口调用、事件回调两套加密机制;优化单点登录、日志打印、前端组件、SDK 能力,清理废弃 RSA 逻辑,统一全平台字段、日志规范。
一、核心安全架构重构(开放平台)
1. 开放平台接口调用鉴权改造
旧逻辑
平台存储应用公私钥,应用私钥签名请求参数,MDP 使用存储公钥完成验签。
新逻辑
- 仅存储应用公钥,私钥由应用方自行保管;
- 新增
accessToken.get接口获取凭证,常规接口仅凭accessToken鉴权;
- 高敏感接口保留 RSA 公私钥签名验签双重校验;
- 接口调用新增 IP 白名单访问控制。
2. 事件推送 / 回调通知加密改造(对标微信开放平台)
旧逻辑
平台维护独立 RSA 公私钥,平台私钥签名、应用公钥验签(非对称加密)。
新逻辑(Token+EncodingAESKey 对称加密)
- 应用配置
Token、EncodingAESKey两组密钥,统一使用HMAC-SHA256对称签名;
- 重构
NotifyCallbackController,支持明文 / 兼容 / 安全三种加密模式;
- 统一封装
MdpBizMsgCrypt完成加解密,废弃旧NotifyPushUtil;
- 移除全平台 RSA 密钥存储、校验相关代码与实体字段,简化密钥管理;
- 新增
AesException细分加密异常,配套ByteGroup、JSON 解析辅助工具类;
- 按事件类型自动分发回调任务,新增
AppKeysFacade统一读取应用加密配置;
- 全量统一请求参数、业务实体字段为小驼峰命名规范。
二、后端迭代更新
1. 第三方依赖版本升级
- commons-io:2.20.0
- fastjson2:2.0.62
- logback-classic:1.5.32
2. 新增功能 (feat)
- mdp-sdk:新增通用请求实体
IdRequest;
- md-open:回调事件多加密模式、对称加解密全套能力;
- md-api:新增
accessToken.get凭证获取接口;
- workbench-web:SSO 跳转应用增加应用权限校验,客户端 IP 白名单拦截。
3. 代码重构优化 (refactor)
- md-json-starter:重构 JSON 序列化模块结构与配置;
- 全局统一文件标识字段命名规范
xxxFileId;
- 开放平台接口 IP 白名单控制逻辑重构;
- AppManager、AppKeysService 密钥查询接口重构,新增
getByAppKey;
- 全量统一推送、回调请求参数、业务实体为小驼峰命名。
4. Bug 修复 (fix)
- md-log-starter:修复 MDC 上下文参数无法写入日志文件问题;
- md-xx-server:统一控制台 / 文件日志输出格式,新增服务操作日志、调整日志打印模板;
- workbench-web:清理 SSO 注销冗余字段,统一使用
ssoPush配置映射。
三、前端迭代更新
- 修复消息通知弹窗展示异常问题;
- 剪贴板工具统一替换:移除
vben/hooks/useCopyToClipboard,改用vueuse/core内置useClipboard;
四、其他清理优化
- 移除废弃 RSA 工具类、实体密钥字段,清理冗余历史代码;
- 统一业务异常封装,细化加解密异常编码与提示文案;
- 优化事件推送、回调通知数据字段命名,规范输出结构。
🚀项目介绍
主数据平台(master-data-platform),简称 MDP。MDP 基于 Java17、SpringBoot、vue3、ant-design-vue 等主流技术构建的中后台快速开发平台,立志打造为一个企业级的软件开发基础脚手架,帮助企业快速搭建一个基础开发框架。
简单来说,可以理解为 MDP 是集 单点登录系统、主数据(基础数据)维护与管理、开发者平台(开放平台)等功能于一身的平台。
核心子应用
MDP 主数据平台内置了 3 个子应用,分别是:工作台、控制台、开放平台,满足不同场景下的使用:
| 子系统 |
代码简称 |
核心功能 |
| 工作台 |
mdw |
又名 “用户中心”。用户统一操作入口、我的应用、统一登录、统一注册、消息中心 |
| 控制台 |
mdc |
又名 “管理中心”。主数据维护、系统配置、应用审批、接口管理、文档配置、组织架构、数据字典、参数配置 |
| 开放平台 |
mdo |
又名 “开发者中心”。第三方应用申请和管理、接口调用、文档查看、SDK 支持、接口调用次数查询 |
项目演示环境
- 工作台
- 控制台
- 开发者中心