전자서명 라이브러리와 API

PAdES(PDF Advanced Electronic Signatures)는 서명을 PDF 파일 안에 삽입하는 전자서명 형식으로, ETSI EN 319 142 표준에 정의되어 있습니다. 서명된 문서는 PDF 그대로이며 Adobe Reader 같은 PDF 뷰어의 서명 패널에서 검증할 수 있고, 페이지에 눈에 보이는 서명란을 둘 수도 있습니다. 수준은 B-B에서 B-T(타임스탬프 포함), B-LT, B-LTA(장기 보관)로 올라갑니다.

CAdES(CMS Advanced Electronic Signatures)는 CMS/PKCS#7 구조에 기반한 전자서명 형식으로, ETSI EN 319 122 표준에 정의되어 있습니다. 어떤 종류의 파일이든 서명할 수 있으며, 서명은 보통 .p7s 형태로 또는 서명된 봉투 안에 담겨 문서와 함께 전달됩니다. 튀르키예에서는 전자서명 공문에서 가장 널리 쓰이는 형식입니다.

XAdES(XML Advanced Electronic Signatures)는 XML 문서를 위해 개발된 전자서명 형식으로, ETSI EN 319 132 표준에 정의되어 있습니다. 서명을 XML 안에 삽입할 수도, 별도로 둘 수도 있습니다. UBL-TR 형식의 전자청구서 같은 XML 기반 문서에 사용됩니다.

전자서명 라이브러리는 전자서명 생성과 검증을 자사 소프트웨어 안에 넣어 주는 개발자용 구성 요소(SDK)입니다. 완성형 서명 애플리케이션은 사용자에게 화면을 제공하지만, 라이브러리는 화면이 없는 구성 요소로 서명은 자사 애플리케이션이 자사 업무 흐름 안에서 수행합니다. 스마트카드, 토큰, HSM과 연동하며 CAdES, XAdES, PAdES 형식을 생성하고 검증합니다.

e-Yazışma 패키지는 튀르키예 공공기관과의 공식 전자 문서 교환에 쓰이는 표준 패키지입니다. 서명된 문서, 메타데이터 파일, 첨부 파일(있는 경우)을 하나의 패키지로 묶습니다. 기관 간에는 보통 KEP(등기 전자우편)로 전송됩니다.

공식 e-Yazışma 패키지는 메타데이터 파일과 서명된 문서를 함께 묶은 것입니다. 라이브러리는 이를 한 번의 호출로 처리합니다. 문서를 CAdES 또는 XAdES로 서명하고, 스키마에 맞는 메타데이터를 생성한 뒤 패키지를 닫습니다. e-Yazışma 1.3과 2.0 버전을 지원하며 KamuSM 루트 인증서가 내장되어 있습니다. 폴더를 지정하면 그 안의 문서를 일괄 서명합니다.

라이브러리는 자사 소프트웨어 안에 들어갑니다. 서명은 자사 업무 흐름이 시작하고 화면도 자사의 것입니다. 완성형 애플리케이션(İmzacı)은 데스크톱에서 실행되며 사용자가 파일을 골라 서명합니다. 둘 다 같은 서명 인프라를 사용합니다. 어느 쪽이 맞는지는 서명을 시작하는 주체가 자사 소프트웨어인지 사용자인지에 달려 있습니다.

CAdES(BES, EPES, T, C, X, XL, A), XAdES(BES, T, C, X, XL, A), PAdES(B-B, B-T, B-LT, B-LTA), 그리고 ASiC-S와 ASiC-E를 지원합니다. 라이브러리 하나로 장기 보관 수준까지 대응할 수 있습니다.

아닙니다. 라이브러리는 모듈형이며 PDF에는 eSignature.PAdES 패키지로 충분합니다. 사용하지 않는 표준, TSA, 하드웨어 제공자는 프로젝트에 전혀 들어가지 않습니다.

서명은 브라우저가 아니라 웹 애플리케이션의 서버 측에서 생성됩니다. eSignature.PAdES 패키지를 호출하고 서명된 PDF를 사용자에게 돌려줍니다. 관건은 키가 어디에 있느냐입니다. 클라우드 HSM, 네트워크 HSM, 모바일 서명을 쓰면 서버가 키에 접근할 수 있어 전체 흐름이 웹에서 처리됩니다. 키가 사용자의 스마트카드에 있으면 브라우저가 카드에 접근할 수 없으므로, 이 경우 데스크톱에서 İmzacı로 서명합니다.

네. 서명 소스가 추상화되어 있어 스마트카드와 USB 토큰(CNG/PKCS#11), 네트워크 HSM, 클라우드 HSM 서비스, 모바일 서명을 같은 흐름으로 사용합니다. 각 제공자는 독립된 패키지입니다.

네. RFC 5280 인증서 체인 검증, CRL, OCSP, Delta CRL, 오프라인 검증이 라이브러리에 포함되어 있으며, 서명 생성과 검증을 같은 구성 요소가 담당합니다.

있습니다. 코드를 작성하지 않고 쓰는 데스크톱 애플리케이션이 İmzacı입니다. 스마트카드로 PDF와 XML에 서명하고, e-Yazışma 패키지를 만들고, 폴더 단위로 일괄 서명합니다.

필요한 표준의 패키지를 프로젝트에 추가하는 것입니다. PDF 서명에는 eSignature.PAdES, XML에는 XAdES 패키지를 씁니다. 라이브러리가 39개의 NuGet 패키지로 나뉘어 있어 사용하는 것만 설치하며, 거대한 단일 의존성이 프로젝트에 들어오지 않습니다.

Windows CNG와 PKCS#11을 통해 AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey, Nitrokey 등의 장치를 지원합니다. 각 제공자는 독립된 별도 패키지이며, 사용하지 않는 드라이버는 프로젝트에 들어가지 않습니다.

네. Thales Luna, Utimaco, Entrust nShield 네트워크 HSM과 AWS CloudHSM/KMS, Azure Key Vault HSM, Google Cloud KMS를 지원합니다. 이렇게 카드를 든 사용자 없이 서버에서 자동 서명 흐름을 구성합니다.

필요 없습니다. 서명 생성과 검증을 같은 구성 요소가 담당합니다. RFC 5280 인증서 체인 검증, CRL, OCSP, Delta CRL, 오프라인 검증이 라이브러리에 포함되어 있습니다.