如何轻松给Spring Boot配置文件加个密?

本文涉及的产品
密钥管理服务KMS,1000个密钥,100个凭据,1个月
简介: 如何轻松给Spring Boot配置文件加个密?

在实践中,项目的某些配置信息是需要进行加密处理的,以减少敏感信息泄露的风险。比如,在使用Druid时,就可以基于它提供的公私钥加密方式对数据库的密码进行加密。

但更多时候,比如Redis密码、MQ密码等敏感信息,也需要进行加密,此时就没那么方便了。本篇文章给大家介绍一款Java类库Jasypt,同时基于Spring Boot项目来演示一下如何对配置文件信息进行加密。

一个简单的SpringBoot项目

我们先来创建一个简单的Spring Boot项目,构建一个加密数据运用的场景。

无论通过Idea或官网等方式,先创建一个Spring Boot项目,核心依赖为:

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--    为了方便,通常会引入Lombok依赖    -->
<dependency>
 <groupId>org.projectlombok</groupId>
 <artifactId>lombok</artifactId>
</dependency>

创建一个配置文件类ConfigProperties:

@Data
@Component
public class ConfigProperties {
 @Value("${conf.url}")
 private String url;
 @Value("${conf.password}")
 private String password;
}

配置文件中的配置属性注入到该类,以供后续使用。

创建一个Controller类,用来测试验证,是否能够正常运行:

@RestController
@RequestMapping("/")
public class ConfigController {
 @Resource
 private ConfigProperties configProperties;
 @RequestMapping
 public void print(){
  System.out.println(configProperties.getUrl());
  System.out.println(configProperties.getPassword());
 }
}

对应ConfigProperties类,application.properties中配置如下:

conf.url=127.0.0.1
conf.password=admin123

此时,启动项目,访问Controller,能够正常打印出配置信息,说明程序可以正常运行。

但配置文件中直接明文展示了password项,如果别人看到该配置文件,就可能导致密码的泄露。

基于Jasypt的加密

针对上述情况,通常,我们会对敏感信息进行加密,避免明文密码信息暴露,提升安全等级。

加密的基本思路是:配置文件中存储加密内容,在解析配置文件注入时进行解密。

但如果拿到项目源码,知道加密算法和秘钥,肯定是可以解密的。这里的加密,只是多一层安全防护,但并不是万能的。

下面看看如何基于Jasypt来进行加密处理。

集成步骤

下面基于上述Spring Boot项目进行改造升级。

环境准备

不同版本的Jasypt使用方法有所不同,这里基于3.0.4版本、JDK8、Spring Boot 2.5.5来进行演示。

在使用之前,首先检查一下JDK8的JRE中是否安装了不限长度的JCE版本,否则在执行加密操作时会抛出解密失败的异常。

进入$JAVA_HOME/jre/lib/security目录,查看是否包含local_policy.jar和US_export_policy.jar两个jar包。如果不包含,则通过Oracle官网进行下载,下载地址:https://www.oracle.com/java/technologies/javase-jce8-downloads.html

下载文件为:jce_policy-8.zip

文件内包含三个文件:

README.txt
local_policy.jar
US_export_policy.jar

查看$JAVA_HOME/jre/lib/security目录下是否有这两个jar包文件,如果没有则复制进去,如果有可考虑覆盖。

引入依赖

在Spring Boot中集成Jasypt比较简单,直接引入如下依赖即可:

<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.4</version>
</dependency>

此时,Jasypt组件自动配置便已经生效,只需要对需要加密的数据进行处理了。

为了方便对密码进行加密,还可以在pom.xml中的build元素中引入对应的plugin,这个后面会用到:

<plugin>
 <groupId>com.github.ulisesbocchio</groupId>
 <artifactId>jasypt-maven-plugin</artifactId>
 <version>3.0.4</version>
</plugin>

至此,所有的准备工作已经完成。

内容加密

内容加密有多种方式,这里挑选两种方式进行介绍。

方式一:单元测试类生成密文;

构建如下单元测试类,使用默认实例化的StringEncryptor对密码进行加密:

@SpringBootTest
class SpringBootJasyptApplicationTests {
 @Autowired
 private StringEncryptor stringEncryptor;
 @Test
 void contextLoads() {
  String qwerty1234 = stringEncryptor.encrypt("admin123");
  System.out.println(qwerty1234);
 }
}

其中,”admin123“便是要加密的内容。执行上述程序,便可打印加密后的内容。这种形式加密的内容,全部采用默认值。

方式二:通过Maven插件生成密文

在上面已经引入了Jasypt的Maven插件,可通过对应的命令进行生成密码。

第一步:在配置文件中添加加密的密码:

jasypt.encryptor.password=afx11

然后对配置文件中需要加密的数据进行改造,在数据前添加”DEC(“,在数据尾部加上")",修改完如下:

conf.password=DEC(admin123)

这里添加的DEC()是告诉插件,此部分内容需要进行加密处理。注意这里关键字是DEC。

第二步:执行Maven命令,对上述数据进行加密处理

在命令执行以下命令:

mvn jasypt:encrypt -Djasypt.encryptor.password=afx11

此时再看配置文件中的conf.password数据已经变为:

jasypt.encryptor.password=afx11
conf.url=127.0.0.1
conf.password=ENC(209eBdF3+jsV2f8kDjs4NOCzgBxnVgETlR5q2KfhYo5DW2jqvLknv0TndEkXOXm0)

注意原来的DEC变成了ENC,原来的明文密码变成了加密的密文。

此时,如果想查看明文,执行以下命令即可:

mvn jasypt:decrypt -Djasypt.encryptor.password=afx11

该命令不会修改配置文件中的密文为明文,只会在控制台进行明文结果的输出。

jasypt.encryptor.password=afx11
conf.url=127.0.0.1
conf.password=DEC(admin123)

经过上述操作,所有改造步骤已经完成,只需启动系统进行验证即可。

密码的传递方式

完成上述步骤,直接启动系统,访问对应的请求,会发现已经能够成功打印出密码原文了。

上述实例中我们将加密的密码放在了application.properties文件中,这样并不安全,如果查看代码就知道如何解密了。通常,还可以采用另外一种形式来传递参数:在启动命令中传输密码。

比如:

java -jar jasypt-spring-boot-demo-0.0.1-SNAPSHOT.jar --jasypt.encryptor.password=password

这样,密码便不用存储在代码当中了,一定程度上增加了安全性。当然,也可以通过环境变量来进行传递,这样即便开发人员也无法获得生产的密码。

小结

关于Jasypt的使用及与Spring Boot的集成就讲这么多,更多内容也可参考官方文档说明。如果你的项目中还存在很多明文存储的密码,真的有必要考虑使用类似的框架进行加密处理了。

示例源码地址:https://github.com/secbr/springboot-all/tree/master/springboot-jasypt

官方源码地址:https://github.com/ulisesbocchio/jasypt-spring-boot

目录
相关文章
|
4月前
|
Java Spring
Spring boot 运行服务jar外配置配置文件方式总结
Spring boot 运行服务jar外配置配置文件方式总结
918 0
|
1月前
|
XML Java 数据格式
Spring从入门到入土(xml配置文件的基础使用方式)
本文详细介绍了Spring框架中XML配置文件的使用方法,包括读取配置文件、创建带参数的构造对象、使用工厂方法和静态方法创建对象、对象生命周期管理以及单例和多例模式的测试。
83 7
Spring从入门到入土(xml配置文件的基础使用方式)
|
21天前
|
Java API Spring
在 Spring 配置文件中配置 Filter 的步骤
【10月更文挑战第21天】在 Spring 配置文件中配置 Filter 是实现请求过滤的重要手段。通过合理的配置,可以灵活地对请求进行处理,满足各种应用需求。还可以根据具体的项目要求和实际情况,进一步深入研究和优化 Filter 的配置,以提高应用的性能和安全性。
|
8天前
|
网络协议 Java
springboot配置hosts文件
springboot配置hosts文件
35 11
|
4天前
|
存储 运维 安全
Spring运维之boot项目多环境(yaml 多文件 proerties)及分组管理与开发控制
通过以上措施,可以保证Spring Boot项目的配置管理在专业水准上,并且易于维护和管理,符合搜索引擎收录标准。
15 2
|
1月前
|
SQL JSON Java
mybatis使用三:springboot整合mybatis,使用PageHelper 进行分页操作,并整合swagger2。使用正规的开发模式:定义统一的数据返回格式和请求模块
这篇文章介绍了如何在Spring Boot项目中整合MyBatis和PageHelper进行分页操作,并且集成Swagger2来生成API文档,同时定义了统一的数据返回格式和请求模块。
52 1
mybatis使用三:springboot整合mybatis,使用PageHelper 进行分页操作,并整合swagger2。使用正规的开发模式:定义统一的数据返回格式和请求模块
|
1月前
|
Java 测试技术 Spring
springboot学习三:Spring Boot 配置文件语法、静态工具类读取配置文件、静态工具类读取配置文件
这篇文章介绍了Spring Boot中配置文件的语法、如何读取配置文件以及如何通过静态工具类读取配置文件。
46 0
springboot学习三:Spring Boot 配置文件语法、静态工具类读取配置文件、静态工具类读取配置文件
|
1月前
|
消息中间件 Java 大数据
大数据-56 Kafka SpringBoot与Kafka 基础简单配置和使用 Java代码 POM文件
大数据-56 Kafka SpringBoot与Kafka 基础简单配置和使用 Java代码 POM文件
65 2
|
1月前
|
缓存 NoSQL Java
Springboot自定义注解+aop实现redis自动清除缓存功能
通过上述步骤,我们不仅实现了一个高度灵活的缓存管理机制,还保证了代码的整洁与可维护性。自定义注解与AOP的结合,让缓存清除逻辑与业务逻辑分离,便于未来的扩展和修改。这种设计模式非常适合需要频繁更新缓存的应用场景,大大提高了开发效率和系统的响应速度。
58 2
|
2月前
|
消息中间件 NoSQL 安全
(转)Spring Boot加载 不同位置的 application.properties配置文件顺序规则
这篇文章介绍了Spring Boot加载配置文件的顺序规则,包括不同位置的application.properties文件的加载优先级,以及如何通过命令行参数或环境变量来指定配置文件的名称和位置。