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에서 새 태그를 만들 수도 있음.

git 에서 tag는 언제 쓰고 어떻게 쓸까?

• Git에서 **tag(태그)**는 특정 커밋에 이름을 붙여서 식별하기 쉽게 만드는 기능입니다.
• 일반적으로 릴리즈 버전을 표시할 때 많이 사용되며, 특정 시점의 스냅샷을 의미합니다.

🎯 태그의 주요 역할

1. 릴리즈 마킹

   • 예: v1.0.0, v2.1.3
   • 배포한 버전이 어떤 커밋인지 명확하게 추적할 수 있습니다.

2. 스냅샷 저장

   • 특정 커밋에 중요한 의미를 부여하고 싶을 때 (예: 첫 배포, 테스트 완료 지점 등)

3. CI/CD 트리거용

   • 태그가 push될 때 자동 배포되도록 CI 파이프라인 설정이 가능

🛠️ 태그의 종류

1. Lightweight Tag (가벼운 태그)
   • 단순히 커밋을 가리키는 포인터
   • Git 내부적으로는 브랜치와 유사한 구조

   git tag v1.0.0
   

2. Annotated Tag (주석이 있는 태그)
   • 태그 생성자 정보, 날짜, 메시지 등을 포함
   • 릴리즈에는 보통 이걸 사용

   git tag -a v1.0.0 -m "Release version 1.0.0"
   

📤 태그 푸시 및 공유

• 태그는 기본적으로 git push로 자동 푸시되지 않음. 명시적으로 푸시해야 함:

  # 특정 태그 푸시
  git push origin v1.0.0
  
  # 모든 태그 푸시
  git push origin --tags
  

🔍 태그 확인

# 로컬 태그 목록
git tag

# 특정 태그가 가리키는 커밋 보기
git show v1.0.0

🧽 태그 삭제

# 로컬 태그 삭제
git tag -d v1.0.0

# 원격 태그 삭제
git push origin --delete v1.0.0

📦 활용 예시 (릴리즈 관리)

# 코드가 안정화된 시점
git checkout main
git pull
git tag -a v1.0.0 -m "First stable release"
git push origin v1.0.0

• CI/CD 도구(GitHub Actions, Jenkins 등)는 이 태그를 감지해서 v1.0.0을 자동으로 배포하게 할 수 있습니다.