E-aláírás könyvtár és API

A PAdES (PDF Advanced Electronic Signatures) olyan elektronikus aláírási formátum, amelyben az aláírás a PDF-fájlba ágyazódik; az ETSI EN 319 142 szabvány határozza meg. Az aláírt dokumentum PDF marad, a PDF-olvasók, például az Adobe Reader aláírási paneljén ellenőrizhető, és látható aláírásmezőt is tartalmazhat az oldalon. A szintek B-B-től B-T-n (időbélyeggel) és B-LT-n át B-LTA-ig (hosszú távú archív) emelkednek.

A CAdES (CMS Advanced Electronic Signatures) a CMS/PKCS#7 struktúrán alapuló elektronikus aláírási formátum; az ETSI EN 319 122 szabvány határozza meg. Bármilyen típusú fájl aláírható vele; az aláírás általában .p7s-ként vagy aláírt borítékban kíséri a dokumentumot. Törökországban ez a leggyakrabban használt formátum az elektronikusan aláírt hivatalos levelezésben.

A XAdES (XML Advanced Electronic Signatures) XML-dokumentumokhoz kifejlesztett elektronikus aláírási formátum; az ETSI EN 319 132 szabvány határozza meg. Az aláírás beágyazható az XML-be, vagy külön is állhat. XML-alapú dokumentumoknál használják, például az UBL-TR formátumú e-számlánál.

Az e-aláírás könyvtár olyan fejlesztői komponens (SDK), amely az elektronikus aláírás létrehozását és ellenőrzését a saját szoftverébe építi. Egy kész aláíró alkalmazás képernyőt ad a felhasználónak; a könyvtár képernyő nélküli építőelem — az Ön alkalmazása ír alá, az Ön folyamatában. Intelligens kártyával, tokennel vagy HSM-mel működik, és CAdES, XAdES és PAdES formátumot hoz létre és ellenőriz.

Az e-Yazışma csomag a török közintézményekkel folytatott hivatalos elektronikus levelezés szabványos csomagja: az aláírt dokumentum, a metaadat-fájl és az esetleges mellékletek egyetlen csomagba kerülnek. Intézmények között általában KEP-en (tértivevényes elektronikus postán) továbbítják.

A hivatalos e-Yazışma csomag a metaadat-fájl és az aláírt dokumentum együttes becsomagolása. A könyvtár ezt egyetlen hívással elvégzi: CAdES vagy XAdES formátumban aláírja a dokumentumot, sémának megfelelő metaadatot készít, és lezárja a csomagot. Az e-Yazışma 1.3 és 2.0 verziója támogatott, a KamuSM gyökértanúsítvány beépített. Ha egy mappát ad meg, a benne lévő dokumentumokat kötegelten írja alá.

A könyvtár a saját szoftverébe kerül: az aláírást az Ön folyamata indítja, a felület az Öné. A kész alkalmazás (İmzacı) asztali gépen fut: a felhasználó kiválasztja a fájlt és aláírja. Mindkettő ugyanazt az aláírási infrastruktúrát használja; hogy melyik illik Önhöz, attól függ, ki indítja az aláírást — az Ön szoftvere vagy a felhasználó.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA), valamint ASiC-S és ASiC-E. Egyetlen könyvtárral eljut a hosszú távú archív szintig.

Nem. A könyvtár moduláris; PDF-hez az eSignature.PAdES csomag elég. A nem használt szabványok, TSA-k és hardverszolgáltatók be sem kerülnek a projektbe.

Az aláírás nem a böngészőben, hanem a webalkalmazás szerveroldalán készül: meghívja az eSignature.PAdES csomagot, az aláírt PDF pedig visszakerül a felhasználóhoz. A döntő az, hol van a kulcs — felhős HSM, hálózati HSM vagy mobil aláírás esetén a szerver hozzáfér a kulcshoz, így a teljes folyamat a weben fut. Ha a kulcs a felhasználó intelligens kártyáján van, a böngésző nem fér hozzá a kártyához; ilyenkor az aláírás asztali gépen, az İmzacı-val történik.

Igen. Az aláírás forrása absztrahált: az intelligens kártya és az USB-token (CNG/PKCS#11), a hálózati HSM-ek, a felhős HSM-szolgáltatások és a mobil aláírás ugyanazzal a folyamattal használható. Minden szolgáltató független csomag.

Igen. A tanúsítványlánc RFC 5280 szerinti ellenőrzése, a CRL, OCSP, Delta CRL és az offline ellenőrzés a könyvtár része; ugyanaz a komponens hozza létre és ellenőrzi az aláírást.

Van. A kódírás nélkül használható asztali alkalmazás az İmzacı: intelligens kártyával ír alá PDF-et és XML-t, e-Yazışma csomagot készít, és mappánként kötegelten ír alá.

A szükséges szabvány csomagjának hozzáadása a projekthez: PDF-aláíráshoz eSignature.PAdES, XML-hez a XAdES csomag. Mivel a könyvtár 39 NuGet-csomagra van bontva, csak azt telepíti, amit használ; egyetlen nagy függőség sem kerül a projektbe.

Windows CNG-n és PKCS#11-en keresztül olyan eszközök támogatottak, mint az AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey és Nitrokey. Minden szolgáltató külön, független csomag; a nem használt illesztőprogramok nem kerülnek a projektbe.

Igen. A Thales Luna, Utimaco és Entrust nShield hálózati HSM-ek, valamint az AWS CloudHSM/KMS, az Azure Key Vault HSM és a Google Cloud KMS támogatott. Így épül fel automatikus aláírási folyamat a szerveren, kártyát tartó felhasználó nélkül.

Nem kell; ugyanaz a komponens hozza létre és ellenőrzi az aláírást. A tanúsítványlánc RFC 5280 szerinti ellenőrzése, a CRL, OCSP, Delta CRL és az offline ellenőrzés a könyvtár része.