PDF Signer Server (Tutorial für Entwickler)

Einführung

Digitale Signaturen gehören zu den kryptografischen Techniken, die die Quelle, Integrität und Nichtreplikation digitaler Dokumente gewährleisten. In den meisten Fällen unterscheidet sich die Übersetzung von herkömmlichen Formen handschriftlicher Unterschriften, bei denen fortschrittliche Verschlüsselungstechniken das Dokument sichern und die Identität des Unterzeichners überprüfen. Bei der Anwendung einer digitalen Signatur auf eine PDF-Datei wird ein elektronisches "Siegel" erstellt, das wie ein Zertifikat aussieht und das Dokument als seit seiner Unterzeichnung unverändert ausweist. Dieses Siegel beschreibt ein Verschlüsselungssystem mit einem mathematischen Algorithmus, der Unterschriftsdaten auf dem Dokument kodiert. Digitale Signaturen ermöglichen es, ein unveränderliches Protokoll der Änderungen zusammen mit dem Dokument aufzubewahren und die unterzeichnende Partei zu identifizieren. In diesem Artikel werden wir einen PDF Signer-Server mit Hilfe von IronSecureDoc erstellen.

So verwenden Sie den PDF Signer Server

1. Installieren Sie das IronSecureDoc-Docker-Image.

2. Führen Sie das Docker-Image mit einem bestimmten Port und Lizenzschlüssel aus.

3. IronSecureDoc-Client mit .NET-Anwendung initialisieren.

4. Holen Sie sich die URL und geben Sie sie beim Erstellen des Objekts an den IronSecureDoc Client weiter.

5. Übergeben Sie den erforderlichen Parameter an die IronSecureDoc Client API.

6. Holen Sie sich die bearbeiteten PDF-Dokumente und speichern Sie sie an einem bestimmten Ort.

Was ist IronSecureDoc?

IronSoftware's IronSecureDoc ist die allmächtige Lösung für Dokumentensicherheit. Dies würde vor dem Durchsickern sensibler Informationen durch verschiedene Dokumentenformate schützen. Sie unterstützt modernste Verschlüsselungsmethoden, um die Dokumente vor unbefugtem Zugriff zu schützen, so dass nur die vorgesehenen Leser oder Bearbeiter die Berechtigung haben, sie einzusehen oder zu ändern. Sie unterstützt auch digitale Signaturen, die den Ersteller eines Dokuments als autorisiert ausweisen und sicherstellen, dass der Inhalt nach der Unterzeichnung nicht mehr verändert wurde.

Außerdem bietet sie eine sichere gemeinsame Nutzung und Pflege von Dokumenten mit der Kontrolle darüber, wie und mit wem sie geteilt werden. IronSecureDoc integriert diese Funktionen, um Organisationen und Einzelpersonen bei der Einhaltung des Datenschutzes zu unterstützen und Datenschutzverletzungen zu verhindern. Die Relevanz dieser sehr benutzerfreundlichen Schnittstelle mit einer Reihe von Sicherheitsfunktionen macht die Software für jedes Unternehmen, das ein höheres Maß an Sicherheit bei der gemeinsamen Nutzung von Dokumenten bieten möchte, sehr relevant.

Merkmale von IronSecureDoc

IronSecureDoc verfügt über eine Vielzahl von Funktionen, um die Sicherheit der Dokumente zu erhöhen und sie intakt zu halten. Einige der wichtigsten Merkmale sind:

Erweiterte Verschlüsselung: Diese Funktion hilft, Dokumente vor unbefugtem Zugriff zu schützen, und sichert so die Geheimhaltung von Informationen durch robuste und starke Verschlüsselungsalgorithmen.

Digitale Signaturen: Diese Eigenschaft bestätigt die Tatsache, dass digitale Signaturen an jedes Dokument angehängt werden können, um zu behaupten, dass es original ist und seit der Unterzeichnung nicht verändert wurde, sondern auch, wer es unterzeichnet hat.

Sicheres Teilen: Dokumente sicher teilen und Personen festlegen, die berechtigt sind, sie anzusehen und sogar mit ihnen zu interagieren. Sie erkennt unbefugte Änderungen oder Manipulationen an einem Dokument und trägt somit zum Schutz der Integrität des Dokuments bei.

Compliance: Dies bringt Organisationen in Einklang mit zahlreichen Vorschriften zum Schutz und Industrienormen, indem sichergestellt wird, dass Dokumente sicher gehandhabt und übertragen werden.

Benutzerfreundlichkeit: Es bietet einfachen Zugang durch seine benutzerfreundliche Oberfläche bei der Handhabung von Sicherheitsfunktionen und Dokumenteneinstellungen.

Audit Trails: Es erstellt Verlaufsspuren für den Zugriff und die Änderung, wodurch Transparenz und Verantwortlichkeit ermöglicht werden.

IronSecureDoc-Docker-Image installieren

Die Installation und Ausführung eines IronSecureDoc-Docker-Images ist einfach. So könnten Sie es machen:

Docker installieren

Stellen Sie zunächst sicher, dass Docker auf Ihrem System installiert ist. Wir können Docker von der offiziellen Website von Docker herunterladen und dort den Installationsanweisungen für Ihr Betriebssystem folgen.

Das IronSecureDoc-Docker-Image ziehen

Öffnen Sie ein Terminal oder eine Eingabeaufforderung und führen Sie diesen Befehl aus, um das IronSecureDoc-Docker-Image aus dem Repository zu ziehen.

docker pull ironsoftwareofficial/ironsecuredoc

Ausführen des Docker-Containers

Nachdem das Bild gezogen wurde, sollte der folgende Befehl einen neuen Container starten. Wir können das Flag -p für die Portzuordnung oder --rm anpassen, um einen oder mehrere laufende Docker-Container vom Docker-Host zu entfernen.

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Im folgenden Beispiel ordnen Sie den Containern den Port 8080 des Hosts zu und weisen dem erstellten Container in IronSecureDoc einen Namen zu. Sobald der Befehl ausgeführt ist, wird er wie folgt angezeigt.

Sobald sie gestartet sind, können wir die Liste der von IronSecureDoc bereitgestellten APIs über den Browser (http://localhost:8080/swagger/index.html) oder eine beliebige Anwendungsanbindung aufrufen.

Erstellen Sie ein neues Visual Studio-Projekt

Mit Visual Studio ist die Entwicklung von Konsolenprojekten sehr weit verbreitet und einfach. Im Folgenden finden Sie einige einfache Schritte, die Ihnen den Einstieg in eine Konsolenanwendung in der Umgebung von Visual Studio erleichtern.

Bevor Sie Visual Studio verwenden können, müssen Sie es auf Ihrem Computer installiert haben.

Starten Sie ein neues Projekt:

Wählen Sie Datei, Projekt und dann das Menü Neu.

Bitte wählen Sie „Console App“ oder „Console App (.NET Core)“ aus der Liste der verfügbaren Projektvorlagen unten aus.

Um Ihrem Projekt einen Namen zu geben, füllen Sie das Feld "Name" aus.

Wählen Sie den Standort für Ihr Projekt.

Klicken Sie auf "Erstellen", um das Projekt "Console Application" zu öffnen.

Was ist IronSoftware.SecureDoc.Client?

Die IronSoftware.SecureDoc.Client Library lässt sich leicht in Ihre bestehenden .NET-Anwendungen integrieren, um die Vorteile von IronSecureDoc bei der PDF-Verschlüsselung, -Redigierung und -Signierung über einfache REST-API-Aufrufe zu nutzen. Entwickler können mit der IronSoftware.SecureDoc.Client-Bibliothek auf einfache Weise Dokumente in ihren Anwendungen mit garantierter Integrität sichern, wobei alle Vorgänge vor Ort für einen hohen Schutz der Daten gehalten werden. Ob es um die Schwärzung sensibler Informationen, die Zertifizierung von Dokumenten oder die Durchsetzung von Dokumentenverschlüsselung geht, IronSoftware.SecureDoc.Client hat die Werkzeuge, um all diese Aufgaben effizient und sicher zu erledigen.

IronSoftware.SecureDoc.Client installieren

Führen Sie zunächst die Installation der IronSoftware.SecureDoc.Client-Bibliothek durch, da der bevorstehende Patch von ihr abhängt. Zum Abschluss öffnen Sie die NuGet-Paketmanager-Konsole und führen den folgenden Befehl aus:

Install-Package IronSoftware.SecureDoc.Client

Wir können auch nach dem Paket "IronSoftware.SecureDoc.Client" im NuGet Package Manager suchen. Wir können aus der Liste aller NuGet-Pakete, die mit IronSoftware.SecureDoc.Client zusammenhängen, auswählen, welches heruntergeladen werden soll.

Erstellen Sie eine selbstsignierte digitale ID

Bei sensiblen Geschäftstransaktionen wird in der Regel eine ID von einer Zertifizierungsstelle verlangt, nicht von einer selbst signierten.

In Adobe Acrobat klicken Sie auf das Hamburger-Menü (Windows) oder das Acrobat-Menü (macOS) und wählen Sie dann „Voreinstellungen“.

Wählen Sie in der linken Kategorienliste Signaturen aus. Klicken Sie auf der rechten Seite auf Mehr neben Identitäten und vertrauenswürdigen Zertifikaten.

Wählen Sie auf der linken Seite Digitale IDs und klicken Sie dann auf die Schaltfläche ID hinzufügen.

Fügen Sie eine neue digitale ID hinzu

Wählen Sie nun die Option A new digital ID I want to create now und klicken Sie auf Next.

Erstellen Sie eine neue digitale ID

Geben Sie an, wo die digitale ID gespeichert werden soll, und klicken Sie dann auf Weiter.

Neue PKCS#12 digitale ID-Datei

Speichern Sie die digitalen ID-Informationen in einer .pfx-Datei in Windows und .p12 in macOS. Sie können diese Dateien betriebssystemübergreifend transportieren und mit Acrobat verwenden. Wenn Sie ein Dokument auf ein anderes Betriebssystem kopieren, wird es von Acrobat weiterhin verwendet.

Speichern Sie die digitale ID in einem gemeinsamen Speicher, auf den auch andere Windows-Anwendungen zugreifen können.

PKCS-digital-id

Geben Sie in das Feld für Ihre digitale ID Ihren Namen, Ihre E-Mail-Adresse und andere persönliche Informationen ein; dies wird im Unterschriftsfeld und im Unterschriftenfeld angezeigt, wenn Sie ein Dokument unterschreiben oder zertifizieren.

Gehen Sie wie folgt vor: Wählen Sie ein Element aus der Dropdown-Liste "Schlüsselalgorithmus" aus. Vom Standpunkt der Sicherheit aus ist ein 2048-Bit-RSA sicherer als ein 1024-Bit-RSA. 1024-Bit-RSA ist jedoch mit mehr Geräten kompatibel.

Im Menü Digitale ID verwenden für können Sie angeben, ob die digitale ID entweder für die Verschlüsselung, die digitale Signatur oder beides verwendet werden soll.

Klicken Sie auf Weiter.

Geben Sie Ihre Identitätsinformationen ein

Geben Sie ein Passwort für die digitale ID-Datei ein. Während der Eingabe prüft die Kennwortstärkeanzeige Ihr Kennwort und zeigt die Kennwortstärke mit Farbmustern an. Bestätigen Sie Ihr Passwort.

Der im Feld Dateiname angegebene Standardspeicherort ist der Ort, an dem die digitale ID-Datei gespeichert wird. Klicken Sie auf Durchsuchen und wählen Sie einen anderen Speicherort. Wählen Sie "Fertigstellen"

Geben Sie ein Passwort für Ihre ID ein.

Wenn eine digitale ID-Datei denselben Namen trägt, werden Sie gebeten, sie zu ersetzen. Klicken Sie auf OK, um die Datei zu ersetzen, oder klicken Sie auf Durchsuchen und wählen Sie einen anderen Speicherort für die Datei.

Jetzt ist eine ID erstellt worden. Sie können die Zertifikatsdatei exportieren, um sie an Kontakte zu senden, damit diese Ihre Signatur überprüfen können.

Signieren eines PDF-Dokuments mit IronSecureDoc

Im Folgenden finden Sie den Beispielcode, mit dem wir das PDF-Dokument mit der Zertifikatsdatei digital signieren können.

using IronSecureDoc;
Console.WriteLine("File Process started");
    var client = new IronSecureDocClient("http://localhost:8080");

    if (await client.TryConnectAsync())
    {
        var result = await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your cerfificate password here");
        File.WriteAllBytes("certify.pdf", result);
    }
    Console.WriteLine("File Process completed");
    Console.ReadKey();

using IronSecureDoc;
Console.WriteLine("File Process started");
    var client = new IronSecureDocClient("http://localhost:8080");

    if (await client.TryConnectAsync())
    {
        var result = await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your cerfificate password here");
        File.WriteAllBytes("certify.pdf", result);
    }
    Console.WriteLine("File Process completed");
    Console.ReadKey();

Imports IronSecureDoc
Console.WriteLine("File Process started")
	Dim client = New IronSecureDocClient("http://localhost:8080")

	If Await client.TryConnectAsync() Then
		Dim result = Await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your cerfificate password here")
		File.WriteAllBytes("certify.pdf", result)
	End If
	Console.WriteLine("File Process completed")
	Console.ReadKey()

Der folgende Code sendet zunächst eine Meldung an die Konsole, dass die Verarbeitung von Dateien begonnen hat. Danach wird die Erstellung eines IronSecureDocClient unter Verwendung der URL für einen lokal gehosteten IronSecureDoc-Dienst bestätigt. Nachfolgend finden Sie die Beispiel-PDF-Datei.

Diese Funktion wird dann asynchron versuchen, eine Verbindung zum Dienst herzustellen. Vorausgesetzt, alles verbindet sich ordnungsgemäß, wird sie CertifyAsync aufrufen, um tatsächlich das PDF-Dokument zu signieren, wobei die Pfade der PDF-Datei, der PDF-Signaturzertifikatsdatei und das Zertifikatspasswort übergeben werden. Die Ergebnisse, die als Byte-Array der signierten PDF-Datei dargestellt werden, werden dann in einer neuen Datei namens certify.pdf gespeichert.

Schließlich wird in der Konsole ausgedruckt, dass die Datei tatsächlich erfolgreich verarbeitet wurde, und dann wird auf die Eingabe des Benutzers gewartet, bevor das Konsolenfenster geschlossen wird. Dadurch wird ein Konsolenfenster eingeblendet, um dem Benutzer die Fertigstellungsmeldung zu zeigen, bevor die Anwendung existiert.

In der oben bearbeiteten Datei wurde das PDF-Dokument mit dem digitalen Zertifikat signiert.

Schlussfolgerung

IronSecureDoc ist eine integrierte Sicherheitslösung für digitale Dokumente, die dank robuster Verschlüsselungs- und Zertifizierungsfunktionen ein Höchstmaß an Schutz gewährleistet. Die IronSecureDoc-Client-Bibliothek ermöglicht es den Benutzern, ihren Dokumenten auf einfache Weise eine digitale Signatur hinzuzufügen, um Integritäts- und Sicherheitsstandards zu gewährleisten. Es verfügt über eine einfache API, die den Schutz sensibler Informationen in Dokumenten erleichtert.

Sie ist daher hilfreich für Entwickler, die einen erweiterten Schutz von Dokumenten in ihren Webserver-Anwendungen anbieten möchten. IronSecureDoc bietet geeignete Tools für den Datenschutz, die Authentifizierung und den durchgängigen Nachweis von Manipulationen über den gesamten Lebenszyklus von Dokumenten, sei es für rechtliche, finanzielle oder geschäftliche Zwecke. IronSecureDoc bietet eine kostenlose Testversion an. Um mehr über die Preisgestaltung zu erfahren, besuchen Sie die Preisseite. Iron Software verfügt über eine Vielzahl von Bibliotheken, die die Entwicklung von Anwendungen für viele Plattformen und Betriebssysteme erleichtern, wie Windows, Android, MAC und Linux, neben vielen anderen.