[java] Jasypt를 활용한 자바 애플리케이션에서의 파일 암호화 및 안전한 저장 방법

17 Nov 2023

java

자바 개발자들은 암호화를 통해 파일을 안전하게 저장하는 방법에 많은 관심을 가지고 있습니다. Jasypt는 자바 애플리케이션에서 간단하고 안전한 암호화 및 복호화 기능을 제공하는 라이브러리입니다. 이 블로그 포스트에서는 Jasypt를 사용하여 자바 애플리케이션에서 파일을 암호화하고 안전하게 저장하는 방법을 알아보겠습니다.

1. Jasypt 설치

Jasypt를 사용하기 위해서는 먼저 Jasypt 라이브러리를 다운로드하고 프로젝트에 추가해야 합니다. Maven을 사용하는 경우, pom.xml 파일에 다음 의존성을 추가합니다:

<dependency>
    <groupId>org.jasypt</groupId>
    <artifactId>jasypt</artifactId>
    <version>1.9.3</version>
</dependency>

Gradle을 사용하는 경우, build.gradle 파일에 다음 의존성을 추가합니다:

implementation 'org.jasypt:jasypt:1.9.3'

의존성을 추가한 후 프로젝트를 빌드하면 Jasypt를 사용할 준비가 끝납니다.

2. 파일 암호화

Jasypt를 사용하여 파일을 암호화하는 것은 매우 간단합니다. 다음 예제 코드를 보면서 암호화 과정을 이해해 보겠습니다.

import org.jasypt.encryption.pbe.StandardPBEStringEncryptor;

public class FileEncryptionUtil {

    public void encryptFile(String filePath, String password) {
        // 암호화된 데이터를 저장할 파일 생성
        String encryptedFilePath = filePath + ".encrypted";
        File encryptedFile = new File(encryptedFilePath);

        // Jasypt 암호화 객체 생성
        StandardPBEStringEncryptor encryptor = new StandardPBEStringEncryptor();
        encryptor.setPassword(password);

        try {
            // 파일 읽기
            String fileContent = readFile(filePath);

            // 파일 내용 암호화
            String encryptedContent = encryptor.encrypt(fileContent);

            // 암호화된 내용을 파일에 저장
            writeFile(encryptedFile, encryptedContent);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private String readFile(String filePath) throws IOException {
        // 파일 읽기 로직 구현
    }

    private void writeFile(File file, String content) throws IOException {
        // 파일 쓰기 로직 구현
    }
}

위 예제 코드에서는 StandardPBEStringEncryptor를 사용하여 암호화 프로세스를 수행합니다. encryptor.setPassword(password)를 통해 암호화에 사용될 비밀번호를 설정하고, encryptor.encrypt(fileContent)를 호출하여 파일 내용을 암호화합니다. 암호화된 내용은 새로운 파일에 저장됩니다.

3. 파일 복호화

파일을 복호화하는 것도 마찬가지로 간단합니다. 다음 예제 코드를 통해 복호화 과정을 살펴보겠습니다.

public class FileDecryptionUtil {

    public void decryptFile(String encryptedFilePath, String password) {
        // 복호화된 데이터를 저장할 파일 생성
        String decryptedFilePath = encryptedFilePath.replace(".encrypted", ".decrypted");
        File decryptedFile = new File(decryptedFilePath);

        // Jasypt 복호화 객체 생성
        StandardPBEStringEncryptor decryptor = new StandardPBEStringEncryptor();
        decryptor.setPassword(password);

        try {
            // 암호화된 파일 읽기
            String encryptedContent = readFile(encryptedFilePath);

            // 파일 내용 복호화
            String decryptedContent = decryptor.decrypt(encryptedContent);

            // 복호화된 내용을 파일에 저장
            writeFile(decryptedFile, decryptedContent);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private String readFile(String filePath) throws IOException {
        // 파일 읽기 로직 구현
    }

    private void writeFile(File file, String content) throws IOException {
        // 파일 쓰기 로직 구현
    }
}

위 코드에서는 StandardPBEStringEncryptor를 사용하여 파일을 복호화합니다. 암호화된 파일을 읽어와 decryptor.decrypt(encryptedContent)를 호출하여 내용을 복호화합니다. 복호화된 내용은 새로운 파일에 저장됩니다.

4. 안전한 저장 및 접근 방법

파일을 안전하게 저장하고 접근하기 위해서는 암호화에 사용되는 비밀번호를 안전하게 보관하는 것이 중요합니다. 다음은 몇 가지 안전한 저장 및 접근 방법의 예입니다:

비밀번호를 환경 변수로 설정하여 사용: 애플리케이션 실행 시 비밀번호를 환경 변수로 지정하여 사용하는 것은 비밀번호를 코드 내에 하드 코딩하는 것보다 안전합니다.
비밀번호 관리 도구 사용: 비밀번호 관리 도구를 사용하여 비밀번호를 안전하게 저장하고 접근할 수 있습니다. 예를 들어, AWS Secrets Manager를 사용하여 비밀번호를 저장하고 필요할 때마다 조회하는 방법도 있습니다.
별도의 보안 저장소 사용: 비밀번호를 별도의 보안 저장소에 저장하고 액세스 제어를 설정하여 안전하게 접근할 수 있습니다.

마무리

이 블로그 포스트에서는 Jasypt를 사용하여 자바 애플리케이션에서 파일을 암호화하고 안전하게 저장하는 방법을 알아보았습니다. Jasypt를 사용하면 암호화와 복호화 과정이 간단하고 효율적이며, 개발자들은 애플리케이션의 보안성을 향상시킬 수 있습니다.