Lokale Verarbeitung

Die Certifaction Plattform ist datenschutzorientiert. Lokale Verarbeitung ist das, was diese Garantie ermöglicht: Dokumentinhalte verlassen Ihre Infrastruktur niemals im Klartext. Der Lokale Client — eine Certifaction-Softwarekomponente, die in Ihrer Umgebung läuft — übernimmt jeden Schritt, der Dokumentinhalte berührt:

• Lesen des Dokuments,
• Hinzufügen von PDF-Signaturfeldern,
• Berechnen des Dokument-Hashes,
• Generieren aller Verschlüsselungsschlüssel, die das Dokument benötigt,
• Einbetten der zurückgegebenen Signatur in das PDF.

Die Certifaction API empfängt nur kryptografisches Material: Hashes, Metadaten und — wenn zutreffend — verschlüsselte Blobs. Sie empfängt niemals Dokumentinhalte im Klartext.

Die PAdES-Signaturschlüssel liegen bei unseren qualifizierten Vertrauensdiensteanbietern (QTSPs) für alle Signaturstufen (SES, AES und QES); der Lokale Client sieht sie nie. Umgekehrt verlassen Dokument-Verschlüsselungsschlüssel den Lokalen Client nie.

Wie eine Signatur erstellt wird

Das Dokument selbst bleibt bei jedem Schritt beim Lokalen Client. Nur der Hash erreicht die Certifaction API, und nur der Hash erreicht den QTSP.

Wann das verschlüsselte Dokument hochgeladen wird

Zwei Situationen erfordern, dass eine verschlüsselte Kopie des Dokuments zu Certifaction hochgeladen wird:

• Digitaler Zwilling aktiviert — eine verschlüsselte Kopie wird gespeichert, damit sie später abgerufen oder verifiziert werden kann.
• Signaturanfrage mit weiteren Unterzeichnern — das verschlüsselte Dokument muss für die eingeladenen Personen zugänglich sein.

In beiden Fällen generiert der Lokale Client einen einzigartigen 256-Bit-symmetrischen Verschlüsselungsschlüssel für jedes Dokument bzw. jede Signaturanfrage, verschlüsselt das Dokument mit NaCl Secretbox (XSalsa20 + Poly1305) und lädt nur den Chiffretext in das Certifaction Verschlüsselte Digitale Archiv hoch. Das Archiv hält den Chiffretext; es empfängt niemals den Schlüssel.

Der Verschlüsselungsschlüssel wird als URL-Fragment an die Dokument-URL angehängt, zum Beispiel:

https://example.com/DE6I239aEqI#zi9B6ioQcoLTCelSwsxrn0fIMPA9u6LthZCtRT7kP9c=

Gemäß RFC 3986 §3.5 werden URL-Fragmente niemals in HTTP-Anfragen übertragen, sodass der Schlüssel clientseitig bleibt, auch wenn die URL zum Abrufen des Dokuments verwendet wird. Wer die vollständige URL — einschließlich des Fragments — hat, verfügt über den Schlüssel und kann daher das Dokument entschlüsseln.

Freigabe von Signaturanfrage-URLs

Die Signaturanfrage-URL muss die eingeladenen Personen über einen sicheren Kanal erreichen. Sie haben zwei Optionen:

• Sie verteilen die URL selbst. Der Lokale Client gibt die vollständige URL an Ihre Anwendung zurück; Sie teilen sie den Eingeladenen über einen bereits von Ihnen kontrollierten Kanal mit (z. B. ein bestehendes Kundenportal oder einen authentifizierten Nachrichtenkanal). Certifaction ist nicht in die Verteilung involviert.
• Certifaction verteilt die URL für Sie. Der Lokale Client kann optional einen Key Encryption Key (KEK) generieren und damit das URL-Fragment verschlüsseln. Certifaction sendet dann eine E-Mail an die Eingeladenen, die die URL mit verschlüsseltem Fragment enthält — die E-Mail allein reicht also nicht aus, um das Dokument zu entschlüsseln. Sie übernehmen die Verantwortung, den KEK über einen sicheren Kanal Ihrer Wahl an die Eingeladenen weiterzugeben.

Wenn Sie ein Dokument nur für sich selbst signieren, ohne Digitalen Zwilling und ohne Signaturanfrage, wird kein Dokumentinhalt hochgeladen.

Betrieb des Lokalen Clients

Certifaction bietet mehrere Lokale-Client-Implementierungen. Zwei davon sind für Entwickler bei der Integration von Certifaction relevant:

Servermodus (Lokale HTTP-API)

Starten Sie den Lokalen Client als kleinen HTTP-Server, der eine Lokale API bereitstellt. Drittanbieteranwendungen rufen die Lokale API über HTTP auf, um Dokumente zu signieren — mit der Garantie, dass Dokumentinhalte in Ihrer Umgebung bleiben. Das ist eine gute Wahl für zentralisiertes Signieren innerhalb eines automatisierten Dokument-Workflows.

Interaktiver / Shell-Modus

Die CLI kann direkt von eigenständigen Anwendungen verwendet werden, um Dokumente auf dem Dateisystem oder über Standardeingabe/-ausgabe zu signieren und zu zertifizieren — keine Bibliotheks-Integration erforderlich.