一、使用步驟介紹

使用Jasypt（Java Simplified Encryption）進(jìn)行數(shù)據(jù)加密和解密主要涉及幾個(gè)步驟，包括引入依賴、配置加密密碼、加密敏感信息、將加密信息存儲(chǔ)到配置文件中，以及應(yīng)用程序啟動(dòng)時(shí)自動(dòng)解密。以下是詳細(xì)的使用說(shuō)明：

1. 引入依賴

首先，你需要在你的項(xiàng)目中引入Jasypt的依賴。如果你是使用Maven構(gòu)建項(xiàng)目，可以在pom.xml文件中添加如下依賴（注意版本號(hào)可能隨時(shí)間更新，請(qǐng)參考最新版本）：

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

可根據(jù)需要替換成最新的版本號(hào)。

2. 配置加密密碼

Jasypt需要一個(gè)密碼來(lái)進(jìn)行加密和解密操作。你可以通過(guò)以下幾種方式配置這個(gè)密碼：

在配置文件中指定：在你的application.properties或application.yml配置文件中，添加jasypt.encryptor.password配置項(xiàng)，并設(shè)置你的密碼。例如：

# application.properties
jasypt.encryptor.password=your_encryption_password

或者，在application.yml中：

jasypt:
  encryptor:
    password: your_encryption_password

• 然而，將密碼直接寫在配置文件中可能存在安全風(fēng)險(xiǎn)。因此，更推薦的做法是通過(guò)啟動(dòng)參數(shù)或環(huán)境變量來(lái)傳遞這個(gè)密碼。

• 通過(guò)啟動(dòng)參數(shù)指定：在啟動(dòng)應(yīng)用程序時(shí)，可以通過(guò)-Djasypt.encryptor.password=your_encryption_password參數(shù)來(lái)指定加密密碼。

• 使用環(huán)境變量：在某些情況下，使用環(huán)境變量來(lái)存儲(chǔ)敏感信息（如加密密碼）可能更為安全。具體方法取決于你的應(yīng)用程序部署環(huán)境。

3. 加密敏感信息

在配置加密密碼后，你可以使用Jasypt提供的工具或API來(lái)加密你的敏感信息。加密后的信息將以密文形式存儲(chǔ)。

• 使用Jasypt CLI工具：Jasypt提供了一個(gè)命令行界面（CLI）工具，允許你在命令行中加密和解密字符串。你需要下載Jasypt的jar包，并在命令行中運(yùn)行相應(yīng)的命令。

• 使用Jasypt API：在你的Java應(yīng)用程序中，你可以通過(guò)注入StringEncryptor接口的實(shí)現(xiàn)類來(lái)編程方式加密和解密字符串。這通常在你的Spring Boot應(yīng)用程序中通過(guò)自動(dòng)裝配完成。

4. 將加密信息存儲(chǔ)到配置文件中

加密敏感信息后，你需要將這些加密后的信息存儲(chǔ)到配置文件中。在Jasypt中，加密后的信息通常以ENC(...)的形式出現(xiàn)，括號(hào)內(nèi)是加密后的密文。例如：

# application.properties
datasource.password=ENC(加密后的密碼)

5. 應(yīng)用程序啟動(dòng)時(shí)自動(dòng)解密

當(dāng)你的Spring Boot應(yīng)用程序啟動(dòng)時(shí)，Jasypt會(huì)自動(dòng)檢測(cè)配置文件中的ENC(...)字符串，并使用你配置的加密密碼來(lái)解密這些字符串。解密后的明文將用于應(yīng)用程序的配置中。

注意事項(xiàng)

• 安全性：確保你的加密密碼足夠復(fù)雜且安全存儲(chǔ)，避免將密碼直接寫在配置文件中。
• 版本兼容性：注意你使用的Jasypt版本與其他庫(kù)或框架的兼容性。
• 算法選擇：Jasypt支持多種加密算法，你可以根據(jù)需要在配置文件中指定加密算法。

通過(guò)以上步驟，你可以在你的Spring Boot應(yīng)用程序中使用Jasypt來(lái)加密和解密配置文件中的敏感信息。

二、使用示例代碼

1、通過(guò)工具類生成密文

在application.properties 中增加配置，或者通過(guò)-Djasypt.encryptor.password=123456參數(shù)來(lái)指定加密密碼

# 用于加密的密碼
jasypt.encryptor.password=123456

使用 stringEncryptor.encrypt() 生成密文

public class JasyptSecretTest {
    @Autowired
    private StringEncryptor stringEncryptor;
    @Value("${datasource.password}")
    private String password;
    @Test
    public void encrypt(){
        // 加密
        String encrypt = stringEncryptor.encrypt("root");
        System.out.println("encrypt = " + encrypt);
    }
}

2、在application.properties 中增加配置密文

# 加密后的密文，包裹在ENC() 中
datasource.password=ENC(grdksstYZMsPmwvA0ALHXpzBQN2YTyA3t4ow1PDfJzbl+UV0LdO8UlajWKeqUF7y)
# 用于加密的密碼
jasypt.encryptor.password=123456

3、使用 @Value() 獲取明文，也可以通過(guò)stringEncryptor.decrypt(encrypt)手動(dòng)解密

@SpringBootTest
public class JasyptSecretTest {
    @Autowired
    private StringEncryptor stringEncryptor;
    @Value("${datasource.password}")
    private String password;
    @Test
    public void encrypt(){
        // 加密
        String encrypt = stringEncryptor.encrypt("root");
        System.out.println("encrypt = " + encrypt);
        // 解密，輸入獲取的加密字符串進(jìn)行解密
        String decrypt = stringEncryptor.decrypt(encrypt);
        System.out.println("decrypt = " + decrypt);
    }
    @Test
    public void show(){
        System.out.println("password = " + password);
    }
}

原理說(shuō)明

SpringBoot項(xiàng)目在啟動(dòng)過(guò)程中，會(huì)自動(dòng)注入beanStringEncryptor，用于根據(jù)不同的加密算法初始化不同的加解密實(shí)現(xiàn)類，通過(guò)StringEncryptorBuilder.build()初始化不同的加密算法

BeanNamePlaceholderRegistryPostProcessor

@Bean(name = ENCRYPTOR_BEAN_NAME)
public StringEncryptor stringEncryptor(
        final EnvCopy envCopy,
        final BeanFactory bf) {
    final String customEncryptorBeanName = envCopy.get().resolveRequiredPlaceholders(ENCRYPTOR_BEAN_PLACEHOLDER);
    final boolean isCustom = envCopy.get().containsProperty(ENCRYPTOR_BEAN_PROPERTY);
    return new DefaultLazyEncryptor(envCopy.get(), customEncryptorBeanName, isCustom, bf);
}

通過(guò)EncryptableMapPropertySourceWrapper重寫了getProperty()方法，在獲取配置值的時(shí)候，再做解密返回明文

DefaultPropertyResolver

@Override
public String resolvePropertyValue(String value) {
    return Optional.ofNullable(value)
            .map(environment::resolvePlaceholders)
            .filter(detector::isEncrypted)
            .map(resolvedValue -> {
                try {
                    // 獲取密文
                    String unwrappedProperty = detector.unwrapEncryptedValue(resolvedValue.trim());
                    String resolvedProperty = environment.resolvePlaceholders(unwrappedProperty);
                    // 執(zhí)行解密操作
                    return encryptor.decrypt(resolvedProperty);
                } catch (EncryptionOperationNotPossibleException e) {
                    throw new DecryptionException("Unable to decrypt property: " + value + " resolved to: " + resolvedValue + ". Decryption of Properties failed,  make sure encryption/decryption " +
                            "passwords match", e);
                }
            })
            .orElse(value);
}

三、Jasypt配置項(xiàng)

Jasypt支持多種配置參數(shù)以進(jìn)行密碼、Digest認(rèn)證、文本和對(duì)象的加密。以下是Jasypt支持的一些常見(jiàn)配置參數(shù)：

注意：

• 這些參數(shù)主要用于配置Jasypt加密器（StringEncryptor）的行為。
• 在實(shí)際使用中，特別是生產(chǎn)環(huán)境中，jasypt.encryptor.password等敏感信息不應(yīng)該硬編碼在配置文件中，而是通過(guò)環(huán)境變量、命令行參數(shù)或外部配置文件等方式安全地傳遞。
• Jasypt支持多種加密算法，如PBEWithMD5AndDES、PBEWithHMACSHA512ANDAES_256等，具體選擇哪種算法取決于安全需求和環(huán)境配置。
• 上述表格中的示例配置參數(shù)值僅為演示用途，實(shí)際使用時(shí)需要根據(jù)項(xiàng)目需求和安全策略進(jìn)行配置。

四、支持的加密算法

Jasypt支持多種加密算法以保護(hù)敏感數(shù)據(jù)。以下是Jasypt支持的一些常見(jiàn)加密算法：

以上就是SpringBoot3使用Jasypt加密數(shù)據(jù)庫(kù)用戶名、密碼等敏感信息的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot3 Jasypt加密數(shù)據(jù)庫(kù)信息的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論