Elektron imza kitabxanası və API

PAdES (PDF Advanced Electronic Signatures) imzanın PDF faylının içinə yerləşdirildiyi elektron imza formatıdır; ETSI EN 319 142 standartı ilə müəyyən edilir. İmzalanmış sənəd yenə PDF olaraq qalır, Adobe Reader kimi PDF oxuyucularının imza panelində yoxlanılır və səhifədə görünən imza sahəsi daşıya bilər. Səviyyələri B-B, B-T (zaman möhürlü), B-LT və B-LTA (uzunmüddətli arxiv) olaraq artır.

CAdES (CMS Advanced Electronic Signatures) CMS/PKCS#7 strukturuna əsaslanan elektron imza formatıdır; ETSI EN 319 122 standartı ilə müəyyən edilir. İstənilən növ faylı imzalaya bilər; imza adətən sənədlə birlikdə .p7s şəklində və ya imzalanmış zərfin içində daşınır. Türkiyədə elektron imzalı rəsmi yazışmalarda ən geniş istifadə olunan formatdır.

XAdES (XML Advanced Electronic Signatures) XML sənədləri üçün hazırlanmış elektron imza formatıdır; ETSI EN 319 132 standartı ilə müəyyən edilir. İmza XML-in içinə yerləşdirilə və ya ayrıca saxlanıla bilər. UBL-TR formatında elektron faktura kimi XML əsaslı sənədlərdə istifadə olunur.

Elektron imza kitabxanası elektron imza yaratma və yoxlama işini öz proqram təminatınızın içinə əlavə edən tərtibatçı komponentidir (SDK). Hazır imza tətbiqi istifadəçiyə ekran təqdim edir; kitabxana isə ekranı olmayan bir tikinti blokudur — imzanı sizin tətbiqiniz, sizin iş axınınızda atır. Smart kart, token və ya HSM ilə işləyir; CAdES, XAdES və PAdES formatlarını yaradır və yoxlayır.

e-Yazışma paketi Türkiyə dövlət qurumları ilə rəsmi elektron yazışmada istifadə olunan standart paketdir: imzalanmış sənəd, metaməlumat faylı və varsa əlavələr bir paketdə birləşdirilir. Qurumlar arasında adətən KEP (qeydiyyatlı elektron poçt) vasitəsilə göndərilir.

Rəsmi e-Yazışma paketi metaməlumat faylı ilə imzalanmış sənədin birlikdə paketlənməsidir. Kitabxana bunu bir çağırışla edir: sənədi CAdES və ya XAdES ilə imzalayır, sxemə uyğun metaməlumat yaradır və paketi bağlayır. e-Yazışma 1.3 və 2.0 versiyaları dəstəklənir, KamuSM kök sertifikatı daxilə inteqrasiya olunub. Qovluq verdikdə içindəki sənədləri toplu şəkildə imzalayır.

Kitabxana öz proqram təminatınızın içinə daxil olur: imzalamanı sizin iş axınınız başladır, interfeys sizindir. Hazır tətbiq (İmzacı) kompüterdə işləyir, istifadəçi faylı seçib imzalayır. Hər ikisi eyni imza infrastrukturundan istifadə edir; hansının sizə uyğun olması imzanı kimin başlatmasından asılıdır — proqram təminatınız, yoxsa istifadəçi.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA), həmçinin ASiC-S və ASiC-E. Tək kitabxana ilə uzunmüddətli arxiv səviyyəsinə qədər çatırsınız.

Xeyr. Kitabxana moduldur; PDF üçün eSignature.PAdES paketi kifayətdir. İstifadə etmədiyiniz standartlar, TSA-lar və cihaz təminatçıları layihəyə ümumiyyətlə daxil olmur.

İmza brauzerdə deyil, veb tətbiqinizin server tərəfində yaradılır: eSignature.PAdES paketi çağırılır, imzalanmış PDF istifadəçiyə qaytarılır. Həlledici olan açarın harada durmasıdır — bulud HSM, şəbəkə HSM və ya mobil imza istifadə edirsinizsə, server açara çata bildiyi üçün axın tamamilə veb üzərindən gedir. Açar istifadəçinin smart kartındadırsa, brauzer karta çata bilmir; bu ssenaridə imzalama kompüterdə İmzacı ilə aparılır.

Bəli. İmza mənbəyi abstraktlaşdırılıb: smart kart və USB token (CNG/PKCS#11), şəbəkə HSM-ləri, bulud HSM xidmətləri və mobil imza eyni axınla istifadə olunur. Hər təminatçı müstəqil paketdir.

Bəli. RFC 5280 üzrə sertifikat zənciri yoxlaması, CRL, OCSP, Delta CRL və oflayn yoxlama kitabxananın içindədir; imzanı yaradan və yoxlayan eyni komponentdir.

Var. Kod yazmadan istifadə olunan masaüstü tətbiq İmzacı-dır: smart kartla PDF və XML imzalayır, e-Yazışma paketi hazırlayır və qovluq əsaslı toplu imzalama aparır.

Lazım olan standartın paketini layihəyə əlavə etmək: PDF imzası üçün eSignature.PAdES, XML üçün XAdES paketi. Kitabxana 39 NuGet paketinə bölündüyü üçün yalnız istifadə etdiyinizi quraşdırırsınız; layihəyə tək böyük asılılıq daxil olmur.

Windows CNG və PKCS#11 vasitəsilə AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey və Nitrokey kimi cihazlar dəstəklənir. Hər təminatçı ayrıca və müstəqil paketdir, istifadə etmədiyiniz drayver layihəyə daxil olmur.

Bəli. Thales Luna, Utimaco və Entrust nShield şəbəkə HSM-ləri, həmçinin AWS CloudHSM/KMS, Azure Key Vault HSM və Google Cloud KMS dəstəklənir. İstifadəçi kartla başında olmadan serverdə avtomatik imzalama axını belə qurulur.

Lazım deyil; imzanı yaradan və yoxlayan eyni komponentdir. RFC 5280 üzrə sertifikat zənciri yoxlaması, CRL, OCSP, Delta CRL və oflayn yoxlama kitabxananın içindədir.