
먼저 확인하세요: 내 Tomcat·Java 버전에 맞는 형식
Tomcat과 Java 버전에 따라 쓰는 파일 형식(확장자)과 server.xml 작성 방식이 달라요. 아래 표에서 내 환경을 먼저 찾아보세요. java -version과 Tomcat 버전은 서버에서 확인할 수 있어요.
| 내 환경 | 쓸 수 있는 형식 | server.xml 방식 |
|---|---|---|
| Tomcat 8.5 이상 (9, 10.1, 11 포함) | PFX(.pfx·.p12, PKCS12) 또는 JKS(.jks) | SSLHostConfig 안의 Certificate에 적어요. 이 글의 예시가 이 방식이에요. |
| Tomcat 7, 8.0 | PFX(PKCS12) 또는 JKS | Connector에 keystoreFile, keystorePass, keystoreType을 직접 적어요. |
- Java 9 이상: 키스토어 기본 형식이 PKCS12예요. 특별한 이유가 없으면 PFX를 쓰는 게 가장 간단해요.
- Java 8 이하: keytool로 새로 만드는 키스토어의 기본 형식이 JKS예요. PFX도 쓸 수 있지만 형식을 꼭 적어 줘야 해요.
- 형식은 항상 직접 적으세요:
certificateKeystoreType(7·8.0은keystoreType)을 생략하면 JKS로 처리될 수 있어요. PFX를 쓴다면PKCS12, JKS를 쓴다면JKS라고 적어요. - Tomcat 10 이상: 예전 Connector 방식에 기대지 말고
SSLHostConfig방식을 쓰세요. Tomcat 8.5와 9에서는 예전 방식도 아직 동작하지만 권장되지 않아요.
Tomcat 7·8.0이라면 아래처럼 적어요. 파일 이름과 비밀번호는 내 환경에 맞게 바꾸세요.
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
keystoreFile="conf/tomcat.pfx" keystoreType="PKCS12"
keystorePass="PFX_비밀번호" />
코리아SSL에서 받은 인증서는 개인키·인증서·중간인증서를 PFX(PKCS12) 파일 하나로 묶은 뒤, Tomcat의 server.xml에 있는 HTTPS Connector에 연결하면 적용돼요. 순서는 파일 준비 → PFX 만들기 → server.xml 수정 후 재시작 세 단계예요.
시작하기 전에 준비할 파일
| 파일 | 설명 |
|---|---|
| 개인키(.key) | CSR을 만들 때 함께 생성된 파일이에요. 없다면 새 CSR과 인증서가 필요해요. |
| 서버 인증서(.crt) | CA에서 발급받은 도메인 인증서예요. |
| 중간인증서(CA 번들) | 서버 인증서와 루트를 이어 주는 파일이에요. 빠지면 일부 환경에서 체인 오류가 나요. |
OpenSSL과 keytool은 어디서 구하나요?
이 글의 명령은 OpenSSL만 있으면 돼요. 운영체제마다 구하는 방법이 달라요.
| 운영체제 | OpenSSL 구하는 방법 |
|---|---|
| Linux (Ubuntu·Debian) | 대부분 이미 설치돼 있어요. openssl version으로 확인하고, 없으면 sudo apt install openssl로 설치해요. |
| Linux (RHEL·Rocky·CentOS 계열) | 없으면 sudo dnf install openssl로 설치해요. (오래된 버전은 yum) |
| Windows | 기본으로 들어 있지 않아요. OpenSSL 공식 사이트(openssl.org)는 소스 코드만 제공하고, 설치 파일은 외부 업체가 만든 것을 많이 써요. 대표적인 곳이 Shining Light Productions이고, 명령어만 쓸 거라면 “Light” 버전이면 충분해요. 설치한 뒤 bin 폴더(예: C:\Program Files\OpenSSL-Win64\bin)를 PATH에 추가하고 openssl version으로 확인하세요. |
| macOS | 터미널에서 openssl version을 입력해 보세요. 기본으로 들어 있어요. 최신 OpenSSL이 필요하면 Homebrew로 brew install openssl을 실행해요. |
Windows용 설치 파일은 외부에서 받는 것이니, 공식 안내 페이지에서 받고 실행 전에 파일 정보를 한 번 확인하세요. 회사 서버라면 보안 담당자가 허용한 경로로 받는 것이 안전해요.
keytool은 따로 내려받는 프로그램이 아니라 Java(JDK)에 함께 들어 있는 도구예요. Tomcat은 Java로 실행되므로 이미 설치돼 있을 가능성이 높아요. JDK의 bin 폴더(예: C:\Program Files\Java\jdk-버전\bin, Linux는 $JAVA_HOME/bin)에 있고, keytool -help로 확인할 수 있어요. 실행 환경(JRE)만 설치돼 있으면 없을 수 있으니, 그때는 JDK를 설치하세요. JDK는 Adoptium(Eclipse Temurin)이나 Oracle 등에서 받을 수 있어요. 이 글의 PFX 방식은 OpenSSL만으로 진행하고, JKS 형식을 쓸 때 keytool이 필요해요(아래 “JKS를 쓴다면” 참고).
1단계. PFX 파일 만들기
OpenSSL로 개인키와 인증서, 중간인증서를 PFX 하나로 묶어요. 명령을 실행하면 PFX 비밀번호를 묻는데, 이 비밀번호는 3단계에서 그대로 써야 하니 기록해 두세요.
openssl pkcs12 -export -inkey private.key -in your_domain.crt -certfile ca-bundle.crt -name tomcat -out tomcat.pfx
개인키와 인증서가 한 쌍이 맞는지 먼저 확인하고 싶다면 아래 두 값이 같은지 비교해 보세요. RSA 키 기준이에요.
openssl x509 -noout -modulus -in your_domain.crt | openssl md5
openssl rsa -noout -modulus -in private.key | openssl md5
2단계. server.xml에 HTTPS Connector 연결하기
Tomcat 설치 폴더의 conf/server.xml에서 8443 포트 Connector를 찾아 아래처럼 맞춰요. 예시는 Tomcat 9·10.1·11에서 쓰는 형태이고, 파일 이름과 비밀번호는 내 환경에 맞게 바꾸세요.
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="conf/tomcat.pfx"
certificateKeystorePassword="PFX_비밀번호"
certificateKeystoreType="PKCS12" />
</SSLHostConfig>
</Connector>
- 상대 경로는 Tomcat의
CATALINA_BASE기준이에요. 헷갈리면 절대 경로로 적어요. - 이미 같은 포트의 Connector가 주석(
<!-- -->) 안에 있다면 주석을 풀고 수정해요. - 비밀번호에
&나<같은 문자가 있으면 XML에서는&,<로 적어야 해요.
JKS를 쓴다면
PFX(PKCS12) 대신 JKS 파일을 써야 하는 환경이라면, 1단계에서 만든 PFX를 keytool로 JKS로 바꿔요. 이때 keytool이 필요해요. 변환 중 비밀번호를 묻는데, 새 JKS 비밀번호는 아래 server.xml에 그대로 적어야 해요.
keytool -importkeystore -srckeystore tomcat.pfx -srcstoretype PKCS12 -destkeystore tomcat.jks -deststoretype JKS
그다음 server.xml의 Certificate 항목을 JKS에 맞게 바꿔요.
<Certificate certificateKeystoreFile="conf/tomcat.jks"
certificateKeystorePassword="JKS_비밀번호"
certificateKeystoreType="JKS" />
Java 9 이후에는 PKCS12가 기본 형식이라, JKS가 꼭 필요하지 않다면 위의 PFX 방식을 그대로 쓰는 것이 간단해요.
3단계. 재시작하고 확인하기
설정을 저장하고 Tomcat을 재시작해요. 서비스 이름이나 방식은 설치 환경마다 달라서, 평소 쓰는 방법으로 재시작하면 돼요. 그다음 아래 명령으로 서버가 어떤 인증서를 내보내는지 확인해요.
openssl s_client -connect your_domain:8443 -servername your_domain -showcerts
출력에서 서버 인증서 다음에 중간인증서가 이어지는지, 마지막에 Verify return code: 0 (ok)가 나오는지 보세요. 브라우저에서도 https://your_domain:8443으로 열어 자물쇠 표시를 확인해요.
자주 막히는 곳
| 증상 | 먼저 확인할 것 |
|---|---|
| 시작 로그에 keystore password was incorrect | PFX 만들 때 입력한 비밀번호와 certificateKeystorePassword 값이 같은지, 특수문자를 XML 규칙대로 적었는지 확인해요. |
| 파일을 찾을 수 없다는 오류 | certificateKeystoreFile 경로가 CATALINA_BASE 기준으로 맞는지, 실행 계정이 파일을 읽을 수 있는지 확인해요. |
| 8443으로 접속이 안 돼요 | Connector가 주석 안에 있지 않은지, 방화벽·보안 그룹에서 포트가 열려 있는지, 다른 프로그램이 같은 포트를 쓰지 않는지 확인해요. |
| PC에서는 되는데 일부 기기에서 체인 오류 | PFX를 만들 때 -certfile로 중간인증서를 포함했는지 확인해요. |
| 새 인증서로 바꿨는데 이전 인증서가 보여요 | Tomcat을 재시작했는지, 앞단에 다른 서버나 로드밸런서가 인증서를 대신 내보내고 있지 않은지 확인해요. |
설치 후 점검 목록
- 개인키와 인증서가 한 쌍인지 확인했어요.
- PFX에 중간인증서가 포함돼 있어요.
- server.xml의 파일 경로와 비밀번호가 PFX와 일치해요.
- 재시작 후
openssl s_client에서 체인이 정상으로 보여요. - PFX와 개인키 파일은 접근 권한을 필요한 계정으로만 제한했어요.
443 포트로 바로 서비스하려면 운영체제의 권한 설정이나 앞단 웹서버·로드밸런서 구성이 따로 필요해요. 환경에 따라 달라서 이 글에서는 8443 기준으로 설명했어요.
코리아SSL과 함께 인증서를 관리하세요
인증서 선택부터 설치까지 궁금한 점은 코리아SSL에서 확인할 수 있어요. 인증서 상품은 SSL 인증서 안내에서 살펴보고, 설치나 발급 중 막히는 부분은 1:1 문의로 남겨 주세요.
