Библиотека и API за е-подпис

PAdES (PDF Advanced Electronic Signatures) е формат на електронен подпис, при който подписът е вграден в PDF файла; определен е от стандарта ETSI EN 319 142. Подписаният документ остава PDF, проверява се в панела за подписи на програми за PDF като Adobe Reader и може да има видимо поле за подпис на страницата. Нивата нарастват от 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 или да стои отделно. Използва се за XML документи като е-фактурата във формат UBL-TR.

Библиотеката за е-подпис е компонент за разработчици (SDK), който вгражда създаването и проверката на електронни подписи в собствения ви софтуер. Готовото приложение за подписване показва екран на потребителя; библиотеката е градивен елемент без екран — подписва вашето приложение, във вашия процес. Работи със смарт карта, токен или HSM и създава и проверява форматите CAdES, XAdES и PAdES.

Пакетът e-Yazışma е стандартният пакет за официална електронна кореспонденция с турските публични институции: подписаният документ, файлът с метаданни и евентуалните приложения се обединяват в един пакет. Между институциите обикновено се изпраща чрез KEP (регистрирана електронна поща).

Официалният пакет e-Yazışma се състои от файла с метаданни и подписания документ, пакетирани заедно. Библиотеката прави това с едно извикване: подписва документа във формат CAdES или XAdES, създава метаданни според схемата и затваря пакета. Поддържат се версии 1.3 и 2.0 на e-Yazışma, а коренният сертификат на 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 и подписва групово цели папки.

Да добавите в проекта пакета за нужния стандарт: eSignature.PAdES за подпис на PDF, пакета XAdES за XML. Тъй като библиотеката е разделена на 39 NuGet пакета, инсталирате само това, което използвате; в проекта не влиза една голяма зависимост.

Чрез Windows CNG и PKCS#11 се поддържат устройства като AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey и Nitrokey. Всеки доставчик е отделен, независим пакет; драйверите, които не използвате, не влизат в проекта.

Да. Поддържат се мрежовите HSM Thales Luna, Utimaco и Entrust nShield, както и AWS CloudHSM/KMS, Azure Key Vault HSM и Google Cloud KMS. Така се изгражда автоматично подписване на сървъра без потребител с карта.

Не; подписът се създава и проверява от един и същ компонент. Проверката на веригата от сертификати по RFC 5280, CRL, OCSP, Delta CRL и офлайн проверката са в библиотеката.