e-İmza Kütüphanesi ve API

PAdES (PDF Advanced Electronic Signatures), imzanın PDF dosyasının içine gömüldüğü elektronik imza biçimidir; ETSI EN 319 142 standardıyla tanımlanır. İmzalı belge yine bir PDF olarak kalır, Adobe Reader gibi PDF okuyucularda imza paneliyle doğrulanır ve sayfada görünür bir imza alanı taşıyabilir. Seviyeleri B-B, B-T (zaman damgalı), B-LT ve B-LTA (uzun süreli arşiv) olarak artar.

CAdES (CMS Advanced Electronic Signatures), CMS/PKCS#7 yapısına dayanan elektronik imza biçimidir; ETSI EN 319 122 standardıyla tanımlanır. Her tür dosyayı imzalayabilir; imza genellikle belgeyle birlikte .p7s ya da imzalı bir zarf içinde taşınır. Türkiye'de e-imzalı resmî yazışmalarda en yaygın kullanılan biçimdir.

XAdES (XML Advanced Electronic Signatures), XML belgeler için geliştirilmiş elektronik imza biçimidir; ETSI EN 319 132 standardıyla tanımlanır. İmza XML'in içine gömülebilir ya da ayrı durabilir. UBL-TR biçimindeki e-Fatura gibi XML tabanlı belgelerde kullanılır.

e-imza kütüphanesi, elektronik imza atma ve doğrulama işini kendi yazılımınızın içine ekleyen geliştirici bileşenidir (SDK). Hazır bir imza uygulaması kullanıcıya ekran sunar; kütüphane ise ekranı olmayan bir yapı taşıdır — imzayı sizin uygulamanız, sizin akışınızda atar. Akıllı kart, token ya da HSM ile çalışır; CAdES, XAdES ve PAdES biçimlerini üretir ve doğrular.

e-Yazışma paketi, kamu kurumlarıyla yapılan resmî elektronik yazışmada kullanılan standart pakettir: imzalı belge, üstveri (metadata) dosyası ve varsa ekler tek bir paket hâlinde bir araya getirilir. Kurumlar arasında genellikle KEP (kayıtlı elektronik posta) üzerinden iletilir.

Resmî e-Yazışma paketi, üstveri (metadata) dosyası ile imzalı belgenin birlikte paketlenmesidir. Kütüphane bunu tek çağrıda yapar: belgeyi CAdES ya da XAdES ile imzalar, üstveriyi şemaya uygun üretir ve paketi kapatır. e-Yazışma v1.3 ve v2.0 sürümleri desteklenir, KamuSM kök sertifikası entegre gelir. Klasör verdiğinizde içindeki belgeleri toplu imzalar.

Kütüphane kendi yazılımınızın içine girer: imzalamayı sizin akışınız tetikler, arayüz sizin. Hazır uygulama (İmzacı) masaüstünde çalışır, kullanıcı dosyayı seçip imzalar. Aynı imza altyapısını kullanırlar; hangisinin size uyduğu imzayı kimin başlattığına bağlı — yazılımınız mı, kullanıcı mı.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) ve ASiC-S ile ASiC-E. Uzun ömürlü arşiv seviyesine kadar tek kütüphaneyle çıkarsınız.

Hayır. Kütüphane modülerdir; PDF için eSignature.PAdES paketi yeterlidir. Kullanmadığınız standartlar, TSA'lar ve donanım sağlayıcıları projeye hiç girmez.

İmza tarayıcıda değil, web uygulamanızın sunucu tarafında üretilir: eSignature.PAdES paketi çağrılır, imzalı PDF kullanıcıya döner. Anahtarın nerede durduğu belirleyicidir — bulut HSM, ağ HSM ya da mobil imza kullanıyorsanız sunucu anahtara erişebildiği için akış tamamen web üzerinden yürür. Anahtar kullanıcının akıllı kartındaysa tarayıcı karta erişemez; o senaryoda imzalama masaüstünde, İmzacı ile yapılır.

Evet. İmzalama kaynağı soyutlanmıştır: akıllı kart ve USB token (CNG/PKCS#11), ağ HSM'leri, bulut HSM servisleri ve mobil imza aynı akışla kullanılır. Her sağlayıcı bağımsız bir pakettir.

Evet. RFC 5280 sertifika zinciri doğrulaması, CRL, OCSP, Delta CRL ve çevrimdışı doğrulama kütüphanenin içindedir; imzayı üreten ve doğrulayan aynı bileşendir.

Var. Kod yazmadan kullanılacak masaüstü uygulaması İmzacı'dır: akıllı kartla PDF ve XML imzalama, e-Yazışma paketi ve klasör bazlı toplu imzalama yapar.

İhtiyacınız olan standardın paketini projeye eklemek: PDF imzası için eSignature.PAdES, XML için XAdES paketi. Kütüphane 39 NuGet paketine bölündüğü için yalnız kullandığınızı yüklersiniz; tek büyük bağımlılık projeye girmez.

Windows CNG ve PKCS#11 üzerinden AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey ve Nitrokey gibi cihazlar desteklenir. Her sağlayıcı ayrı ve bağımsız pakettir, kullanmadığınız sürücü projeye girmez.

Evet. Thales Luna, Utimaco ve Entrust nShield ağ HSM'leri ile AWS CloudHSM/KMS, Azure Key Vault HSM ve Google Cloud KMS desteklenir. Kullanıcı başında kart olmadan, sunucuda otomatik imzalama akışı bu şekilde kurulur.

Gerekmiyor; imzayı üreten ve doğrulayan aynı bileşendir. RFC 5280 sertifika zinciri doğrulaması, CRL, OCSP, Delta CRL ve çevrimdışı doğrulama kütüphanenin içindedir.