SpringBoot與Jasypt整合，實現數據庫字段自動加密解密功能

作者：Java知識日歷 2025-03-26 08:43:17

數據庫其他數據庫

使用Jasypt可以顯著提升應用程序的數據安全性，簡化加密操作，并提供靈活的配置選項。不僅有助于滿足各種法規要求，還能提高開發效率和系統的整體穩定性。

Jasypt的好處

保護敏感信息

用戶數據: 加密存儲用戶密碼、個人身份信息（PII）、信用卡信息等敏感數據，防止未經授權的訪問。
商業機密: 保護內部業務數據和知識產權，避免數據泄露帶來的經濟損失和法律風險。

法規遵從性

GDPR: 歐盟通用數據保護條例要求對個人數據進行加密存儲。
CCPA: 加利福尼亞消費者隱私法案規定了對消費者數據的嚴格保護措施。
HIPAA: 健康保險流通與責任法案要求對醫療記錄進行加密。
PCI DSS: 支付卡行業數據安全標準要求對支付數據進行加密處理。

易于集成

注解支持: 使用@Encryptable注解可以輕松地在實體類中標記需要加密的字段，無需編寫復雜的加密邏輯。
自動處理: Jasypt會自動處理加密和解密過程，減少開發工作量。

標準化API

統一接口: 提供簡單且一致的API，使得開發者可以快速上手并實現加密功能。
文檔豐富: 提供詳細的文檔和示例代碼，幫助開發者理解和使用Jasypt。

多種加密算法

選擇多樣: Jasypt支持多種加密算法（如AES、PBEWithMD5AndDES等），可以根據具體需求選擇合適的加密方式。
自定義配置: 可以通過配置文件或環境變量靈活地設置加密參數，便于管理和維護。

動態密鑰管理

密鑰輪換: 支持密鑰輪換機制，定期更換密鑰以增強安全性。
密鑰存儲: 可以將密鑰存儲在安全的地方，如環境變量、配置服務器或秘密管理系統（如HashiCorp Vault）。

高效的加密和解密

低開銷: 設計目標是盡量減少對應用性能的影響，確保加密操作不會顯著降低系統的響應速度。
緩存機制: 使用緩存機制來提高加密和解密操作的效率。

應用場景

用戶認證系統

密碼存儲: 使用Jasypt對用戶密碼進行加密存儲，即使數據庫被攻破，攻擊者也無法輕易獲取明文密碼。
登錄驗證: 在用戶登錄時，自動解密存儲的密碼并與輸入的密碼進行比較。

電子商務平臺

訂單信息: 加密存儲用戶的支付信息和地址信息，確保交易的安全性。
客戶數據: 保護客戶的個人資料和偏好設置，防止數據泄露。

醫療信息系統

患者記錄: 加密存儲患者的病歷和個人信息，符合HIPAA法規要求。
藥物庫存: 保護敏感的藥品庫存信息，防止未授權訪問。

代碼實操

<!-- Spring Boot Starter Data JPA -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>

    <!-- MySQL Connector -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>

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

application.properties

# Database Configuration
spring.datasource.url=jdbc:mysql://localhost:3306/mytestdb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=password
spring.jpa.hibernate.ddl-auto=update

# Jasypt Configuration
jasypt.encryptor.password=yourSecretKey

在實體類中標記需要加密的字段

import org.jasypt.annotation.Encryptable;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Encryptable
    private String username;

    @Encryptable
    private String email; // 郵箱字段，需要加密

    // Getters and Setters
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

Repository

標準的JPA操作，不需要額外的配置來支持加密功能。

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    
}

Controller

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserRepository userRepository;

    @PostMapping("/")
    public User createUser(@RequestBody User user) {
        return userRepository.save(user);
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

測試

創建用戶

curl -X POST http://localhost:8080/users/ -H "Content-Type: application/json" -d '{"username": "testuser", "email": "test@example.com"}'

Respons：

{
    "id": 1,
    "username": "testuser",
    "email": "test@example.com"
}

獲取用戶

curl http://localhost:8080/users/1

Respons：

{
    "id": 1,
    "username": "testuser",
    "email": "test@example.com"
}

查看DB

username	email
testuser	YmI4NDljOGUtOWEzNy00NWVmLWExMDMtZWMyNmFkZGM4N2NhNg==

責任編輯：武曉燕來源： Java知識日歷

Jasypt 數據庫配置