中国 帮助

数据脱敏

功能说明 系统基于 Jackson 序列化策略,对标注 @Sensitive 的字段进行脱敏处理。 补充说明: 脱敏发生在接口响应序列化阶段,因此通常用于“返回给前端时隐藏敏感信息”,不会直接改动数据库中的原始值。 常见

数据脱敏
封面

> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/extend/sensitive.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-0fe1e04bb800-cover.svg)

  • - -

功能说明

系统基于 Jackson 序列化策略,对标注 @Sensitive 的字段进行脱敏处理。

补充说明:

  • 脱敏发生在接口响应序列化阶段,因此通常用于“返回给前端时隐藏敏感信息”,不会直接改动数据库中的原始值。
  • 常见适用字段包括手机号、身份证号、邮箱、银行卡号、住址等。

使用方式

在字段上标注 @Sensitive,并指定策略与权限:

![输入图片说明](https://foruda.gitee.com/images/1699523591703893602/ffd6dba2_1766278.png "屏幕截图")

字段说明:

  • strategy:脱敏策略
  • roleKey:角色 code(满足角色可查看明文)
  • perms:权限 code(满足权限可查看明文)

![输入图片说明](https://foruda.gitee.com/images/1678979315796014155/614adf91_1766278.png "屏幕截图")

补充说明:

  • 如果同时配置了角色或权限放行条件,满足条件的用户可直接看到原文,不满足条件时才执行脱敏。
  • 该能力适合做“同一接口对不同权限用户返回不同展示效果”的场景。

自定义脱敏策略

在 SensitiveStrategy 中新增策略实现:

![输入图片说明](https://foruda.gitee.com/images/1678979319996224858/3b3e3c8b_1766278.png "屏幕截图")

脱敏逻辑调整

可通过通用接口自定义脱敏逻辑,支持不同系统使用不同规则。

![输入图片说明](https://foruda.gitee.com/images/1678979325448998856/b262e425_1766278.png "屏幕截图")

默认逻辑:根据角色/权限或非管理员进行脱敏,可按需修改。

![输入图片说明](https://foruda.gitee.com/images/1699523752627488891/f82f2f50_1766278.png "屏幕截图")

补充说明:

  • 如果项目对“管理员是否可见明文”的规则有特殊要求,可以通过 SensitiveService 的实现统一调整,而不是到每个字段单独分支判断。

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-0fe1e04bb800-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容