← 소식 목록
개발·연동

공동인증서 연동 SDK 선택 시 꼭 확인해야 할 5가지

DiCert 편집팀 · 2026. 11. 4.

📋 공동인증서 연동 SDK 선택 시 꼭 확인해야 할 5가지

웹 서비스에 공동인증서 기능을 추가하려면 SDK를 선택해야 하는데, 제품마다 지원 범위와 요금이 다르다 보니 어떤 것을 고를지 고민이 많으실 겁니다. 이 글에서는 SDK를 비교할 때 꼭 확인해야 할 5가지를 정리했습니다.

1️⃣ 어떤 인증서를 지원하나요?

SDK마다 지원하는 인증서 종류가 다릅니다. 공동인증서(NPKI)는 웬만한 SDK가 지원하지만, 행정전자서명(GPKI)이나 교육행정전자서명(EPKI), 금융인증서는 제한적입니다.

인증서 종류 용도 주요 사용처
공동인증서(NPKI) 개인 및 법인 인증 은행, 관공서, 일반 서비스
행정전자서명(GPKI) 중앙부처·지자체 업무 정부기관 공식 문서
교육행정전자서명(EPKI) 교육청·학교 업무 교육기관 시스템
금융인증서 금융거래 은행 업무

특히 정부기관이나 교육기관과 연동해야 한다면, GPKI나 EPKI를 지원하는지 먼저 확인하는 게 중요합니다.

또한 개인 인증서만 필요한지, 법인·사업자 인증서까지 필요한지도 명확히 해야 SDK 선택이 한결 수월합니다.

2️⃣ 개발 환경에서 무료로 테스트할 수 있나요?

실제 구독료를 내기 전에 개발 환경에서 충분히 테스트해 보는 것이 좋습니다. 무료 테스트 기간이나 개발 환경 무료 지원 여부를 꼭 확인하세요.

예를 들어, localhost나 127.0.0.1에서 개발할 때 별도 신청 없이 무료로 쓸 수 있는 SDK라면, 프로토타입을 빠르게 만들고 기능을 확인할 수 있습니다.

반대로 초기 신청 단계부터 유료인 제품은 테스트 비용이 들어가니 신중하게 검토해야 합니다.

3️⃣ 실서비스 요금은 어떻게 책정되나요?

실서비스로 올린 후 드는 비용도 중요한 부분입니다. 도메인당 월정기료인지, 트래픽에 따라 과금하는지, 아니면 일회성 비용인지 확인해야 합니다.

요금 방식 특징 추천 대상
도메인 월정기료 정액제, 예측 가능한 비용 지속적으로 운영하는 서비스
트래픽 기반 과금 사용량에 따라 유동적 사용량이 불확정한 초기 단계
일회성 비용 구매 후 제한 없음 폐쇄형 서비스, 임시 프로젝트

또한 다중 도메인(예: example.com, admin.example.com)을 쓸 때 하위 도메인이 포함되는지, 따로 비용을 내야 하는지도 미리 물어보는 게 좋습니다.

4️⃣ 서버 전송과 보관 정책은 어떻게 되나요?

인증서 정보와 비밀번호가 어디로 전송되고 어디에 보관되는지는 보안과 직접 연관된 부분입니다.

  • SDK 서버에 전송되나? 개인정보 유출 위험을 최소화하려면 SDK 서버를 거치지 않고 바로 연동 서비스로 가는 것이 좋습니다.

  • 연동 서비스 서버에는 어떻게 보관되나? 암호화 저장, 접근 제어, 보관 기한 등을 확인하세요.

  • 개인키는 어떻게 처리되나? 개인키 파일 전송 여부와 보관 정책을 명확히 파악해야 합니다.

신뢰할 수 있는 SDK라면 이런 정책을 공개 문서로 명시하고 있을 겁니다.

5️⃣ 지원하는 OS와 브라우저는?

사용자가 어떤 환경에서 접속할지 미리 생각해 봐야 합니다.

환경 확인 항목 참고
Windows 10 이상? 32비트 지원? 대부분의 사용자가 Windows 10 이상
macOS 10.15 이상? Intel/Apple Silicon 모두? Mac 사용자도 지속적으로 증가 중
Linux 지원 여부 서버·개발자 용도에서 필요할 수 있음
모바일 iOS/Android 앱 연동? 모바일 우선 서비스라면 필수 확인

특히 공동인증서는 Windows와 macOS의 특정 디렉토리(Windows: C:\Users\사용자\AppData\LocalLow\NPKI, macOS: ~/Library/Preferences/NPKI)에만 저장되기 때문에, 해당 OS에서만 SDK가 인증서를 찾을 수 있습니다.

따라서 Linux나 웹 전용 환경에서는 공동인증서 연동이 불가능한 경우가 많습니다.

❓ 자주 묻는 질문

Q. SDK 선택 후 연동하는 데 시간이 얼마나 걸리나요?

A. SDK마다 다르지만, 문서가 잘 되어 있다면 기본 기능을 빠르게 구현할 수 있습니다. 복잡한 요구사항(다중 기관 연동, 전자서명, 상세 로깅)이 있다면 더 오래 걸릴 수 있으니 프로젝트 일정에 여유를 두세요.

Q. 기관 로그인(홈택스, 나라장터 등)도 SDK에서 지원하나요?

A. 대부분의 SDK는 인증서를 불러와 연동 서비스로 전달하는 것까지만 합니다. 기관 로그인, 기관 데이터 조회, 신고 기능은 연동 서비스에서 별도로 구현해야 합니다. 따라서 기관과의 API 연동이 필요하다면 해당 기관의 연동 가이드도 함께 검토해야 합니다.

Q. 인증서 비밀번호를 잊어버렸어요. SDK에서 초기화해 주나요?

A. 아니요. 공동인증서 비밀번호는 사용자만 알고 있으며, 어떤 SDK나 기관도 비밀번호를 찾거나 초기화해 줄 수 없습니다. 비밀번호를 잊어버렸다면 인증서를 발급한 기관에서 인증서를 재발급받아야 합니다.

Q. 보안토큰(HSM)이나 금융인증서도 지원하는 SDK가 있나요?

A. 제품마다 다릅니다. 금융인증서는 일부 SDK에서 지원하지만, 보안토큰은 매우 제한적입니다. 특수한 인증서가 필요하다면 SDK 문서나 제공사에 직접 문의해서 지원 여부를 확인하세요.