E-Signatur-Bibliothek und API

PAdES (PDF Advanced Electronic Signatures) ist ein Format für elektronische Signaturen, bei dem die Signatur in die PDF-Datei eingebettet wird; definiert ist es in der Norm ETSI EN 319 142. Das signierte Dokument bleibt eine PDF, wird in PDF-Readern wie Adobe Reader über das Signaturfenster geprüft und kann ein sichtbares Signaturfeld auf der Seite tragen. Die Stufen steigen von B-B über B-T (mit Zeitstempel) und B-LT bis B-LTA (Langzeitarchiv).

CAdES (CMS Advanced Electronic Signatures) ist ein Format für elektronische Signaturen auf Basis der CMS/PKCS#7-Struktur; definiert ist es in der Norm ETSI EN 319 122. Es kann jede Art von Datei signieren; die Signatur wird meist als .p7s oder in einem signierten Umschlag mit dem Dokument transportiert. In der Türkei ist es das am häufigsten verwendete Format in elektronisch signierter amtlicher Korrespondenz.

XAdES (XML Advanced Electronic Signatures) ist ein Format für elektronische Signaturen, das für XML-Dokumente entwickelt wurde; definiert ist es in der Norm ETSI EN 319 132. Die Signatur kann in das XML eingebettet sein oder separat vorliegen. Es wird bei XML-basierten Dokumenten wie der E-Rechnung im UBL-TR-Format verwendet.

Eine E-Signatur-Bibliothek ist eine Entwicklerkomponente (SDK), die das Erstellen und Prüfen elektronischer Signaturen in Ihre eigene Software einbaut. Eine fertige Signaturanwendung zeigt dem Nutzer eine Oberfläche; eine Bibliothek ist ein Baustein ohne Oberfläche – die Signatur setzt Ihre Anwendung, in Ihrem Ablauf. Sie arbeitet mit Smartcard, Token oder HSM und erzeugt und prüft die Formate CAdES, XAdES und PAdES.

Ein e-Yazışma-Paket ist das Standardpaket für die amtliche elektronische Korrespondenz mit türkischen Behörden: Das signierte Dokument, die Metadatendatei und gegebenenfalls Anhänge werden zu einem einzigen Paket zusammengefasst. Zwischen Behörden wird es meist über KEP (registrierte elektronische Post) übermittelt.

Ein amtliches e-Yazışma-Paket besteht aus der Metadatendatei und dem signierten Dokument, die gemeinsam verpackt werden. Die Bibliothek erledigt das mit einem Aufruf: Sie signiert das Dokument mit CAdES oder XAdES, erzeugt schemakonforme Metadaten und schließt das Paket. Unterstützt werden die e-Yazışma-Versionen 1.3 und 2.0, das KamuSM-Stammzertifikat ist integriert. Übergeben Sie einen Ordner, werden die enthaltenen Dokumente gesammelt signiert.

Die Bibliothek wird Teil Ihrer eigenen Software: Ihr Ablauf löst das Signieren aus, die Oberfläche gehört Ihnen. Die fertige Anwendung (İmzacı) läuft am Desktop, der Nutzer wählt die Datei und signiert. Beide nutzen dieselbe Signaturinfrastruktur; was zu Ihnen passt, hängt davon ab, wer die Signatur startet – Ihre Software oder der Nutzer.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) sowie ASiC-S und ASiC-E. Bis zum Langzeitarchiv-Niveau kommen Sie mit einer einzigen Bibliothek.

Nein. Die Bibliothek ist modular; für PDF reicht das Paket eSignature.PAdES. Standards, TSAs und Hardwareanbieter, die Sie nicht nutzen, kommen gar nicht erst ins Projekt.

Die Signatur entsteht nicht im Browser, sondern auf der Serverseite Ihrer Webanwendung: Das Paket eSignature.PAdES wird aufgerufen, die signierte PDF geht an den Nutzer zurück. Entscheidend ist, wo der Schlüssel liegt – mit Cloud-HSM, Netzwerk-HSM oder Mobile Signatur kann der Server auf den Schlüssel zugreifen, der Ablauf läuft also vollständig über das Web. Liegt der Schlüssel auf der Smartcard des Nutzers, kann der Browser nicht auf die Karte zugreifen; in diesem Fall wird am Desktop mit İmzacı signiert.

Ja. Die Signaturquelle ist abstrahiert: Smartcard und USB-Token (CNG/PKCS#11), Netzwerk-HSMs, Cloud-HSM-Dienste und Mobile Signatur werden mit demselben Ablauf genutzt. Jeder Anbieter ist ein unabhängiges Paket.

Ja. Prüfung der Zertifikatskette nach RFC 5280, CRL, OCSP, Delta-CRL und Offline-Prüfung sind in der Bibliothek enthalten; dieselbe Komponente erzeugt und prüft die Signatur.

Ja. Die Desktop-Anwendung, die ohne Programmierung genutzt wird, ist İmzacı: Sie signiert PDF und XML mit der Smartcard, erstellt e-Yazışma-Pakete und signiert ordnerweise im Stapel.

Indem Sie das Paket des benötigten Standards ins Projekt aufnehmen: eSignature.PAdES für PDF-Signaturen, das XAdES-Paket für XML. Da die Bibliothek in 39 NuGet-Pakete aufgeteilt ist, installieren Sie nur, was Sie nutzen; keine einzelne große Abhängigkeit landet im Projekt.

Über Windows CNG und PKCS#11 werden Geräte wie AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey und Nitrokey unterstützt. Jeder Anbieter ist ein eigenes, unabhängiges Paket; Treiber, die Sie nicht nutzen, kommen nicht ins Projekt.

Ja. Unterstützt werden die Netzwerk-HSMs Thales Luna, Utimaco und Entrust nShield sowie AWS CloudHSM/KMS, Azure Key Vault HSM und Google Cloud KMS. So wird ein automatischer Signaturablauf auf dem Server aufgebaut, ohne dass ein Nutzer mit Karte davorsitzt.

Nein; dieselbe Komponente erzeugt und prüft die Signatur. Prüfung der Zertifikatskette nach RFC 5280, CRL, OCSP, Delta-CRL und Offline-Prüfung sind in der Bibliothek enthalten.