脱敏工具类和反脱敏组件使用指南

版本 新特性 日期
V0.0.8-SNAPSHOT 1、脱敏格式可根据区域进行配置;2、对登记序号为空提供支持; xxx-xx-xx
V0.0.8-SNAPSHOT 1、新增注入@Service方式进行脱敏;2、将配置收入application-main.properties中,提供默认实现,需自定义的需自己修改配置;3、对脱敏入参进行判空,任意空则返回原文; xxx-xx-xx
V0.0.8-SNAPSHOT 1、解决Base64特殊字符解密错误问题;2、支持多入参;3、支持GET方式; xxx-xx-xx

最新版本为 V0.0.8-SNAPSHOT + V0.0.2-SNAPSHOT,暂时不会再升级版本,待测试通过发布1.0.0版本

脱敏工具类使用三板斧

1、引入pom依赖

   <!-- 反脱敏组件 -->
   <dependency>   
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>   
       <artifactId>BondeReverseDesensitize</artifactId>  
       <version>0.0.8-SNAPSHOT</version>
   </dependency> 

2、定义脫敏开发及加密key配置
配置文件application-main.properties中定义

#脫敏配置
desensite.open=yes
desensite.encryptKey=fixedDateNeedChangeEncryptKey

#脱敏格式
##固话,默认显示后四,范例:*******6666
desensite.formate.fixedphone.position.start=3
desensite.formate.fixedphone.position.end=4
#银行卡,默认显示前六后四,范例:622848******4568
desensite.formate.bankcrd.position.start=6
desensite.formate.bankcrd.position.end=4
#手机,默认显示前三后四,范例:189****3684
desensite.formate.mobile.position.start=3
desensite.formate.mobile.position.end=4
#身份证号码,默认显示前六后四,范例:330601********2015
desensite.formate.ctfnbr.position.start=6
desensite.formate.ctfnbr.position.end=4

desensite.open只有为no时候才不会进行脱敏返回原文,默认为yes自动进行脱敏;

脱敏格式,业务团队需自定义需要在自己配置到application-main.properties中(本地或者nacos都支持);

3、调用脱敏工具类或者服务
为支持Nacos配置方式,提供注入@Service方式进行脱敏,推进优先使用该方式;

@Autowired
DesensiteService desensiteService;


logger.info("======service注入方式=======");
logger.info("手机脱敏后:{}", desensiteService.desensitize("18906712121","101010110101011010101", DesensiteConstant.TYPE_MOBILE));
logger.info("固话脱敏后:{}",desensiteService.desensitize("057136648878","101010110101011010101", DesensiteConstant.TYPE_FIX_PHONE));
logger.info("身份证脱敏后:{}",desensiteService.desensitize("330128199107356847","101010110101011010101", DesensiteConstant.TYPE_CTFNBR));
logger.info("银行卡号脱敏后:{}",desensiteService.desensitize("6228482462893085616","101010110101011010101", DesensiteConstant.TYPE_BANKCRD));

静态工具类调用方式:DesensiteUtil.desensitize(原字符串,登记序号,原字符串类型)

logger.info("手机脱敏后:{}", DesensiteUtil.desensitize("18906712121","1010101", DesensiteConstant.TYPE_MOBILE));
        logger.info("固话脱敏后:{}",DesensiteUtil.desensitize("057136648878","1010101", DesensiteConstant.TYPE_FIX_PHONE));
        logger.info("身份证脱敏后:{}",DesensiteUtil.desensitize("330128199107356847","1010101", DesensiteConstant.TYPE_CTFNBR));
        logger.info("银行卡号脱敏后:{}",DesensiteUtil.desensitize("6228482462893085616","1010101", DesensiteConstant.TYPE_BANKCRD));

反脱敏组件使用三板斧

1、引入pom依赖

   <!-- 反脱敏组件 -->
   <dependency>   
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>   
       <artifactId>BondeReverseDesensitize</artifactId>  
       <version>0.0.8-SNAPSHOT</version>
   </dependency>
   <!-- 反脱敏关联数据 -->
   <dependency>
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>
       <artifactId>BondeRevDesensitizeNeedData</artifactId>
       <version>0.0.2-SNAPSHOT</version>
    </dependency>

由于登记序号需要从当前登录用户的纳税人信息中获取,所以需要再依赖BondeRevDesensitizeNeedData公共jar;

2、配置组件扫描包路径

@ComponentScan(basePackages = {"cn.com.xxx"})
或者
<context:component-scan base-package="cn.com.xxx" />

确保能正确加载到反脱敏组件的相关Bean;

3、添加注解直接使用
Controller的方法上直接添加@ReverseDesensitization即可;
示例:

   /**
     * 对象接收
     * @param params
     * @return
     */
    @PostMapping("/submitJson")
    @ReverseDesensitization
    public String submit(@RequestBody User params) {
        logger.info("反脱敏后:{}", JSON.toJSONString(params));
        return JSON.toJSONString(params);
    }

    /**
     * 接收纯字符
     * @param desnsiteStr
     * @return
     */
    @PostMapping("/submitString")
    @ReverseDesensitization
    public String submit(@RequestBody String desnsiteStr) {
        logger.info("反脱敏后:{}", desnsiteStr);
        return desnsiteStr;
    }
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容