E-signaturbibliotek og API

PAdES (PDF Advanced Electronic Signatures) er et format for elektroniske signaturer der signaturen er innebygd i PDF-filen; det er definert i standarden ETSI EN 319 142. Det signerte dokumentet forblir en PDF, verifiseres i signaturpanelet i PDF-lesere som Adobe Reader og kan ha et synlig signaturfelt på siden. Nivåene stiger fra B-B via B-T (med tidsstempel) og B-LT til B-LTA (langtidsarkivering).

CAdES (CMS Advanced Electronic Signatures) er et format for elektroniske signaturer basert på strukturen CMS/PKCS#7; det er definert i standarden ETSI EN 319 122. Det kan signere alle filtyper; signaturen følger vanligvis dokumentet som .p7s eller i en signert konvolutt. I Tyrkia er det det mest brukte formatet i e-signert offisiell korrespondanse.

XAdES (XML Advanced Electronic Signatures) er et format for elektroniske signaturer utviklet for XML-dokumenter; det er definert i standarden ETSI EN 319 132. Signaturen kan være innebygd i XML-filen eller ligge separat. Det brukes for XML-baserte dokumenter som e-fakturaer i formatet UBL-TR.

Et e-signaturbibliotek er en utviklerkomponent (SDK) som bygger oppretting og verifisering av elektroniske signaturer inn i din egen programvare. En ferdig signeringsapplikasjon viser brukeren en skjerm; et bibliotek er en byggestein uten skjerm — det er din applikasjon som signerer, i din flyt. Det fungerer med smartkort, token eller HSM og oppretter og verifiserer formatene CAdES, XAdES og PAdES.

En e-Yazışma-pakke er standardpakken for offisiell elektronisk korrespondanse med tyrkiske offentlige institusjoner: det signerte dokumentet, metadatafilen og eventuelle vedlegg samles i én pakke. Mellom institusjoner sendes den vanligvis via KEP (registrert e-post).

En offisiell e-Yazışma-pakke er metadatafilen og det signerte dokumentet pakket sammen. Biblioteket gjør det i ett kall: det signerer dokumentet med CAdES eller XAdES, lager skjemakonform metadata og lukker pakken. e-Yazışma versjon 1.3 og 2.0 støttes, og rotsertifikatet til KamuSM er innebygd. Angir du en mappe, signeres dokumentene i den samlet.

Biblioteket blir en del av programvaren din: flyten din starter signeringen, og grensesnittet er ditt. Den ferdige applikasjonen (İmzacı) kjører på datamaskinen: brukeren velger filen og signerer den. Begge bruker samme signeringsinfrastruktur; hvilken som passer deg, avhenger av hvem som starter signaturen — programvaren din eller brukeren.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) samt ASiC-S og ASiC-E. Med ett bibliotek når du nivået for langtidsarkivering.

Nei. Biblioteket er modulært; for PDF holder pakken eSignature.PAdES. Standarder, TSA-er og maskinvareleverandører du ikke bruker, kommer aldri inn i prosjektet.

Signaturen dannes ikke i nettleseren, men på serversiden av webapplikasjonen din: pakken eSignature.PAdES kalles, og den signerte PDF-en sendes tilbake til brukeren. Avgjørende er hvor nøkkelen ligger — med sky-HSM, nettverks-HSM eller mobil signatur har serveren tilgang til nøkkelen, så hele flyten går via nettet. Ligger nøkkelen på brukerens smartkort, får nettleseren ikke tilgang til kortet; da gjøres signeringen på datamaskinen med İmzacı.

Ja. Signeringskilden er abstrahert: smartkort og USB-token (CNG/PKCS#11), nettverks-HSM-er, sky-HSM-tjenester og mobil signatur brukes med samme flyt. Hver leverandør er en uavhengig pakke.

Ja. Validering av sertifikatkjeden etter RFC 5280, CRL, OCSP, Delta CRL og frakoblet validering ligger i biblioteket; den samme komponenten oppretter og verifiserer signaturen.

Ja. Skrivebordsapplikasjonen som brukes uten å skrive kode, er İmzacı: den signerer PDF og XML med smartkort, lager e-Yazışma-pakker og signerer hele mapper samlet.

Legg til pakken for standarden du trenger i prosjektet: eSignature.PAdES for PDF-signaturer, XAdES-pakken for XML. Siden biblioteket er delt i 39 NuGet-pakker, installerer du bare det du bruker; ingen enkelt stor avhengighet kommer inn i prosjektet.

Via Windows CNG og PKCS#11 støttes enheter som AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey og Nitrokey. Hver leverandør er en egen, uavhengig pakke; drivere du ikke bruker, kommer ikke inn i prosjektet.

Ja. Nettverks-HSM-er fra Thales Luna, Utimaco og Entrust nShield samt AWS CloudHSM/KMS, Azure Key Vault HSM og Google Cloud KMS støttes. Slik bygges en automatisk signeringsflyt på serveren uten en bruker med kort.

Nei; den samme komponenten oppretter og verifiserer signaturen. Validering av sertifikatkjeden etter RFC 5280, CRL, OCSP, Delta CRL og frakoblet validering ligger i biblioteket.