AES 암복호화를 위한 key생성 코드로 만들기

Contents

AES 암호화 알고리즘에 대하여.

• 암복호화가 가능한 대표적인 양방향 알고리즘입니다.
• 자료상으로 찾아보면 AES(Advanced Encryption Standard)는 대칭 키 암호화 방식의 대표적인 알고리즘으로, 미국 국립표준기술연구소(NIST)에 의해 2001년 표준으로 채택되었습니다. Rijndael 알고리즘을 기반으로 설계되었으며, 높은 보안성과 빠른 성능 덕분에 다양한 보안 애플리케이션에서 널리 사용되고 있습니다.

AES 특징

• 대칭 키 암호화: 동일한 키를 사용하여 데이터를 암호화 및 복호화합니다.
• 고정된 블록 크기: AES는 128비트 블록 크기를 사용합니다.
• 다양한 키 길이 지원: 128비트, 192비트, 256비트 키 길이를 제공합니다.
• 보안성: 기존의 DES(Data Encryption Standard)보다 강력한 보안성을 자랑합니다.
• 빠른 속도: 소프트웨어 및 하드웨어에서 효율적으로 동작합니다.

AES 암호화 과정

• AES 암호화는 여러 라운드(Round)의 연산을 통해 이루어집니다. 사용되는 키 길이에 따라 라운드 수가 달라집니다.

Java에서 AES를 사용하기 위해 key, iv 등 생성하는 코드

• 알고리즘은 AES-128, AES-192, AES-256 어떤 걸 사용하느냐에 따라 key, iv자체의 size가 달라질 수 있습니다
• 본 글에서는 AES/CBC/PKCS5Padding 256 을 기반으로 했습니다.

Java에서 암복호화에 사용하기 위한 key, iv 는 어떻게 만들까?

• 현업에서는 key, iv를 데이터 제공 측과 소비측에서 양쪽에서 key, iv를 공유하는데 key, iv를 만드는 방법도 다양했습니다.
• 본 글에서 다양한 케이스를 코드로 처리한 내용을 적어봅니다.
• 대체로 key,iv는 base64혹은 hex등으로 encode해서 저장하고, runtime에 decode해서 쓰는 것이 일반적입니다.

key 만들기 다양한 방법

• base64등 encode 없이 그냥 문자열로 만들기

    public String generateRandomString() {
        String CHARACTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*()-_=+";
        SecureRandom random = new SecureRandom();
        StringBuilder sb = new StringBuilder(32);

        for (int i = 0; i < 32; i++) {
            sb.append(CHARACTERS.charAt(random.nextInt(CHARACTERS.length())));
        }

        return sb.toString();
    }

• base64는 java.util 을 쓰기도 하고 apache.commons.codec.binary등을 쓸 수 있습니다.

    public void keyGenerator() throws NoSuchAlgorithmException {
        // 1. Secret Key 생성 (AES-256)
        KeyGenerator keyGenerator = KeyGenerator.getInstance("AES");
        keyGenerator.init(256); // AES-256 사용
        SecretKey secretKey = keyGenerator.generateKey();

        // 2. IV 생성 (AES CBC 모드에서는 16바이트 IV 필요)
        byte[] iv = new byte[16];
        SecureRandom secureRandom = new SecureRandom();
        secureRandom.nextBytes(iv);

        // 3. Base64로 인코딩하여 출력
        System.out.println("Secret Key (Base64): " + Base64.getEncoder().encodeToString(secretKey.getEncoded()));
        System.out.println("IV (Base64): " + Base64.getEncoder().encodeToString(iv));
    }

• base64

    public void generateBase64RandomKey() {
        int AES_KEY_SIZE = 32; //256 bit
        int IV_SIZE = 16;

        byte[] secretKeyBytes = new byte[AES_KEY_SIZE];
        byte[] ivBytes = new byte[IV_SIZE];

        new SecureRandom().nextBytes(secretKeyBytes);
        new SecureRandom().nextBytes(ivBytes);

        log.info("secretKeyBytes: {}", Base64.getEncoder().encodeToString(secretKeyBytes));
        log.info("ivBytes: {}", Base64.getEncoder().encodeToString(ivBytes));
    }

• hex

    public void generateHexRandomKey() {
        int AES_KEY_SIZE = 32; //256 bit
        int IV_SIZE = 16;

        byte[] secretKeyBytes = new byte[AES_KEY_SIZE];
        byte[] ivBytes = new byte[IV_SIZE];

        new SecureRandom().nextBytes(secretKeyBytes);
        new SecureRandom().nextBytes(ivBytes);

        log.info("secretKeyBytes: {}", bytesToHex(secretKeyBytes));
        log.info("ivBytes: {}", bytesToHex(ivBytes));
    }

• 32byte(256bit) 랜덤 문자열 만들고, base64 encode 하기

    public void generateRandomStringAndGenerateKey() {
        int size = 32;
        String CHARACTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*()-_=+";
        SecureRandom random = new SecureRandom();
        StringBuilder sb = new StringBuilder(size);

        for (int i = 0; i < size; i++) {
            sb.append(CHARACTERS.charAt(random.nextInt(CHARACTERS.length())));
        }

        String secretKeyBase64 = Base64.getEncoder().encodeToString(sb.toString().getBytes());
        String ivBase64 = Base64.getEncoder().encodeToString(sb.substring(0,16).getBytes());
    }

• 32byte 문자열을 사용해서 base64 encode 하기

    public void generateKeyWithString() {
        String input = "YOUR 32자리 문자열";
        String secretKeyBase64 = Base64.getEncoder().encodeToString(input.getBytes());
        String ivBase64 = Base64.getEncoder().encodeToString(input.substring(0,16).getBytes());
        String decoded = new String(Base64.getDecoder().decode(secretKeyBase64));
    }

내 우분투 서버에 SSL 무료 설치하기

• SSL 발급 사이트 : https://zerossl.com/ 다른 무료 사이트도 많이 있습니다만 여기서 다 나열할 필요는 없을 듯 합니다..
• 내가 쓰는 도메인 서비스 업체 : whois

SSL 설치 절차

• 무료 SSL의 제약사항은 별도로 알아보기로 하고
• 기본 개념은 먼저 인증기관으로 부터 해당 도메인의 소유주가 맞는지 확인을 받고 인증기관으로부터 SSL인증서와 key를 받아서 서버에 설치했음을 검증받으면 SSL발급을 완료했다고 할 수 있습니다..
• 이를 DV(Domain Validation) 이라고 하는데, 소규모 사이트나 개발서버에서 간략하게 무료로 발급받아 사용시에 사용합니다.

도메인 소유주임을 확인 받기

1. ZeroSSL에 회원가입
2. SSL Certificate Setup 에서 각 항목 채워줍니다.

• Domains
• Validity : 90-Day Certificate 로 해야 무료
• Add-Ons : 아무것도 선택하지 않아야 무료 가능
• CSR & Contact : Auto-Generate CSR 활성화
• Finalize Your Order: Free 선택

Restdoc Swagger Ui Sample

서론

• 개발에서 테스트 코드의 중요성에 대해서는 따로 포스팅 예정입니다.

• 백엔드에서 api 개발시 해당 api의 사용법에 대한 문서화는 협업에서 필수입니다.

• 가장 무식한 방법으로는 confluence가 되었든 wiki가 되었든, 엑셀이 되었든 api 개발이 있을때 마다 수작업으로 문서화하는 방법이 있는데 api가 수정될 때마다 문서를 수정해줘야 하는 단점이 있습니다. 깜빡하고 문서 업데이트가 안되는 케이스가 현업에서 얼마나 자주 발생하는 지를 생각하면 절대 비추.

@Component 내에 static method 에서 쓰는 member 객체가 null 일떄

@Component 내에 static method에서 사용하는 static member

@Component
@RequiredArgsConstructor
public class SomeComponentClass {

    private final ObjectMapper objectMapper;

    private static void staticMethod() {
        objectMapper.convertValue() // objectMapper NullPointerException 발생
    } 
}

-> 이렇게 바꾸세요.

@Component
@RequiredArgsConstructor
public class SomeComponentClass {

    private static ObjectMapper objectMapper;

    // Autowired로 constructor 생성
    @Autowired
    public SomeComponentClass(ObjectMapper objectMapper) {
        SomeComponentClass.objectMapper = objectMapper;
    }

    private static void staticMethod() {
        objectMapper ~~~
    }
}

서론

• GitHub에서 **태그(Tag)**를 기반으로 **릴리즈(Release)**를 만들면,
• 릴리즈 노트를 작성하고, 바이너리 파일(zip, tar.gz 등)을 첨부할 수 있어서 배포에 아주 유용합니다..
• 아래에 GitHub 릴리즈 생성 및 연동 방법을 정리합니다. 👇

🎁 GitHub 릴리즈란?

• 특정 태그에 대한 릴리즈 정보를 시각화해서 보여주는 GitHub의 기능
• 릴리즈 노트 작성 가능
• 실행 파일, 아티팩트(.zip, .jar 등) 첨부 가능
• GitHub Actions 같은 CI 도구와 쉽게 연동 가능

🛠️ GitHub 릴리즈 만드는 방법

1. Git 태그 만들기 (로컬 or GitHub에서)

# 로컬에서 annotated tag 만들기
git tag -a v1.0.0 -m "Release version 1.0.0"

# 원격 푸시
git push origin v1.0.0

또는 GitHub 웹 UI에서 새 태그를 만들 수도 있음.