Bibliotecă și API de semnătură electronică

PAdES (PDF Advanced Electronic Signatures) este un format de semnătură electronică în care semnătura este încorporată în fișierul PDF; este definit de standardul ETSI EN 319 142. Documentul semnat rămâne un PDF, se verifică în panoul de semnături al cititoarelor PDF precum Adobe Reader și poate avea un câmp de semnătură vizibil pe pagină. Nivelurile cresc de la B-B la B-T (cu marcă temporală), B-LT și B-LTA (arhivare pe termen lung).

CAdES (CMS Advanced Electronic Signatures) este un format de semnătură electronică bazat pe structura CMS/PKCS#7; este definit de standardul ETSI EN 319 122. Poate semna orice tip de fișier; semnătura însoțește de obicei documentul ca .p7s sau într-un plic semnat. În Turcia este formatul cel mai folosit în corespondența oficială cu semnătură electronică.

XAdES (XML Advanced Electronic Signatures) este un format de semnătură electronică dezvoltat pentru documente XML; este definit de standardul ETSI EN 319 132. Semnătura poate fi încorporată în XML sau păstrată separat. Se folosește la documente XML precum factura electronică în format UBL-TR.

O bibliotecă de semnătură electronică este o componentă pentru dezvoltatori (SDK) care adaugă crearea și verificarea semnăturilor electronice în propriul software. O aplicație de semnare gata făcută oferă utilizatorului un ecran; biblioteca este o piesă fără ecran — semnează aplicația dumneavoastră, în fluxul dumneavoastră. Funcționează cu card inteligent, token sau HSM și creează și verifică formatele CAdES, XAdES și PAdES.

Pachetul e-Yazışma este pachetul standard folosit în corespondența electronică oficială cu instituțiile publice din Turcia: documentul semnat, fișierul de metadate și eventualele anexe sunt reunite într-un singur pachet. Între instituții se transmite de regulă prin KEP (poștă electronică înregistrată).

Un pachet e-Yazışma oficial reunește fișierul de metadate și documentul semnat. Biblioteca face asta într-un singur apel: semnează documentul în CAdES sau XAdES, generează metadate conforme cu schema și închide pachetul. Sunt suportate versiunile e-Yazışma 1.3 și 2.0, iar certificatul rădăcină KamuSM este integrat. Dacă indicați un folder, semnează în lot documentele din el.

Biblioteca intră în propriul software: semnarea este declanșată de fluxul dumneavoastră, iar interfața vă aparține. Aplicația gata făcută (İmzacı) rulează pe desktop: utilizatorul alege fișierul și îl semnează. Ambele folosesc aceeași infrastructură de semnare; care vi se potrivește depinde de cine pornește semnătura — software-ul dumneavoastră sau utilizatorul.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) și ASiC-S și ASiC-E. Cu o singură bibliotecă ajungeți până la nivelul de arhivare pe termen lung.

Nu. Biblioteca este modulară; pentru PDF este suficient pachetul eSignature.PAdES. Standardele, TSA-urile și furnizorii de hardware pe care nu îi folosiți nu intră deloc în proiect.

Semnătura nu se generează în browser, ci pe partea de server a aplicației web: se apelează pachetul eSignature.PAdES, iar PDF-ul semnat se întoarce la utilizator. Decisiv este unde se află cheia — cu HSM în cloud, HSM de rețea sau semnătură mobilă, serverul are acces la cheie, deci întregul flux se desfășoară pe web. Dacă cheia este pe cardul inteligent al utilizatorului, browserul nu poate accesa cardul; în acest caz semnarea se face pe desktop cu İmzacı.

Da. Sursa de semnare este abstractizată: cardul inteligent și tokenul USB (CNG/PKCS#11), HSM-urile de rețea, serviciile HSM în cloud și semnătura mobilă se folosesc cu același flux. Fiecare furnizor este un pachet independent.

Da. Validarea lanțului de certificate conform RFC 5280, CRL, OCSP, Delta CRL și validarea offline sunt în bibliotecă; aceeași componentă creează și verifică semnătura.

Da. Aplicația desktop folosită fără a scrie cod este İmzacı: semnează PDF și XML cu card inteligent, creează pachete e-Yazışma și semnează în lot foldere întregi.

Adăugarea în proiect a pachetului standardului necesar: eSignature.PAdES pentru semnătura PDF, pachetul XAdES pentru XML. Deoarece biblioteca este împărțită în 39 de pachete NuGet, instalați doar ce folosiți; în proiect nu intră o singură dependență mare.

Prin Windows CNG și PKCS#11 sunt suportate dispozitive precum AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey și Nitrokey. Fiecare furnizor este un pachet separat și independent; driverele pe care nu le folosiți nu intră în proiect.

Da. Sunt suportate HSM-urile de rețea Thales Luna, Utimaco și Entrust nShield, precum și AWS CloudHSM/KMS, Azure Key Vault HSM și Google Cloud KMS. Așa se construiește un flux de semnare automată pe server, fără un utilizator cu card.

Nu; aceeași componentă creează și verifică semnătura. Validarea lanțului de certificate conform RFC 5280, CRL, OCSP, Delta CRL și validarea offline sunt în bibliotecă.