git history 전부 없애고 reset 하는 방법

• git history 를 왜 없애야 할까?
  • 자주있는 일은 아니지만, git history를 전부 날리고 reset 해야 할 때가 있습니다..
  • 예를 들어, 서버의 비밀번호나 암복호화 key, 개인정보 등 노출되면 민감정보나 파일등이 git에 올라가 버렸다면?
  • 해당 내용을 지우고 다시 commit & push를 했지만, history를 보고 이전 commit을 불러오면 그만이므로, 해결책이 될 수 없지요.
  • 아예 history까지 날려버려서 이전의 실수(꼭 실수했을때만 reset 한다고 할 수는 없지만)를 이력까지 지웁시다.

main 혹은 develop등 남겨놓을 브랜치에서 (여기선 main)

• –orphan 은 기존커밋 이력없이…의 의미입니다. 즉, 기존 이력없이 시작하는 브랜치를 하나 만듭니다.

  git checkout --orphan latest_branch
  

새로 커밋

git add .
git commit -m "initial commit after reset"

기존 브랜치 날리고 새로 만듦

git branch -D main
git branch -m main

main에 force push하고 불필요한 내용 정리해서 repo 최적화

git push -f origin main
git gc --aggressive --prune=all

Clean Code 1장

클린 코드의 조건- 내 나름의 정리

• 1장에서는 자바나 C 창시자등 개발계의 거장들이 생각하는 좋은 코드에 대한 견해를 모아놓은 부분입니다.
• 다음은 이 분들의 의견에서 나름 공통적인 부분을 추려서 내 나름대로 정리한 내용입니다.
• 사실상 책 전체에 녹아 있는 내용이기도 합니다.

SARAM

• S : Simple

  • 내 의견 : 코드는 단순해야 합니다. 비즈니스 로직이 코드에 녹아들기 시작하면 프로젝트 자체는 복잡해집니다. 코드(클래스, 메소드 차원)이라도 심플해야 합니다.

• A : Atomic

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가 수정될 때마다 문서를 수정해줘야 하는 단점이 있습니다. 깜빡하고 문서 업데이트가 안되는 케이스가 현업에서 얼마나 자주 발생하는 지를 생각하면 절대 비추.