E-allekirjoituskirjasto ja API

PAdES (PDF Advanced Electronic Signatures) on sähköisen allekirjoituksen muoto, jossa allekirjoitus upotetaan PDF-tiedostoon; sen määrittelee standardi ETSI EN 319 142. Allekirjoitettu asiakirja pysyy PDF:nä, se tarkistetaan PDF-lukijoiden, kuten Adobe Readerin, allekirjoituspaneelissa ja sivulla voi olla näkyvä allekirjoituskenttä. Tasot nousevat B-B:stä B-T:hen (aikaleimattu), B-LT:hen ja B-LTA:han (pitkäaikaisarkisto).

CAdES (CMS Advanced Electronic Signatures) on CMS/PKCS#7-rakenteeseen perustuva sähköisen allekirjoituksen muoto; sen määrittelee standardi ETSI EN 319 122. Sillä voi allekirjoittaa minkä tahansa tiedostotyypin; allekirjoitus kulkee yleensä asiakirjan mukana .p7s-tiedostona tai allekirjoitetussa kuoressa. Turkissa se on yleisimmin käytetty muoto sähköisesti allekirjoitetussa virallisessa kirjeenvaihdossa.

XAdES (XML Advanced Electronic Signatures) on XML-asiakirjoja varten kehitetty sähköisen allekirjoituksen muoto; sen määrittelee standardi ETSI EN 319 132. Allekirjoitus voidaan upottaa XML:ään tai pitää erillään. Sitä käytetään XML-pohjaisissa asiakirjoissa, kuten UBL-TR-muotoisessa e-laskussa.

E-allekirjoituskirjasto on kehittäjäkomponentti (SDK), joka lisää sähköisten allekirjoitusten luomisen ja tarkistamisen omaan ohjelmistoonne. Valmis allekirjoitussovellus tarjoaa käyttäjälle näkymän; kirjasto on rakennuspalikka ilman näkymää — allekirjoittaja on teidän sovelluksenne, teidän työnkulussanne. Se toimii älykortin, tunnisteen tai HSM:n kanssa sekä luo ja tarkistaa CAdES-, XAdES- ja PAdES-muodot.

e-Yazışma-paketti on vakiopaketti, jota käytetään virallisessa sähköisessä kirjeenvaihdossa Turkin julkisten laitosten kanssa: allekirjoitettu asiakirja, metatietotiedosto ja mahdolliset liitteet kootaan yhdeksi paketiksi. Laitosten välillä se lähetetään yleensä KEP:n (kirjattu sähköposti) kautta.

Virallinen e-Yazışma-paketti on metatietotiedosto ja allekirjoitettu asiakirja yhteen pakattuna. Kirjasto tekee sen yhdellä kutsulla: allekirjoittaa asiakirjan CAdES- tai XAdES-muodossa, luo skeeman mukaiset metatiedot ja sulkee paketin. e-Yazışman versiot 1.3 ja 2.0 ovat tuettuja, ja KamuSM:n juurivarmenne on sisäänrakennettu. Kun annatte kansion, sen asiakirjat allekirjoitetaan joukkona.

Kirjasto tulee osaksi omaa ohjelmistoanne: allekirjoituksen käynnistää teidän työnkulkunne, ja käyttöliittymä on teidän. Valmis sovellus (İmzacı) toimii työpöydällä: käyttäjä valitsee tiedoston ja allekirjoittaa sen. Molemmat käyttävät samaa allekirjoitusinfrastruktuuria; kumpi sopii teille, riippuu siitä, kuka allekirjoituksen käynnistää — ohjelmistonne vai käyttäjä.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) sekä ASiC-S ja ASiC-E. Yhdellä kirjastolla pääsette pitkäaikaisarkistoinnin tasolle asti.

Ei. Kirjasto on modulaarinen; PDF:lle riittää eSignature.PAdES-paketti. Standardit, TSA:t ja laitteistotarjoajat, joita ette käytä, eivät tule projektiin lainkaan.

Allekirjoitusta ei luoda selaimessa vaan verkkosovelluksenne palvelinpäässä: eSignature.PAdES-pakettia kutsutaan, ja allekirjoitettu PDF palautetaan käyttäjälle. Ratkaisevaa on, missä avain sijaitsee — pilvi-HSM:ää, verkko-HSM:ää tai mobiiliallekirjoitusta käytettäessä palvelin pääsee avaimeen käsiksi, joten koko kulku tapahtuu verkossa. Jos avain on käyttäjän älykortilla, selain ei pääse korttiin; silloin allekirjoitus tehdään työasemalla İmzacılla.

Toimii. Allekirjoituksen lähde on abstrahoitu: älykortti ja USB-tunniste (CNG/PKCS#11), verkko-HSM:t, pilvi-HSM-palvelut ja mobiiliallekirjoitus käyttävät samaa kulkua. Jokainen tarjoaja on itsenäinen paketti.

Kyllä. Varmenneketjun tarkistus RFC 5280:n mukaan, CRL, OCSP, Delta CRL ja offline-tarkistus sisältyvät kirjastoon; sama komponentti luo ja tarkistaa allekirjoituksen.

On. Ilman koodia käytettävä työpöytäsovellus on İmzacı: se allekirjoittaa PDF- ja XML-tiedostoja älykortilla, luo e-Yazışma-paketteja ja allekirjoittaa kokonaisia kansioita joukkona.

Lisätä projektiin tarvittavan standardin paketti: PDF-allekirjoitukseen eSignature.PAdES, XML:lle XAdES-paketti. Koska kirjasto on jaettu 39 NuGet-pakettiin, asennatte vain sen, mitä käytätte; projektiin ei tule yhtä suurta riippuvuutta.

Windows CNG:n ja PKCS#11:n kautta tuetaan laitteita kuten AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey ja Nitrokey. Jokainen tarjoaja on oma, itsenäinen pakettinsa; ajurit, joita ette käytä, eivät tule projektiin.

Voi. Tuettuja ovat Thales Lunan, Utimacon ja Entrust nShieldin verkko-HSM:t sekä AWS CloudHSM/KMS, Azure Key Vault HSM ja Google Cloud KMS. Näin palvelimelle rakennetaan automaattinen allekirjoitus ilman korttia pitelevää käyttäjää.

Ei tarvita; sama komponentti luo ja tarkistaa allekirjoituksen. Varmenneketjun tarkistus RFC 5280:n mukaan, CRL, OCSP, Delta CRL ja offline-tarkistus sisältyvät kirjastoon.