E-signaturbibliotek og API

PAdES (PDF Advanced Electronic Signatures) er et format for elektroniske signaturer, hvor signaturen er indlejret i PDF-filen; det er defineret i standarden ETSI EN 319 142. Det signerede dokument forbliver en PDF, verificeres i signaturpanelet i PDF-læsere som Adobe Reader og kan have et synligt signaturfelt på siden. Niveauerne 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 baseret på strukturen CMS/PKCS#7; det er defineret i standarden ETSI EN 319 122. Det kan signere alle filtyper; signaturen følger som regel dokumentet som .p7s eller i en signeret kuvert. I Tyrkiet er det det mest udbredte format i e-signeret officiel korrespondance.

XAdES (XML Advanced Electronic Signatures) er et format for elektroniske signaturer udviklet til XML-dokumenter; det er defineret i standarden ETSI EN 319 132. Signaturen kan være indlejret i XML-filen eller ligge separat. Det bruges til XML-baserede dokumenter som e-fakturaer i formatet UBL-TR.

Et e-signaturbibliotek er en udviklerkomponent (SDK), der bygger oprettelse og verifikation af elektroniske signaturer ind i din egen software. En færdig signeringsapplikation viser brugeren en skærm; et bibliotek er en byggesten uden skærm — det er din applikation, der signerer, i dit flow. Det arbejder med smartcard, token eller HSM og opretter og verificerer formaterne CAdES, XAdES og PAdES.

En e-Yazışma-pakke er standardpakken til officiel elektronisk korrespondance med tyrkiske offentlige institutioner: det signerede dokument, metadatafilen og eventuelle bilag samles i én pakke. Mellem institutioner sendes den normalt via KEP (registreret e-mail).

En officiel e-Yazışma-pakke er metadatafilen og det signerede dokument pakket sammen. Biblioteket gør det i ét kald: det signerer dokumentet med CAdES eller XAdES, opretter skemakonform metadata og lukker pakken. e-Yazışma version 1.3 og 2.0 understøttes, og KamuSM's rodcertifikat er indbygget. Angiver du en mappe, signeres dokumenterne i den samlet.

Biblioteket bliver en del af din software: dit flow starter signeringen, og brugerfladen er din. Den færdige applikation (İmzacı) kører på computeren: brugeren vælger filen og signerer den. Begge bruger samme signeringsinfrastruktur; hvilken der passer dig, afhænger af, hvem der starter signaturen — din software eller brugeren.

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 ét bibliotek når du niveauet for langtidsarkivering.

Nej. Biblioteket er modulært; til PDF er pakken eSignature.PAdES nok. Standarder, TSA'er og hardwareudbydere, du ikke bruger, kommer aldrig ind i projektet.

Signaturen dannes ikke i browseren, men på serversiden af din webapplikation: pakken eSignature.PAdES kaldes, og den signerede PDF sendes tilbage til brugeren. Det afgørende er, hvor nøglen ligger — med cloud-HSM, netværks-HSM eller mobil signatur kan serveren tilgå nøglen, så hele flowet foregår via nettet. Ligger nøglen på brugerens smartcard, kan browseren ikke tilgå kortet; så foregår signeringen på computeren med İmzacı.

Ja. Signeringskilden er abstraheret: smartcard og USB-token (CNG/PKCS#11), netværks-HSM'er, cloud-HSM-tjenester og mobil signatur bruges med samme flow. Hver udbyder er en uafhængig pakke.

Ja. Validering af certifikatkæden efter RFC 5280, CRL, OCSP, Delta CRL og offlinevalidering ligger i biblioteket; den samme komponent opretter og verificerer signaturen.

Ja. Desktopapplikationen, der bruges uden at skrive kode, er İmzacı: den signerer PDF og XML med smartcard, opretter e-Yazışma-pakker og signerer hele mapper samlet.

Tilføj pakken for den standard, du har brug for, til projektet: eSignature.PAdES til PDF-signaturer, XAdES-pakken til XML. Da biblioteket er delt op i 39 NuGet-pakker, installerer du kun det, du bruger; der kommer ingen enkelt stor afhængighed ind i projektet.

Via Windows CNG og PKCS#11 understøttes enheder som AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey og Nitrokey. Hver udbyder er en separat, uafhængig pakke; drivere, du ikke bruger, kommer ikke ind i projektet.

Ja. Netværks-HSM'er fra Thales Luna, Utimaco og Entrust nShield samt AWS CloudHSM/KMS, Azure Key Vault HSM og Google Cloud KMS understøttes. Sådan bygges et automatisk signeringsflow på serveren uden en bruger med kort.

Nej; den samme komponent opretter og verificerer signaturen. Validering af certifikatkæden efter RFC 5280, CRL, OCSP, Delta CRL og offlinevalidering ligger i biblioteket.