고객지원

KCLM(KoreaSSL Certificate Lifecycle Management)은 서버에 설치된 SSL 인증서의 상태를 확인하고, 인증서 교체와 적용을 관리하는 솔루션입니다.

서버마다 접속해 인증서 파일을 확인하고 교체하는 작업을 줄이고, KCLM 웹에서 여러 서버와 인증서의 관리 현황을 확인할 수 있습니다.

 

코리아SSL에서 발급한 모든 인증서는 KCLM을 무료로 이용할 수 있습니다.

 

본 가이드는 Linux·Windows IIS용 KCLM Agent의 설치부터 인증서 연결, 자동 점검, 교체 및 웹 통합 관리까지 실제 사용 순서에 따라 안내합니다. Cafe24 웹호스팅용 부가 프로그램인 KCLM for Cafe24는 별도 가이드로 제공합니다.

 

지원 환경

• Linux 서버: Nginx, Apache HTTP Server, Tomcat, JBoss/WildFly 등 웹서버와 애플리케이션 서버의 인증서를 관리합니다. 일반적인 패키지 설치 환경뿐 아니라 별도 경로에 설치한 서버의 설정 파일과 실행 경로를 지정하는 방법도 안내합니다.
• Windows IIS 서버: IIS의 HTTPS 사이트와 인증서 바인딩을 확인하고, 연결한 인증서를 PFX 형식으로 가져와 적용하는 방법을 안내합니다.
• Cafe24 웹호스팅: SSH 접속 없이 외부인증서 등록 페이지를 이용하는 환경을 위한 별도 프로그램을 제공합니다. 단일 도메인 인증서를 대상으로 하며, 멀티도메인·와일드카드 인증서는 설치 대상에서 제외합니다.

 

운영체제 버전과 웹서버 구성에 따라 필요한 설정이 다르므로, 설치 전 가이드의 환경별 안내를 확인해 주세요.

 

Linux·Windows IIS 가이드 주요 내용

1. 설치 전 준비

KCLM 사용에 필요한 Agent Key와 서버 접속 권한, 네트워크 연결 조건을 안내합니다. 인증서 파일과 웹서버 설정을 확인하는 방법, 자동 교체를 적용하기 전에 살펴봐야 할 항목도 포함합니다.

2. Agent 설치 및 업그레이드

Linux는 설치 스크립트를 이용하는 방법과 운영체제 아키텍처에 맞는 배포 파일을 직접 내려받아 설치하는 방법을 구분해 설명합니다. 기존 Agent가 설치된 경우에는 설치 경로와 호환성을 확인한 뒤 업그레이드하는 절차를 안내합니다.

Windows IIS는 프로그램 설치, 최초 실행, 서비스 등록과 시작·중지, 업데이트 및 제거 방법을 안내합니다. 관리 화면을 닫는 동작과 프로그램을 완전히 종료하는 동작의 차이도 설명합니다.

3. Agent Key 및 연결 설정

KCLM 웹의 키 관리에서 Agent Key를 확인하고 Agent에 등록하는 방법을 안내합니다. KCLM 서버 연결 확인, 서버 주소와 키 변경, IP 제한 설정 등 연결에 필요한 항목을 설명합니다.

4. 서버 인증서 검색과 연결

서버에 설치된 인증서를 검색하고, KCLM에서 관리할 인증서와 연결하는 과정을 안내합니다. 도메인과 인증서의 CN·SAN 정보를 확인하고, CA·제품명·유효기간·구독 최종 만료일을 비교해 인증서를 선택하는 방법을 설명합니다.

Linux에서는 웹서버 설정 파일과 인증서 경로를 확인하는 방법을, Windows IIS에서는 사이트와 HTTPS 바인딩을 확인하는 방법을 안내합니다.

5. 자동 점검 및 인증서 교체

연결된 인증서의 점검 주기와 자동 적용 여부를 설정하는 방법을 설명합니다. 새 인증서 확인, 인증서 교체, 웹서버 설정 검사와 반영까지의 흐름을 안내하며, 기존 인증서가 만료되었거나 연결한 인증서가 취소·사용 불가 상태인 경우 확인해야 할 사항도 다룹니다.

6. KCLM 웹에서 통합 관리

대시보드와 연결맵에서 서버·Agent·웹서버·인증서의 연결 관계를 확인하는 방법을 안내합니다. 운영체제와 웹서버 버전, Agent 버전, 마지막 보고 시각, 인증서 만료일 및 교체 대기 상태 등 주요 항목의 의미를 설명합니다.

웹에서 연결 인증서를 변경하거나 관리를 중지·재개·해제하는 방법과, 요청한 작업이 Agent에 전달되어 처리되는 과정도 안내합니다.

7. 상태 확인과 문제 해결

Agent 연결 확인이 필요한 경우, 자동 점검이 실행되지 않는 경우, 인증서 검색이나 서버 전송에 실패한 경우의 확인 순서를 안내합니다. 설치된 인증서와 연결 대상으로 선택한 인증서의 차이, 실제 HTTPS 접속 시 제공되는 인증서 정보의 의미도 설명합니다.

8. 변경 이력 및 알림

인증서 변경과 관리 상태 변경 이력을 확인하고, 작업 출처와 처리 대상을 구분하는 방법을 안내합니다. 브라우저 푸시 알림 등록, 테스트 전송 및 알림 채널 관리 방법도 포함합니다.

KCLM for Cafe24 별도 가이드 주요 내용

• 프로그램 설치와 Agent Key 등록
• Cafe24 로그인 정보 저장 및 자동 로그인 설정
• 세션 만료와 추가 인증이 필요한 경우의 처리
• 호스팅 계정과 연결 도메인 확인
• 설치 가능한 단일 도메인 인증서 조회 및 선택
• 인증서 연결 저장과 외부인증서 설치 신청
• 신청 대기·설치 완료·오류 등 현재 상태 확인
• Cafe24 확인 주기와 KCLM 서버 상태 보고 주기의 개별 설정
• KCLM 웹에서 Agent 상태와 인증서 관리 현황 확인