快捷導(dǎo)航

使用jasypt在springboot中加密敏感信息

更新時(shí)間：2026年02月07日 08:28:27 作者：牧云2800

Jasypt是一個(gè)簡(jiǎn)化Java加密操作的輕量級(jí)庫(kù),支持與Spring Boot深度集成,通過ENC(密文)格式實(shí)現(xiàn)配置文件的自動(dòng)加解密,本文就來介紹一下springboot jasypt 加密敏感,感興趣的可以了解一下

1.簡(jiǎn)介

jasypt（Java Simplified Encryption）是一個(gè)輕量級(jí)Java加密庫(kù)，專為簡(jiǎn)化應(yīng)用程序加密操作而設(shè)計(jì)，通過易用API幫助開發(fā)者無需深入密碼學(xué)知識(shí)即可實(shí)現(xiàn)敏感數(shù)據(jù)保護(hù)。其核心特性包括：與Spring Boot深度集成實(shí)現(xiàn)配置屬性的自動(dòng)加解密（使用ENC(密文)格式即可自動(dòng)解密）；支持多種主流算法如PBEWithMD5AndDES和默認(rèn)的PBEWITHHMACSHA512ANDAES_256；采用分離式密鑰管理機(jī)制，要求加密密鑰必須通過環(huán)境變量或命令行動(dòng)態(tài)注入，杜絕密鑰泄露風(fēng)險(xiǎn)；提供完善的工具鏈如Maven插件支持命令行加密、配置文件動(dòng)態(tài)解密代理及自定義鹽生成器/IV向量等參數(shù)配置。典型應(yīng)用場(chǎng)景涵蓋保護(hù)Spring Boot配置文件中的數(shù)據(jù)庫(kù)密碼/API密鑰、實(shí)現(xiàn)日志/數(shù)據(jù)庫(kù)的PII信息脫敏，以及滿足GDPR/等保2.0等合規(guī)要求，其通過AES-256等標(biāo)準(zhǔn)算法結(jié)合隨機(jī)鹽與迭代哈希，在密鑰妥善保管時(shí)可提供極高安全性保障。

項(xiàng)目地址：https://github.com/ulisesbocchio/jasypt-spring-boot

2.加密敏感信息

2.1 引入Maven加密插件

在pom.xml中添加：

<build>
  <plugins>
   <plugin>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-maven-plugin</artifactId>
    <version>3.0.5</version>
   </plugin>
  </plugins>
</build>

2.2 執(zhí)行加密命令

在項(xiàng)目目錄執(zhí)行：

mvn jasypt:encrypt-value \
 -Djasypt.encryptor.password="your-password" \
 -Djasypt.plugin.value="原始敏感值"

控制臺(tái)輸出加密結(jié)果（如ENC(In+7esX42WEldd+Wzr4FaI2H2w6d0jXMWfUM1m6HbR+43kV0J7Qq9uXYeGqQqJh6)），復(fù)制備用。

3.在Spring Boot中使用

3.1 添加依賴

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

3.2 配置文件

在application.properties中：

apiKey=ENC(In+7esX42WEldd+Wzr4FaI2H2w6d0jXMWfUM1m6HbR+43kV0J7Qq9uXYeGqQqJh6)
jasypt.encryptor.iv-generator-classname=org.jasypt.iv.NoIvGenerator
jasypt.encryptor.algorithm=PBEWithMD5AndDES

3.3 Java類示例

@SpringBootApplication
public class DemoApplication implements CommandLineRunner {
    @Value("${apiKey}")
    private String apiKey;
    
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
    
    @Override
    public void run(String... args) {
        System.out.println("apiKey = " + apiKey);
    }
}

3.4 啟動(dòng)應(yīng)用

通過環(huán)境變量傳遞密鑰：

export JASYPT_ENCRYPTOR_PASSWORD=your-password
java -jar app.jar

IDEA中環(huán)境變量使用如下方式傳入：

或使用命令行參數(shù)：

java -jar app.jar --jasypt.encryptor.password=your-password

4.注意事項(xiàng)

密鑰安全：切勿將加密密鑰寫入配置文件或代碼
密鑰傳遞方式：
- 環(huán)境變量：export JASYPT_ENCRYPTOR_PASSWORD=密鑰
- 命令行參數(shù)：java -jar app.jar --jasypt.encryptor.password=密鑰
加解密算法需保持一致

5.進(jìn)階配置參數(shù)

參數(shù)	必需	默認(rèn)值
jasypt.encryptor.password	是	-
jasypt.encryptor.algorithm	否	PBEWITHHMACSHA512ANDAES_256
jasypt.encryptor.key-obtention-iterations	否	1000
jasypt.encryptor.pool-size	否	1
jasypt.encryptor.provider-name	否	SunJCE
jasypt.encryptor.provider-class-name	否	null
jasypt.encryptor.salt-generator-classname	否	org.jasypt.salt.RandomSaltGenerator
jasypt.encryptor.iv-generator-classname	否	org.jasypt.iv.RandomIvGenerator
jasypt.encryptor.string-output-type	否	base64
jasypt.encryptor.proxy-property-sources	否	false
jasypt.encryptor.skip-property-sources	否	empty list