E-allkirja teek ja API

PAdES (PDF Advanced Electronic Signatures) on e-allkirja vorming, mille puhul allkiri on põimitud PDF-faili; selle määratleb standard ETSI EN 319 142. Allkirjastatud dokument jääb PDF-iks, seda kontrollitakse PDF-lugejate, näiteks Adobe Readeri allkirjapaneelil ning lehel võib olla nähtav allkirjaväli. Tasemed tõusevad B-B-st B-T (ajatempliga), B-LT ja B-LTA (pikaajaline arhiiv) tasemeni.

CAdES (CMS Advanced Electronic Signatures) on CMS/PKCS#7 struktuuril põhinev e-allkirja vorming; selle määratleb standard ETSI EN 319 122. Sellega saab allkirjastada mis tahes tüüpi faili; allkiri liigub dokumendiga tavaliselt .p7s-failina või allkirjastatud ümbrikus. Türgis on see e-allkirjastatud ametlikus kirjavahetuses enim kasutatav vorming.

XAdES (XML Advanced Electronic Signatures) on XML-dokumentide jaoks loodud e-allkirja vorming; selle määratleb standard ETSI EN 319 132. Allkiri võib olla XML-i põimitud või eraldi. Seda kasutatakse XML-põhistes dokumentides, näiteks UBL-TR-vormingus e-arvel.

E-allkirja teek on arendajakomponent (SDK), mis lisab e-allkirjade loomise ja kontrolli teie enda tarkvarasse. Valmis allkirjastamisrakendus pakub kasutajale ekraani; teek on ekraanita ehitusplokk — allkirjastab teie rakendus, teie töövoos. See töötab kiipkaardi, tokeni või HSM-iga ning loob ja kontrollib CAdES-, XAdES- ja PAdES-vorminguid.

e-Yazışma pakett on standardpakett, mida kasutatakse ametlikus e-kirjavahetuses Türgi avalike asutustega: allkirjastatud dokument, metaandmefail ja võimalikud manused koondatakse ühte paketti. Asutuste vahel saadetakse see tavaliselt KEP-i (registreeritud e-posti) kaudu.

Ametlik e-Yazışma pakett koosneb metaandmefailist ja allkirjastatud dokumendist, mis pakitakse kokku. Teek teeb seda ühe väljakutsega: allkirjastab dokumendi CAdES- või XAdES-vormingus, loob skeemile vastavad metaandmed ja sulgeb paketi. Toetatud on e-Yazışma versioonid 1.3 ja 2.0, KamuSM-i juursertifikaat on sisse ehitatud. Kausta andmisel allkirjastatakse selles olevad dokumendid hulgi.

Teek läheb teie enda tarkvarasse: allkirjastamise käivitab teie töövoog ja liides on teie oma. Valmis rakendus (İmzacı) töötab töölaual: kasutaja valib faili ja allkirjastab selle. Mõlemad kasutavad sama allkirjataristut; milline teile sobib, sõltub sellest, kes allkirja käivitab — teie tarkvara või kasutaja.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) ning ASiC-S ja ASiC-E. Ühe teegiga jõuate pikaajalise arhiivi tasemeni.

Ei. Teek on modulaarne; PDF-i jaoks piisab eSignature.PAdES paketist. Standardid, TSA-d ja riistvarapakkujad, mida te ei kasuta, projekti üldse ei jõua.

Allkiri ei sünni brauseris, vaid teie veebirakenduse serveripoolel: kutsutakse välja eSignature.PAdES pakett ja allkirjastatud PDF tagastatakse kasutajale. Otsustav on, kus võti asub — pilve-HSM-i, võrgu-HSM-i või mobiilallkirja puhul pääseb server võtmele ligi, nii et kogu voog käib veebi kaudu. Kui võti on kasutaja kiipkaardil, ei pääse brauser kaardile ligi; sel juhul allkirjastatakse töölaual İmzacı abil.

Jah. Allkirja allikas on abstraheeritud: kiipkaart ja USB-token (CNG/PKCS#11), võrgu-HSM-id, pilve-HSM-teenused ja mobiilallkiri kasutavad sama voogu. Iga pakkuja on sõltumatu pakett.

Jah. Sertifikaadiahela kontroll RFC 5280 järgi, CRL, OCSP, Delta CRL ja võrguühenduseta kontroll on teegis olemas; sama komponent loob ja kontrollib allkirja.

On. Ilma koodita kasutatav töölauarakendus on İmzacı: see allkirjastab kiipkaardiga PDF-i ja XML-i, loob e-Yazışma pakette ning allkirjastab terveid kaustu hulgi.

Lisada projekti vajaliku standardi pakett: PDF-allkirja jaoks eSignature.PAdES, XML-i jaoks XAdES-pakett. Kuna teek on jagatud 39 NuGeti paketiks, paigaldate ainult selle, mida kasutate; projekti ei tule üht suurt sõltuvust.

Windows CNG ja PKCS#11 kaudu toetatakse seadmeid nagu AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey ja Nitrokey. Iga pakkuja on eraldi sõltumatu pakett; draiverid, mida te ei kasuta, projekti ei jõua.

Jah. Toetatud on Thales Luna, Utimaco ja Entrust nShield võrgu-HSM-id ning AWS CloudHSM/KMS, Azure Key Vault HSM ja Google Cloud KMS. Nii luuakse serveris automaatne allkirjastamine ilma kaardiga kasutajata.

Ei ole; sama komponent loob ja kontrollib allkirja. Sertifikaadiahela kontroll RFC 5280 järgi, CRL, OCSP, Delta CRL ja võrguühenduseta kontroll on teegis olemas.