SpringBoot增强库 yue-library 2.3.2发布,优雅实现密钥交换加解密

logo

yue-library简介

yue-library是一个基于SpringBoot封装的增强库
  • 内置丰富的JDK工具
  • 自动装配了一系列的基础Bean与环境配置项
  • 快速构建SpringCloud项目,让微服务变得更简单

版本更新日志

此版本重点实现:密钥交换加解密、增强Bean转换能力、JDBC新增Elasticsearch-SQL、达梦、PostgreSQL方言。

新特性

  • 【base】ParamUtils提示优化,添加错误原因
  • 【base】添加JSONListConverter类型转换器从而支持List<JSONObject>类型处理(JDBC实体数据库查询映射时JSONArray格式文本数据不支持映射成List<JSONObject>)
  • 【base】优化fastjson bean转换的jsonstr识别方式
  • 【base】增强DateUtils与规范UUID工具类为IdUtils并优化IdUtils实现
  • 【base】增强fastjson JavaBean转换能力,支持Character类型
  • 【base】MapUtils增强值提取,支持list根据key提取map提取值支持map、fastjson pulls !17
  • 【crypto】新增重磅特性-密钥交换加密:支持@RequestDecrypt注解实现请求自动解密
  • 【crypto】新增重磅特性-密钥交换加密:支持@ResponseEncrypt注解实现响应内容加密
  • 【crypto】密钥交换加密:默认提供本地Map与Redis两种交换密钥存储方案
  • 【crypto】密钥交换加密:@RequestDecrypt与@ResponseEncrypt注解支持使用交换密钥加密或自定义密钥等特性
  • 【web】修复ApiVersion注解minimumVersion值等于的情况下410
  • 【web】优化响应结果处理器在标准HTTP状态码时的空值处理
  • 【web】新增ServletUtils.getAuthToken()方法,获取请求中的OAuth2 Token
  • 【webflux】修复ApiVersion注解minimumVersion值等于的情况下410
  • 【jdbc】对jdbc方言实现进行完善与优化,新增Elasticsearch-SQL、达梦、PostgreSQL方言
  • 【jdbc】db.queryForObject 自动识别Bean类型与简单类型
  • 【jdbc】参数美化增强支持JSONArray数据类型与List<JSONObject>数据类型
  • 【jdbc】优化多行查询结果转换为单行查询结果实现
  • 【jdbc】所有mappedClass查询方法自动识别所需RowMapper类型,实现JavaBean、map、基本类型结果自动匹配
  • 【jdbc】规范内部部分常量命名与移除分页中不优雅的泛型实例PageTVO
  • 【jdbc】增强自动方言识别,根据驱动类自动识别所需方言类型
  • 【jdbc】默认Db Bean实现根据不同驱动类型,使用对应方言配置
  • 【jdbc】优化DAO实现,抽象基础DAO
  • 【jdbc】优化所有jdbc方法注释,描述更简洁,表达更清晰,注释更规范
  • 【jdbc】删除早期存在的部分过时方法
  • 【es】支持配置ConnectTimeout与SocketTimeout,并调大各自默认值为25与15秒

Bug修复

  • 【base】修复fastjson JavaBean转换BUG #3688
  • 【jdbc】修复isDataSize()方法可能因为数据库存在多行数据,而返回false的隐患
  • 【jdbc】修复因错误测试而删除的参数类型美化(现已支持:Character、JSONObject、LocalDateTime进行特殊转换处理与布尔值映射识别)

Maven仓库实际发布版本号

j8.2.3.2、j11.2.3.2

关键pom.xml依赖:

依赖版本
spring-boot2.3.8.RELEASE
spring-cloudHoxton.SR10
spring-cloud-alibaba2.2.5.RELEASE
hutool5.6.3
fastjson1.2.76

工程结构

. yue-library
├── yue-library  基础库
│   ├── yue-library-dependencies  父pom
│   ├── yue-library-base          基础库提供了丰富的Java工具包,同时也自动装配了一系列基础Bean等
│   ├── yue-library-base-crypto   基于Hutool实现的加解密模块,提供诸如数据脱敏此类的更多特性
│   ├── yue-library-web           基础库WebMvc实现,用于servlet项目
│   ├── yue-library-webflux       基础库WebFlux实现,用于响应式编程项目(如:SpringCloudGateway)
│   ├── yue-library-data-jdbc     基于SpringJDBC进行二次封装,拥有着强大性能的同时又不失简单、灵活等
│   ├── yue-library-data-redis    基于SpringRedis进行二次封装,更简单灵活,提供全局token与登录相关特性等
│   ├── yue-library-auth-service  基于SpringSecurity进行二次封装,更简单灵活,提供全局token与登录等特性
│   ├── yue-library-auth-client   auth-client为auth-service客户端模块,提供获取当前登录用户状态信息等特性
│   ├── yue-library-pay           基于pay-java-parent进行二次封装,让你真正做到一行代码实现支付聚合
│   ├── yue-library-cloud-oss
│   └── yue-library-cloud-sms
├── yue-library-samples  基础库示例
│   ├── yue-library-test        yue-library代码测试项目:单元测试、接口测试、代码示例
│   ├── yue-library-test-webflux    yue-library-webflux代码测试项目:单元测试、接口测试、代码示例
│   ├── yue-library-template-simple    yue-library模版:SpringBoot项目模版
│   └── yue-library-template-ssc    yue-library模版:SpringCloud项目模版,SOA共享架构(阿里巴巴中台)
└── yue

快速开始

引入项目依赖

maven项目,在pom.xml文件中添加如下一段代码,并将${version}替换为对应版本号:Maven Central with version prefix filter

<parent>
    <groupId>ai.ylyue</groupId>
    <artifactId>yue-library-dependencies</artifactId>
    <version>${version}</version>
</parent>

随后引入所需要的模块,如WebMvc项目引入:yue-library-web

依赖说明:yue-library-base为基础模块,一般情况下不需要单独引入,如:web、data-jdbc、data-redis等模块皆已默认依赖。

<dependencies>
    <dependency>
        <groupId>ai.ylyue</groupId>
        <artifactId>yue-library-web</artifactId>
    </dependency>
    ...
</dependencies>

启动项目

新建一个SpringBoot main方法启动类:

@SpringBootApplication
public class TestApplication {

    public static void main(String[] args) throws Exception {
        SpringApplication.run(TestApplication.class, args);
    }

}

写一个测试接口:

@RestController
@RequestMapping("/quickstart")
public class QuickstartController {

    @GetMapping("/get")
    public Result<?> get(JSONObject paramJson) {
        return ResultInfo.success(paramJson);
    }
    
}

访问接口测试,如:http://localhost:8080/quickst...

{
    "code": 200,
    "msg": "成功",
    "flag": true,
    "count": null,
    "data": {}
}

密钥交换

密钥交换加密可以实现如下几个特性:

  • 每次会话的密钥时随机的,客户端与服务端事先无需约定
  • 密钥未直接存储在客户端与服务端中,避免了泄露风险
  • 密钥交换过程中,密钥的传输是加密的

密钥交换流程

密钥交换流程

密钥交换步骤一:客户端请求传输加密公钥

  1. 客户端使用密钥存储key,请求获得服务端公钥(用于步骤二请求加密)

    • 密钥存储key:作为会话唯一键,在步骤一、步骤二、步骤三中属于必填参数
    • 密钥存储key:在用户未登录时一般会随机生成一个UUID,用户登陆后再用token作为别名
    • 密钥存储key:用户已登录情况,一般会以用户本次会话token作为存储key
  2. 服务端收到请求后,生成用于后续传输加解密的公私钥并绑定存储key
  3. 服务端将生成的公钥返回给客户端

密钥交换步骤二:客户端请求最终交换密钥

  1. 客户端获得服务端的公钥后,创建客户端自身的公私钥
  2. 客户端使用服务端的公钥加密自身生成的公钥,向服务端请求最终的交换密钥
  3. 服务端使用私钥解密获得客户端公钥
  4. 服务端生成最终交换密钥,并使用客户端公钥进行响应加密
  5. 客户端获得加密的交换密钥后使用客户端私钥解密,获得交换密钥

密钥交换步骤三(可选):客户端为服务端密钥的存储key添加别名

  • 适用场景:

    • 步骤一时用户未登录,使用临时的UUID作为服务端密钥存储key,用户登录后想使用token作为密钥存储key,方便后续传输

使用交换密钥加解密

  1. 客户端获得交换密钥后,请求需要参数加密的接口时,以约定的方式带上密钥存储key,并加密请求参数

    • 约定方式:默认为OAuth2 Token认证,故:若步骤一使用UUID作为存储key,需将token添加为存储别名
    • 约定方式:除默认方式外支持:Header传参约定、URL Param传参约定(具体传参key为服务端定义,默认key值:Yue-ExchangeKey-StorageKey)
  2. 服务端解密参数处理业务逻辑后,使用@ResponseEncrypt注解自动加密响应的data参数
  3. 客户端解密响应结果

接口说明

默认算法名称

  • RSA_AES:

        /** RSA算法,此算法用了默认补位方式为RSA/ECB/PKCS1Padding */
        RSA_ECB_PKCS1("RSA/ECB/PKCS1Padding"), 
    
        /** 默认的AES加密方式:AES/ECB/PKCS5Padding */
        AES("AES"), 
  • SM2_SM4

        /**
         * 算法EC
         */
        private static final String ALGORITHM_SM2 = "SM2";
        
        public static final String ALGORITHM_NAME = "SM4";

密钥交换-第一步:获得加密公钥

接口地址:POST /open/v2.3/keyExchange/{storageKey}
参数说明参数示例
storageKeyRESTful路径参数,密钥存储key23ef1f9418e84cc884187e1720ac1529
exchangeKeyType交换密钥类型,枚举值:RSA_AES、SM2_SM4RSA_AES

密钥交换-第二步:获得交换密钥

接口地址:POST /open/v2.3/keyExchange/{storageKey}
参数说明参数示例
storageKeyRESTful路径参数,密钥存储key23ef1f9418e84cc884187e1720ac1529
exchangeKeyType交换密钥类型,枚举值:RSA_AES、SM2_SM4RSA_AES
encryptedClientPublicKey使用服务端公钥加密的客户端公钥(encryptBase64)SsowXMaZfQiec39 ..略n.. uv/DbVr6gslrjY3Q==

密钥交换-第三步:添加存储key别名

接口地址:POST /open/v2.3/keyExchange/{storageKey}/addAlias
参数说明参数示例
storageKeyRESTful路径参数,密钥存储key23ef1f9418e84cc884187e1720ac1529
storageKeyAlias存储别名cbf55767c47e4d4e9feb90cfa2bdf5aa

配置

yue: 
  crypto:
    key-exchange:
      enabled: true # 默认false,启用密钥交换
      key-exchange-storage-type: redis # 使用redis作为密钥交换存储类型

注解使用说明

@RequestDecrypt请求解密注解:

  • 必须与@RequestBody注解一同使用
  • @RequestBody注解只支持使用Body传参,并映射为实体参数。
  • Content-Type=application/json;charset=UTF-8

        @RequestDecrypt
        @PostMapping("/decrypt")
        public Result<?> decrypt(@RequestBody UserIPO userIPO) {
            return R.success(userIPO);
        }

@ResponseEncrypt响应加密注解:

  • 必须与@ResponseBody注解一同使用,@RestController注解默认已集成@ResponseBody
  • 必须使用Result作为返回类型,并且加密的是data参数

        @ResponseEncrypt
        @GetMapping("/{encrypt}")
        public Result<?> encrypt(@PathVariable String encrypt) {
            return R.success(encrypt);
        }

收藏一波以表支持吧(≧▽≦)/!

本文由博客群发一文多发等运营工具平台 OpenWrite 发布

评论

暂无评论