E-signature library en API

PAdES (PDF Advanced Electronic Signatures) is een formaat voor elektronische handtekeningen waarbij de handtekening in het PDF-bestand wordt ingebed; het is vastgelegd in de norm ETSI EN 319 142. Het ondertekende document blijft een PDF, wordt in PDF-lezers zoals Adobe Reader via het handtekeningenpaneel gecontroleerd en kan een zichtbaar handtekeningveld op de pagina hebben. De niveaus lopen op van B-B via B-T (met tijdstempel) en B-LT tot B-LTA (langetermijnarchief).

CAdES (CMS Advanced Electronic Signatures) is een formaat voor elektronische handtekeningen op basis van de CMS/PKCS#7-structuur; het is vastgelegd in de norm ETSI EN 319 122. Het kan elk type bestand ondertekenen; de handtekening gaat meestal met het document mee als .p7s of in een ondertekende envelop. In Turkije is het het meest gebruikte formaat voor elektronisch ondertekende officiële correspondentie.

XAdES (XML Advanced Electronic Signatures) is een formaat voor elektronische handtekeningen dat voor XML-documenten is ontwikkeld; het is vastgelegd in de norm ETSI EN 319 132. De handtekening kan in de XML zijn ingebed of los staan. Het wordt gebruikt voor XML-documenten zoals de e-factuur in UBL-TR-formaat.

Een e-signature library is een ontwikkelaarscomponent (SDK) die het zetten en controleren van elektronische handtekeningen in uw eigen software inbouwt. Een kant-en-klare ondertekeningsapplicatie toont de gebruiker een scherm; een library is een bouwsteen zonder scherm: uw applicatie ondertekent, binnen uw eigen proces. Het werkt met smartcard, token of HSM en maakt en controleert de formaten CAdES, XAdES en PAdES.

Een e-Yazışma-pakket is het standaardpakket voor officiële elektronische correspondentie met Turkse overheidsinstellingen: het ondertekende document, het metadatabestand en eventuele bijlagen worden samengevoegd tot één pakket. Tussen instellingen wordt het meestal via KEP (aangetekende elektronische post) verstuurd.

Een officieel e-Yazışma-pakket bestaat uit het metadatabestand en het ondertekende document, samen verpakt. De library doet dat in één aanroep: ze ondertekent het document met CAdES of XAdES, genereert metadata volgens het schema en sluit het pakket. De e-Yazışma-versies 1.3 en 2.0 worden ondersteund en het KamuSM-rootcertificaat is ingebouwd. Geeft u een map op, dan worden de documenten daarin in bulk ondertekend.

De library komt in uw eigen software: uw proces start het ondertekenen en de interface is van u. De kant-en-klare applicatie (İmzacı) draait op de desktop: de gebruiker kiest het bestand en ondertekent. Beide gebruiken dezelfde ondertekeningsinfrastructuur; welke bij u past, hangt af van wie de handtekening start: uw software of de gebruiker.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) en ASiC-S en ASiC-E. Met één library komt u tot het langetermijnarchiefniveau.

Nee. De library is modulair; voor PDF is het pakket eSignature.PAdES genoeg. Standaarden, TSA's en hardwareaanbieders die u niet gebruikt, komen nooit in uw project.

De handtekening ontstaat niet in de browser, maar aan de serverkant van uw webapplicatie: het pakket eSignature.PAdES wordt aangeroepen en de ondertekende PDF gaat terug naar de gebruiker. Beslissend is waar de sleutel staat: met een cloud-HSM, netwerk-HSM of mobiele handtekening kan de server bij de sleutel, dus het hele proces loopt via het web. Staat de sleutel op de smartcard van de gebruiker, dan kan de browser niet bij de kaart; in dat geval wordt op de desktop ondertekend met İmzacı.

Ja. De ondertekeningsbron is geabstraheerd: smartcard en USB-token (CNG/PKCS#11), netwerk-HSM's, cloud-HSM-diensten en mobiele handtekening werken met hetzelfde proces. Elke aanbieder is een onafhankelijk pakket.

Ja. Validatie van de certificaatketen volgens RFC 5280, CRL, OCSP, Delta CRL en offline validatie zitten in de library; hetzelfde onderdeel maakt en controleert de handtekening.

Ja. De desktopapplicatie die u zonder code gebruikt, is İmzacı: ze ondertekent PDF en XML met een smartcard, maakt e-Yazışma-pakketten en ondertekent in bulk per map.

Het pakket van de benodigde standaard aan het project toevoegen: eSignature.PAdES voor PDF-handtekeningen, het XAdES-pakket voor XML. Omdat de library in 39 NuGet-pakketten is opgedeeld, installeert u alleen wat u gebruikt; er komt geen enkele grote afhankelijkheid in het project.

Via Windows CNG en PKCS#11 worden apparaten zoals AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey en Nitrokey ondersteund. Elke aanbieder is een apart, onafhankelijk pakket; drivers die u niet gebruikt, komen niet in het project.

Ja. De netwerk-HSM's Thales Luna, Utimaco en Entrust nShield en ook AWS CloudHSM/KMS, Azure Key Vault HSM en Google Cloud KMS worden ondersteund. Zo bouwt u een automatisch ondertekeningsproces op de server, zonder gebruiker met een kaart.

Nee; hetzelfde onderdeel maakt en controleert de handtekening. Validatie van de certificaatketen volgens RFC 5280, CRL, OCSP, Delta CRL en offline validatie zitten in de library.