Protector4J v5에서 v6로 업그레이드하기

⚠️ 코드 보안을 위해 가능한 한 빨리 v6로 업그레이드하시기 바랍니다

AI를 활용한 리버스 엔지니어링으로 코드 분석의 문턱이 빠르게 낮아지고 있습니다. v5의 보호 강도는 현재의 보안 환경에 더 이상 충분하지 않으며, 계속 사용하면 코드 유출 위험이 커집니다. 보호된 애플리케이션을 가능한 한 빨리 Protector4J v6로 마이그레이션하시기 바랍니다.

1. v6로 업그레이드해야 하는 이유

AI 도구의 발전으로 코드 분석과 리버스 엔지니어링이 더 쉬워지고 있습니다. 기존의 바이트코드 난독화와 단순 암호화만으로는 새로운 보안 위협에 충분히 대응하기 어렵습니다.

Java 코드를 더욱 강력하게 보호하기 위해 Protector4J v6를 전면 재설계했습니다. 새로운 P4JX 아키텍처는 코드 암호화, 클래스 로딩, 런타임 검증, 안티 디버깅 등의 계층에 100가지가 넘는 보안 대책을 적용합니다. 고급 AI 분석 도구를 사용하더라도 보호된 코드를 리버스 엔지니어링하는 것은 여전히 매우 어렵습니다.

따라서 v6는 보호 아키텍처, 구성 방식, 명령줄 형식 및 출력 구조에서 v5와 크게 다릅니다.

2. v5와 v6의 주요 차이점

가장 중요한 변화는 v5의 암호화된 파일, 런타임 및 YAML 작업 파일을 v6에서 직접 재사용할 수 없다는 점입니다.

3. 호환 모드로 간단하게 구성하기

보호 강도가 높아지면서 v6에는 보호 범위, 런타임, 레이아웃, 호환성 및 대상 플랫폼과 관련된 옵션이 추가되었습니다. 사용자가 시작하기 전에 모든 옵션을 이해할 필요가 없도록 v6는 호환 모드를 제공합니다.

GUI에서는 Simple(권장) 모드를 사용합니다.

1. 애플리케이션 유형을 선택합니다.
2. 원본 JAR 또는 WAR를 선택합니다.
3. Java 버전과 대상 플랫폼을 선택합니다.
4. Protector4J가 애플리케이션을 검사하고 보수적인 호환 설정을 자동으로 선택하도록 합니다.
5. 출력 디렉터리를 확인하고 보호를 시작합니다.

보호 범위, Spring Boot 레이아웃, JVM 옵션, JavaFX 등을 세밀하게 제어해야 할 때만 Advanced 모드에서 조정하십시오.

명령줄에서는 --compat-apply를 사용할 수 있습니다. 애플리케이션을 검사하고 보수적인 호환성 권장 사항을 적용한 다음 보호 패키지를 생성합니다.

p4j javaapp app.jar dist --compat-apply

호환 모드는 구성을 단순화하지만 실제 실행 테스트를 대체하지 않습니다. 패키지를 생성한 후 시작, 핵심 기능, 리플렉션, 직렬화, 데이터베이스 접근 및 타사 프레임워크 동작을 확인하십시오.

4. 명령줄 형식의 전면 변경

v5 CLI는 YAML 작업 파일에 의존합니다.

p4j -t java -f java-task.yml

v6는 구성 파일 없이 모든 설정을 명령줄 인수로 지정할 수 있습니다.

# 일반 Java 애플리케이션
p4j javaapp app.jar dist --compat-apply

# Spring Boot 애플리케이션
p4j springboot app.jar dist --compat-apply

# Tomcat WAR
p4j tomcat app.war dist --compat-apply --context /app

# Java 라이브러리
p4j encode library.jar library.p4jx

애플리케이션 유형 매핑:

v6의 encode는 라이브러리의 모든 class를 보호하며 로드할 때 VLX JRE가 필요합니다. 선택한 메서드만 native 코드로 변환하면서 표준 JRE를 계속 사용하던 v5 방식과 완전히 동일한 대체 기능은 아닙니다.

v6도 작업 파일을 지원하지만, v6 GUI에서 새로 내보낸 p4j-task.yml을 사용해야 합니다.

p4j --task-file p4j-task.yml

v5 YAML 파일을 수정하여 재사용하지 마십시오. v5와 v6의 작업 형식은 호환되지 않습니다. GUI에서 다시 구성하거나 최신 CLI 문서에 따라 명령을 다시 작성하십시오.

모든 명령과 옵션은 v6 CLI 참조를 확인하십시오.

5. v5에서 v6로 마이그레이션하기

다음의 단일 흐름에 따라 마이그레이션합니다.

v5 백업 유지 → 원본 JAR/WAR 준비 → v6 호환 모드로 재생성 → 테스트 → 전환

1단계: v5 환경 유지

필요할 때 롤백할 수 있도록 정상적으로 실행되는 v5 출력 디렉터리와 시작 절차를 유지하십시오. v5 디렉터리를 덮어쓰지 마십시오.

2단계: 원본 입력 준비

v5로 암호화되지 않은 원본 JAR, Spring Boot JAR 또는 WAR를 준비하십시오. v5에서 생성된 vlxlib, 암호화된 JAR 및 vlxjre는 v6 입력으로 사용할 수 없습니다.

3단계: v6로 재생성

대화형 사용은 GUI의 Simple 모드로 시작합니다. 자동화에서는 직접 명령줄 인수와 --compat-apply를 사용합니다. 새 디렉터리에 출력하고 v5 파일과 섞지 마십시오.

4단계: v6 출력 검증

생성된 run.sh, run.command 또는 run.bat로 애플리케이션을 시작하십시오. 생성된 vlxjre를 애플리케이션과 함께 배포해야 합니다. 시스템 JRE 또는 다른 작업의 런타임으로 교체하지 마십시오.

최소한 다음 항목을 확인하십시오.

• 애플리케이션이 정상적으로 시작되고 중지되는지 확인합니다.
• 핵심 비즈니스 기능이 정상적으로 작동하는지 확인합니다.
• 리플렉션, 직렬화, ORM, Spring 프록시 및 리소스 로딩이 정상적으로 작동하는지 확인합니다.
• 모든 대상 운영 체제에서 패키지를 실제로 실행했는지 확인합니다.

5단계: 전체 패키지 전환

검증 후 v6 출력 디렉터리 전체로 전환하십시오. 이후 업데이트도 원본 JAR 또는 WAR에서 전체 패키지를 다시 생성하고 v5의 KeySeed + onlyEncryptJarFiles 부분 업데이트 방식은 사용하지 마십시오.

6. 업그레이드 권장 사항

AI 지원 리버스 엔지니어링은 코드 분석의 장벽을 빠르게 낮추고 있습니다. v5를 계속 사용하면 코드 유출 위험이 커지므로 보안을 위해 가능한 한 빨리 v6로 업그레이드할 것을 권장합니다.

병렬 마이그레이션 방식을 사용하십시오. 롤백을 위해 v5를 유지하고, v6 호환 모드로 새 패키지를 생성하여 검증한 후 프로덕션 환경을 전환하십시오.

관련 문서:

• v6 빠른 시작
• v6 CLI 참조
• v6 호환성 및 보호 범위
• v5 문서 아카이브