E-signaturbibliotek och API

PAdES (PDF Advanced Electronic Signatures) är ett format för elektroniska signaturer där signaturen bäddas in i PDF-filen; det definieras av standarden ETSI EN 319 142. Det signerade dokumentet förblir en PDF, verifieras i signaturpanelen i PDF-läsare som Adobe Reader och kan ha ett synligt signaturfält på sidan. Nivåerna stiger från B-B via B-T (med tidsstämpel) och B-LT till B-LTA (långtidsarkivering).

CAdES (CMS Advanced Electronic Signatures) är ett format för elektroniska signaturer baserat på strukturen CMS/PKCS#7; det definieras av standarden ETSI EN 319 122. Det kan signera alla typer av filer; signaturen följer vanligtvis med dokumentet som .p7s eller i ett signerat kuvert. I Turkiet är det det vanligaste formatet i e-signerad officiell korrespondens.

XAdES (XML Advanced Electronic Signatures) är ett format för elektroniska signaturer som utvecklats för XML-dokument; det definieras av standarden ETSI EN 319 132. Signaturen kan bäddas in i XML-filen eller ligga separat. Det används för XML-baserade dokument som e-fakturor i formatet UBL-TR.

Ett e-signaturbibliotek är en utvecklarkomponent (SDK) som bygger in skapande och verifiering av elektroniska signaturer i din egen programvara. En färdig signeringsapplikation visar användaren en skärm; ett bibliotek är en byggsten utan skärm — det är din applikation som signerar, i ditt flöde. Det fungerar med smartkort, token eller HSM och skapar och verifierar formaten CAdES, XAdES och PAdES.

Ett e-Yazışma-paket är standardpaketet för officiell elektronisk korrespondens med turkiska offentliga institutioner: det signerade dokumentet, metadatafilen och eventuella bilagor samlas i ett enda paket. Mellan institutioner skickas det vanligtvis via KEP (registrerad e-post).

Ett officiellt e-Yazışma-paket är metadatafilen och det signerade dokumentet paketerade tillsammans. Biblioteket gör det i ett enda anrop: det signerar dokumentet med CAdES eller XAdES, skapar schemaenlig metadata och stänger paketet. e-Yazışma version 1.3 och 2.0 stöds och KamuSM:s rotcertifikat är inbyggt. Anger du en mapp signeras dokumenten i den i ett svep.

Biblioteket blir en del av din programvara: ditt flöde startar signeringen och gränssnittet är ditt. Den färdiga applikationen (İmzacı) körs på datorn: användaren väljer filen och signerar den. Båda använder samma signeringsinfrastruktur; vilken som passar dig beror på vem som startar signaturen — din programvara eller användaren.

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 och ASiC-E. Med ett enda bibliotek når du nivån för långtidsarkivering.

Nej. Biblioteket är modulärt; för PDF räcker paketet eSignature.PAdES. Standarder, TSA:er och hårdvaruleverantörer du inte använder hamnar aldrig i projektet.

Signaturen skapas inte i webbläsaren utan på serversidan av din webbapplikation: paketet eSignature.PAdES anropas och den signerade PDF:en skickas tillbaka till användaren. Avgörande är var nyckeln finns — med moln-HSM, nätverks-HSM eller mobil signatur kommer servern åt nyckeln, så hela flödet sker via webben. Ligger nyckeln på användarens smartkort kan webbläsaren inte komma åt kortet; då görs signeringen på datorn med İmzacı.

Ja. Signeringskällan är abstraherad: smartkort och USB-token (CNG/PKCS#11), nätverks-HSM, moln-HSM-tjänster och mobil signatur används med samma flöde. Varje leverantör är ett fristående paket.

Ja. Validering av certifikatkedjan enligt RFC 5280, CRL, OCSP, Delta CRL och offlinevalidering finns i biblioteket; samma komponent skapar och verifierar signaturen.

Ja. Skrivbordsapplikationen som används utan att skriva kod är İmzacı: den signerar PDF och XML med smartkort, skapar e-Yazışma-paket och signerar hela mappar i ett svep.

Lägg till paketet för den standard du behöver i projektet: eSignature.PAdES för PDF-signaturer, XAdES-paketet för XML. Eftersom biblioteket är uppdelat i 39 NuGet-paket installerar du bara det du använder; inget enskilt stort beroende hamnar i projektet.

Via Windows CNG och PKCS#11 stöds enheter som AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey och Nitrokey. Varje leverantör är ett separat, fristående paket; drivrutiner du inte använder hamnar inte i projektet.

Ja. Nätverks-HSM från Thales Luna, Utimaco och Entrust nShield samt AWS CloudHSM/KMS, Azure Key Vault HSM och Google Cloud KMS stöds. Så byggs ett automatiskt signeringsflöde på servern, utan en användare med kort.

Nej; samma komponent skapar och verifierar signaturen. Validering av certifikatkedjan enligt RFC 5280, CRL, OCSP, Delta CRL och offlinevalidering finns i biblioteket.