maven nexus 저장소에서 라이브러리 import 오류

Nexus 저장소 사용 시 Java SSL 인증서 오류 해결 방법

문제점

초기 프로젝트를 import할 때 Nexus 저장소를 사용하는 경우, 라이브러리 다운로드 과정에서 오류가 발생할 수 있습니다. 다양한 원인이 있을 수 있지만, Nexus 서버가 HTTPS로 구성되어 있을 경우 로컬 PC에 설치된 Java 패키지에 따라 SSL 인증서 신뢰 오류가 발생할 수 있습니다.

 

Java SSL 인증서 오류가 발생하는 주요 원인

• 신뢰할 수 없는 인증서 사용
  서버가 자체 서명(Self-signed) 인증서나, 신뢰되지 않는 CA(인증기관)에서 발급한 인증서를 사용하는 경우
• 인증서 만료
  서버의 SSL 인증서가 유효기간이 지나 만료된 경우
• 인증서 체인 불완전
  중간 인증서가 누락되어 전체 인증서 체인이 완성되지 않은 경우
• 호스트명 불일치
  인증서의 CN(Common Name) 또는 SAN(Subject Alternative Name)이 실제 접속하려는 도메인과 일치하지 않는 경우
• 클라이언트(JVM) Truststore에 인증서 미등록
  서버 인증서 또는 CA 인증서가 Java의 신뢰 저장소(truststore)에 등록되어 있지 않은 경우

 

해결 방법
이번 케이스는 클라이언트(JVM) Truststore에 인증서가 등록되어 있지 않아 발생한 문제였습니다.
따라서, 로컬 PC의 Java 신뢰 저장소에 인증서를 등록해주면 문제를 해결할 수 있습니다.

인증서 등록 방법
아래 명령어를 사용하여 인증서를 Java 신뢰 저장소에 추가할 수 있습니다.

sudo keytool -import -alias [인증서별칭] -file [다운받은 인증서 파일, 예: nexus-domain.crt] -keystore $JAVA_HOME/lib/security/cacerts

 

인증서 설치 후 Java 애플리케이션을 재실행하면 정상적으로 동작하는 것을 확인할 수 있습니다.