OVA/OVF-Signatur-Integrationshandbuch

Encryption Consulting (EC) ist sich der Notwendigkeit von Sicherheit in der modernen Welt bewusst und arbeitet mit CodeSign Secure an der Lösung dieser Probleme. Zu diesem Zweck haben wir ein benutzerfreundliches Kommandozeilenprogramm entwickelt, das Anwendern ein reibungsloses und problemloses Signieren von OVA/OVF-Dateien ermöglicht.

Das Utility-Tool von CodeSign Secure wurde mit Blick auf hohe Leistung, Genauigkeit und Benutzerfreundlichkeit entwickelt und vereinfacht das Signieren von OVA/OVF-Dateien. Der private Schlüssel wird in einem Hardware-Sicherheitsmodul generiert und gespeichert und verlässt dieses niemals. Lediglich ein Hash des Pakets wird an den Server gesendet, und nur die Signatur wird zurückgesendet.

In den Abschnitten 1 und 2 werden der Clientrechner und das Signaturzertifikat vorbereitet. Abschnitt 3 führt die Signierung durch, und Abschnitt 4 umfasst die Verifizierung.

Voraussetzungen: Das Utility Tool von Encryption Consulting muss auf dem System installiert sein, OpenSSL muss auf dem System konfiguriert sein und eine Beispiel-OVA/OVF-Datei muss auf dem System vorhanden sein.

Installieren Sie das Utility Tool und OpenSSL.

Das Utility Tool übernimmt die Signierung, und OpenSSL wird vom Tool verwendet, um den Hash des OVA/OVF-Pakets clientseitig zu berechnen.

Schritt 1: OpenSSL herunterladen und installieren

Laden Sie OpenSSL von hier herunter und installieren Sie es auf Ihrem System.

Schritt 2: Installieren Sie das Verschlüsselungsberatungs-Utility-Tool

Zur Installation müssen Sie eine MSI-Datei vom Portal herunterladen und ausführen, die dieses Tool auf Ihrem Rechner installiert.

Zusammen mit dem Tool werden Sie aufgefordert, verschiedene Signaturprogramme wie das Windows SDK, das Java SDK und das Encryption Consulting KSP zu installieren. Diese Signaturprogramme werden vom Utility Tool verwendet, um Signaturvorgänge für verschiedene Dateitypen durchzuführen.

Nach erfolgreicher Installation finden Sie die Datei Utility Tool.exe im Verzeichnis „C:\Program Files\Encryption Consulting\Utility Tool“.

Sie müssen das Feld „BASEURL“ in der Konfigurationsdatei mit der URL Ihrer Domain ändern.

Ausgabe der BASEURL in der Konfigurationsdatei

Schritt 3: Bestätigen Sie die OVA/OVF-Datei

Speichern Sie das zu signierende .ova- oder .ovf-Paket an einem geeigneten Ort auf Ihrem Rechner und notieren Sie sich den vollständigen Pfad. Diesen Pfad benötigen Sie für das Tool in Abschnitt 3.

Erwerben Sie ein Endbenutzerzertifikat

Zum Signieren der OVA- oder OVF-Datei benötigt der Benutzer ein Endbenutzerzertifikat. Dieses Zertifikat kann über unsere Webanwendung generiert oder in das Hilfsprogramm importiert werden.

Schritt 1: Zertifikat generieren oder importieren

Generieren Sie ein Endbenutzerzertifikat über das CodeSign Secure Webportal im Bereich „Schlüssel und Zertifikate“.

Alternativ können Sie ein vorhandenes Zertifikat in das Hilfsprogramm importieren.

HINWEIS: Wir bevorzugen den Import eines EV-Zertifikats (Extended Validation), da es die höchste Zertifikatsform auf dem Markt darstellt.

Schritt 2: Zertifikatsdetails notieren

Laden Sie das Zertifikat herunter und notieren Sie sich dessen Pfad auf der Festplatte, da dieser dem Tool als Zertifikatspfad übergeben wird.

Beachten Sie außerdem den Anwendungsnamen, der im Webportal mit dem Zertifikat verknüpft ist, sowie die Umgebung, zu der das Zertifikat gehört. Beide Angaben sind in Abschnitt 3 erforderlich.

OVA/OVF-Datei unterschreiben

Der Benutzer muss alle unten aufgeführten Eingabedaten an das Hilfsprogramm für den Signiervorgang übermitteln.

Schritt 1: Starten Sie das Hilfsprogramm

Öffnen Sie das in Abschnitt 1 installierte Utility Tool aus dem Verzeichnis „C:\Program Files\Encryption Consulting\Utility Tool“.

Schritt 2: Geben Sie die erforderlichen Eingaben an

Geben Sie bei Aufforderung die folgenden Details ein:

EingangBeschreibung
Benutzername Die primäre E-Mail-Adresse des Benutzers, um mit dem Signaturvorgang fortzufahren.
Zertifikatspfad Der Pfad zum Zertifikat, das zum Signieren der gewünschten Datei verwendet wird.
Eingabedateipfad Der Pfad zur OVA/OVF-Datei, die signiert werden muss.
Pfad der Ausgabedatei Der Pfad zur signierten OVA/OVF-Ausgabedatei.
Anwendungsname Die Anwendung, die mit dem Zertifikat verknüpft ist, das zum Signieren in unserem Webportal verwendet wird.
Arbeitsumfeld Der Name der Umgebung, sei es Produktion, Nicht-Produktion, Labor oder eine vom Benutzer in unserem Webportal erstellte spezifische Umgebung.

Schritt 3: Ergebnis bestätigen

Das Tool signiert die Datei und speichert die signierte Ausgabe im angegebenen Pfad. Unten sehen Sie einen Screenshot unseres Tools, das eine OVA-Datei signiert.

Utility Tool OVA-Signierungsergebnis

Überprüfen der Signatur

Das Utility Tool überprüft seine eigene Arbeit, und der Vorgang wird zudem zentral zu Prüfungszwecken protokolliert.

Schritt 1: Lesen Sie den Verifizierungsstatus.

Nach der Signierung überprüft das Tool, ob die OVA-Datei mit dem bereitgestellten Zertifikat signiert wurde, und meldet den Verifizierungsstatus „Wahr“ oder „Falsch“.

Der Status „True“ bestätigt, dass die Datei erfolgreich signiert wurde.

Schritt 2: Gegenprüfung in CodeSign Secure

Öffnen Sie das CodeSign Secure-Portal und navigieren Sie zu Berichte > Signieranforderungsbericht. Dort wird jede über das Tool durchgeführte Signieranforderung zu Prüfungszwecken protokolliert. Vergewissern Sie sich, dass eine Signieranforderung für das von Ihnen verwendete Zertifikat angezeigt wird.

Schritt 3: Validierung auf der Zielplattform

Als abschließende Überprüfung sollte das signierte Paket auf der vorgesehenen Plattform bereitgestellt oder importiert werden, um sicherzustellen, dass es akzeptiert wird.