TmaxSoft JEUS SSL 인증서 설치/적용 가이드

사전 구성 환경

  • Java JDK or JRE http://www.java.com/ (Java 7 버전 이상, TLS 1.2 지원 필수)
  • SHA-2(SHA256) 암호화 지원 모듈 구성/활성 확인 필수
  • SNI(Server Name Indication, 서버 이름 표시) 기능 OS/웹서버 운영/활성화 권장 (443공용)
  • MD5, RC4 등 국제 보안 기구에서 해제를 권장하는 취약 암호화 모듈 비활성화
  • SSL 2.0, 3.0 및 TLS 1.0 1.1 취약 프로토콜 해제. 최신 TLS 1.2 1.3 접속 설정 권장

진행 과정

  1. 키스토어 생성
  2. CSR(Certificate Signing Request) 생성
  3. 인증서 발급 신청 제출
  4. 인증서 조합
  5. 서버 설정값 적용
  6. 서버 정상 적용 완료 테스트
  7. 웹페이지에 https:// 링크 적용

KeyStore 및 CSR 생성

⦁ SSL 인증서 발급 신청시, CSR 입력 단계에서 "CSR 자동생성" 선택시 수작업 생성 과정은 필요가 없습니다. (자동 이용 권장)
 ⦁ CSR 자동 발급 완료시, "개인키 / 서버인증서 / 체인인증서 / 루트인증서" 의 pem(crt,key), pfx, jks, p7b 파일이 첨부 제공됩니다.


- FAQ : 개인키(private key) 생성/보관 관련 참고 사항
- FAQ : SSL 발급 신청시 CSR 생성 관련 참고 사항
- FAQ : SSL 발급 신청시 도메인 형식 예제 및 참고 사항

※ CSR 직접 생성이 필요한 경우, Tomcat 매뉴얼의 Keystore/CSR 부분을 참고하시기 바랍니다. 자세히보기


Single

CN : sub.example.com 처럼 FQDN 도메인 형식 이어야 합니다.

Wildcard

CN : *.example.com 과 같은 패턴 이어야 합니다.

MultiDomain

CN : example.com 대표성을 가진 FQDN 도메인 1개만 입력 합니다.
SAN : 인증서에 포함될 나머지 FQDN 도메인은, 신청서 작성중 DCV 설정 단계에서 추가 입력합니다.

Multi-Wildcard

CN : example.com 대표 루트 도메인 1개을 CN으로 입력 합니다.
SAN : *.example.com 형식의 와일드카드 도메인은, 신청서 작성중 DCV 설정 단계에서 추가 입력합니다.

인증서 발급 완료

- 발급 완료 후에는, 메일첨부 또는 주문상세의 압축파일(zip)에 인증서 파일이 포함되어 있습니다.
- 서버 적용에 필요한 파일 정보는, zip 파일내 '발급내역서 및 루트/체인' PDF 에서 확인해야 합니다. (필수)
- 이후 과정 부터는, 서버에 SSL 인증서 설치/적용/확인 절차 입니다. (인터넷에 공개된 설정법과 차이 없음)

KeyStore 에 인증서 추가 (CSR 직접 생성한 경우)

⦁ SSL 발급 신청시, "CSR 자동생성" 발급 완료는 .jks / .pfx 파일이 제공되므로, 추가 과정은 불필요합니다. (zip파일)

SSL 발급 신청시 CSR 을 직접 생성한 경우, 고객사측 시스템에만 개인키/KeyStore 가 존재합니다. 인증서 변환 가이드 를 참조하여, 인증서 스토어에 "서버+체인+루트" 인증서를 추가로 통합해야 합니다. 루트/체인 인증서는 상품별로 차이가 있으므로, 발급 완료시 zip 첨부된 파일 내역에서 확인 가능합니다.

인증서 지정 (CSR 자동 생성시)

발급 완료 zip 첨부된 (예)www.sslcert.co.kr.jks KeyStore 파일을, JEUS_HOME/config/지정호스트/truststore 파일로 변경하여 저장(복사)
(발급 완료 첨부된 zip 파일 내역은, 발급 내역서 PDF 참조 바랍니다)

WEBMain.xml 예제

WEBMain.xml : /JEUS_ HOME/config/HOST_NAME/HOST_NAME_ENGINE_TYPE_ENGINE_NAME/
<web-container>
        <context-group>
            <webserver-connection>
                <http-listener>
                    <server-access-control>false</server-access-control>
                    <port>8080</port>
                    <scheme>https</scheme>
                    <ssl-config>
                    <enable-secure>true</enable-secure>
                    </ssl-config>
                </http-listener>
            </webserver-connection>
        </context-group>
</web-container>

- 위 예제에 포함되어 있지 않은 속성값은, 자체 서버 환경 설정값 지정 또는 공식 매뉴얼 참조하여 설정합니다.

JEUSMain.xml 예제

JEUSMain.xml : /JEUS_HOME/config/HOST_NAME/HOST_NAME/
<engine-container>
        <name>SSL 적용할 대상 엔진 컨테이너</name>
        <command-option>
            -Djeus.ssl.keypass= truststore(jks) 패스워드
            -Djeus.ssl.trustpass= truststore(jks) 패스워드
        </command-option>
</engine-container>

- 해당 컨테이너의 설정 중 위와 같이 (인증서 부분 추가) 설정합니다.
- 위 예제에 포함되어 있지 않은 속성값은, 자체 서버 환경 설정값 지정 또는 공식 매뉴얼 참조하여 설정합니다.

설치 적용 확인

- SSL 설정 적용 후, JEUS 서버를 재시작하여 정상 구동이 되는지 확인이 필요합니다.

- 서버 데몬 시작시 SSL 설정 관련 오류,경고가 있는지 콘솔/데몬/이벤트 로그 확인이 필요합니다.
- 서버 로컬에서 설정한 HTTPS 포트가 활성화 되어 있는지 netstat 등으로 확인해야 합니다.
- 외부에서 HTTPS 포트 접속이 되지 않는 다면 보안설정(방화벽등) 허용을 확인해야 합니다.
- L4 분산 환경은, HTTPS 패킷을 수신하는 모든 노드 웹서버에 SSL 적용이 필요합니다.
- L7 라우팅 환경은, L7 에도 HTTPS 활성 및 SSL 인증서 설정이 필요합니다. (장비별 자체 매뉴얼 참조)

- SSL 발급 도메인 웹페이지에 https:// 링크 적용을 별도 진행해야 최종적으로 SSL 암호화가 적용됩니다. (개발자,웹디자이너)
- PC 및 스마트폰의 "Chrome / Firefox / IE / Edge" 각 웹브라우져에서 "루트,체인,SSL,TLS" 경고가 발생 하는지 확인해야 합니다.

SSL 설치/적용 트러블슈팅 SSL 설치 적용 확인 하기 체인인증서 적용 여부 확인 인증서 포맷 변환 방법
컨텐츠의 무단 전재/복사 및 이메일 주소의 수집/이용을 허용하지 않습니다.
bitSyrup 2023. All rights reserved.