Navigation
Der Remote-Codesignaturdienst bietet verschiedene Clients, System-Provider, Entwicklungsschnittstellen und Automatisierungsintegrationen.
Wenn Sie nicht sicher sind, welche Methode Sie wählen sollen, können Sie anhand des Anwendungsszenarios unten beginnen.
So wählen Sie die Integrationsmethode aus
| Anwendungsszenario | Empfohlene Methode |
|---|---|
| Verwenden Sie das offizielle Befehlszeilentool, um EXE-, DLL-, MSI- und andere Dateien direkt zu signieren | Client-Tool |
| Installieren Sie den Codesignatur-Client unter macOS über Homebrew | Client-Tool |
| Microsoft SignTool, Visual Studio, MSBuild und andere Windows-Tools müssen den privaten Remote-Schlüssel direkt verwenden | Windows-Provider |
| Kompatibilität mit herkömmlichen Windows CryptoAPI / CSP-Anwendungen erforderlich | Windows-Provider |
Verwenden Sie jarsigner, um Java-JAR-Dateien zu signieren | Java-Integration |
| Automatisieren Sie die Codesignatur in GitHub Actions | CI/CD und Build-Tools |
| Verwenden Sie Electron Builder, um die Signatur von Windows-Anwendungen zu automatisieren | CI/CD und Build-Tools |
| Verwendung von Advanced Installer zum Erstellen und Signieren von Installationspaketen | CI/CD und Build-Tools |
| Eigenständige Entwicklung eines Clients oder direkter Aufruf des Remote-Signaturdienstes | API-Integration |
| Abfrage öffentlicher Informationen wie Signaturanzahl und Zeitstempelserver | Referenzmaterial |
Client-Tools
Geeignet für Nutzer, die den offiziellen sslTrus-Client direkt für die Codesignatur verwenden möchten.
Hauptsächlich enthalten:
- SignTool CLI: Signieren von Dateien direkt über die Befehlszeile.
- Abfrage des Signaturkontingents: Abfrage der verbleibenden und der gesamten Signaturanzahl des Zertifikats.
- Client-Aktualisierung: Abfragen und Installieren der neuesten Version.
- Homebrew: Installation der CLI oder des Desktop-Clients unter macOS.
Windows Provider
Geeignet für Microsoft SignTool, Visual Studio, MSBuild, Installationspaket-Tools sowie andere Software, die die Windows Cryptography API unterstützt.
Es werden zwei Provider angeboten:
- KSP (Key Storage Provider): Basiert auf Windows CNG und eignet sich für moderne Windows-Signaturprozesse.
- CSP (Cryptographic Service Provider): Basiert auf der herkömmlichen CryptoAPI und eignet sich für Anwendungen, die CSP-Kompatibilität benötigen.
Der private Signaturschlüssel wird stets im Cloud-HSM gespeichert. Der lokale Provider ist dafür verantwortlich, die Signaturanforderung an den Remote-Codesignaturdienst zu senden.
Java-Integration
Geeignet für Java-Codesignaturszenarien.
Über den von sslTrus bereitgestellten Java Provider kann das Standard-Tool jarsigner verwendet werden, um JAR-Dateien remote zu signieren.
CI/CD und Build-Tools
Geeignet für Szenarien, in denen die Codesignatur in automatische Build-, Release- oder Paketierungsprozesse integriert werden soll.
Derzeit enthalten:
- GitHub Actions
- Electron Builder
- Advanced Installer
Integrationsmethoden für weitere CI/CD- oder Build-Tools werden künftig ebenfalls auf dieser Seite bereitgestellt.
CI/CD und Build-Tools ansehen →
API-Integration
Geeignet für Entwickler, die einen eigenen Codesignatur-Client entwickeln oder die Remote-Signaturfähigkeit in bestehende Systeme integrieren möchten.
Die Remote-Codesignatur-API unterstützt:
- Übermitteln des zu signierenden Digests und Abrufen des Signaturergebnisses.
- Melden des endgültigen Signaturverarbeitungsstatus des Clients.
Der Aufrufer ist dafür verantwortlich, lokal die Digest-Berechnung der Datei, die Verarbeitung der Signaturstruktur sowie das endgültige Schreiben des Signaturergebnisses durchzuführen.
Referenzmaterialien
Hier finden Sie allgemeine Referenzinformationen für verschiedene Integrationsmethoden, darunter:
- Erläuterung zur Berechnung der Signaturanzahl: Erläutert, wie die Signaturanzahl in Szenarien wie CLI, KSP, CSP, Jarsigner, Electron und Installationspaketen berechnet wird.
- Zeitstempelserver: Stellt Authenticode, RFC 3161 sowie gängige Zeitstempeldienste für die Codesignatur vor.