So verwenden Sie diese Anleitung:
Fehler sind nach Signaturmethode oder -tool gruppiert. Die Spalte „Schnittstelle“ zeigt an, wo der Kunde die Meldung gesehen hat – in einem Befehlszeilenfenster (CLI), einem App-/GUI-Popup, einer Protokolldatei, der Konsole einer CI/CD-Pipeline oder einer allgemeinen Windows-Systemmeldung. So können Sie schnell überprüfen, ob Sie den richtigen Eintrag vor sich haben. Der zitierte Text in der Spalte „Fehler/Symptom“ ist die wörtliche Fehlermeldung, die in der SSL.com-Dokumentation wiedergegeben wird. Bei Problemen, die Änderungen im SSL.com-Backend erfordern, wird dies in der Spalte „Lösung“ direkt angegeben. In diesen Fällen kontaktiert der Kunde den SSL.com-Support, der das Problem bei Bedarf an die Entwicklungsabteilung weiterleitet.
Tokenbasierte Codesignierung — Allgemein /SignTool
Gilt für jeden Hardware-Token-Workflow (YubiKey oder SafeNet) mit Microsoft SignTool.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
„'Signtool' wird nicht als interner oder externer Befehl, ausführbares Programm oder Batchdatei erkannt.“ |
CLI |
Der Befehl wurde mit dem bloßen Wort „signtool“ anstelle des vollständigen Pfads zu signtool.exe eingegeben. |
Ersetzen Sie „signtool“ im Befehl durch den vollständigen Pfad zu signtool.exe (z. B. C:\Program Files (x86)\Windows Kits\10\bin\). \x64\signtool.exe). |
|
|
„Das Zeitstempelzertifikat erfüllt nicht die Mindestanforderung an die Länge des öffentlichen Schlüssels.“ |
CLI |
Der Standard-Zeitstempelserver von SSL.com stellt ECDSA-basierte Zeitstempel aus, und die Signatursoftware/der Anbieter akzeptiert keine ECDSA-Zeitstempelschlüssel. |
Bitten Sie Ihren Softwareanbieter, ECDSA-Zeitstempelschlüssel zuzulassen, oder verwenden Sie den älteren RSA-Zeitstempel-Endpunkt. http://ts.ssl.com/legacy. |
|
|
„Windows kann den Herausgeber dieser Treibersoftware nicht überprüfen.“ |
Windows-System |
Die Software bzw. der Treiber wurde ohne gültiges Codesignaturzertifikat vertrieben, daher kann Windows die Identität des Herausgebers nicht bestätigen. |
Signieren Sie die Software vor der Verteilung mit einem gültigen OV- oder EV-Codesignaturzertifikat. |
|
|
Konfigurationsprobleme nach der Installation eines OV/EV-Zertifikats |
Windows-System |
Die OV- und EV-Codesignaturzertifikate wurden manuell im Zertifikatsspeicher des Computers installiert, anstatt vom Hardware-Token/HSM verwendet zu werden. |
Installieren Sie OV/EV-Codesignaturzertifikate nicht manuell; verwenden Sie sie direkt vom YubiKey FIPS-Token, SafeNet-Token oder über eSigner Cloud Signing. |
YubiKey FIPS Token-Fehler
Gilt für Codesignaturzertifikate, die auf einem YubiKey FIPS 140-2 Hardware-Token ausgestellt wurden.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
Kenne/finde nicht die YubiKey-PIN oder den PUK. |
N / A |
PIN/PUK konnten nicht aus dem Kontoportal abgerufen werden, oder das Token wurde neu ausgestellt. |
Melden Sie sich im SSL.com-Kundenportal an, öffnen Sie die Zertifikatsbestellung und verwenden Sie den Link „Aktivieren“ unter Physische Token / YubiKey FIPS 140-2, um PIN und PUK abzurufen. |
|
|
YubiKey wird vom Computer nicht erkannt / Zertifikat wird von SignTool nicht gefunden |
Windows-System |
Der Yubico Authenticator oder der erforderliche Mini-Treiber ist nicht installiert, daher kann das Betriebssystem das Zertifikat auf dem Token nicht erkennen. |
Installieren Sie Yubico Authenticator und den YubiKey-Minitreiber; vergewissern Sie sich, dass die Seriennummer des Tokens in Yubico Authenticator angezeigt wird, bevor Sie ihn signieren. |
Thales SafeNet (Gemalto) Token-Fehler
Gilt für Codesignaturzertifikate, die auf einem Thales SafeNet/Gemalto USB-Token ausgestellt wurden und mit dem SafeNet Authentication Client (SAC) verwendet werden.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
„Falsches Passwort“ |
App/GUI |
Beim Signieren mit SignTool wurde das falsche Token-Passwort/die falsche PIN eingegeben. |
Geben Sie das korrekte Token-Passwort erneut ein; falls Sie es vergessen haben, können Sie es in Ihren SSL.com-Konto-Bestelldetails abrufen oder mithilfe Ihres PUK zurücksetzen. |
|
|
„Das Token wurde aufgrund zu vieler fehlgeschlagener Anmeldeversuche gesperrt.“ |
App/GUI |
Die maximal zulässige Anzahl falscher Passwort-/PIN-Eingabeversuche wurde überschritten. |
Öffnen Sie den SafeNet Authentication Client, verwenden Sie die Ansicht „Erweitert“, wählen Sie „Token-Passwort festlegen“, geben Sie Ihren PUK als Administratorpasswort ein und legen Sie anschließend ein neues Token-Passwort fest und bestätigen Sie es. |
|
|
„'Signtool' wird nicht als interner oder externer Befehl, ausführbares Programm oder Batchdatei erkannt.“ |
CLI |
Dasselbe Problem mit dem SignTool-Pfad wie im allgemeinen Token-Abschnitt – Befehl ohne den vollständigen Pfad zur ausführbaren Datei eingegeben. |
Ersetzen Sie „signtool“ im Befehl durch den vollständigen Pfad zu signtool.exe. |
|
|
SafeNet Authentication Client erkennt das Token nach der Installation nicht. |
Windows-System |
SAC wurde installiert, der Computer jedoch nicht neu gestartet, sodass die Treiber-/Dienständerungen nicht wirksam wurden. |
Starten Sie den Computer nach der Installation des SafeNet Authentication Client neu; das Token sollte dann erkannt werden. |
SafeNet-Authentifizierungsclient zum Herunterladen für Code Signing-Zertifikate |
eSigner CodeSignTool (CLI)
Gilt für das Java-CLI-Dienstprogramm CodeSignTool von SSL.com.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
Die Anmeldeinformationen des elektronischen Signaturers konnten nicht gefunden werden. |
App/GUI |
Die Anmeldeinformations-ID (erforderlich für CodeSignTool und die CSC-API) wurde im Kontoportal nicht gefunden. |
Öffnen Sie im SSL.com-Konto die Zertifikatsbestellung und scrollen Sie zum Abschnitt „Signaturinformationen“, um die eSigner-Anmeldeinformations-ID, die Zertifikatseriennummer und die eSigner-Bezeichnung anzuzeigen. |
|
|
„Fehler: Ungültiges OTP“ (manuelle Signierung) |
App/GUI |
Der in die Authentifizierungs-App eingescannte QR-Code stimmt nicht mit dem verwendeten Benutzernamen/Passwort/der Anmeldeinformations-ID überein, oder das OTP ist abgelaufen. |
Vergewissern Sie sich, dass Sie den QR-Code des richtigen Kontos gescannt haben (und nicht den eines Teammitglieds), generieren Sie ein neues OTP und geben Sie es umgehend erneut ein, da OTPs schnell ablaufen. |
|
|
„Fehler: Ungültiges OTP“ (automatisierte / TOTP-Signatur) |
CLI |
Das TOTP-Geheimnis gehört zu einem anderen Konto/Zertifikat als der angegebene Benutzername, das Passwort und die Anmeldeinformations-ID; das Geheimnis selbst ist ungültig; oder die Systemzeit ist nicht synchronisiert. |
Überprüfen Sie, ob das TOTP-Geheimnis mit dem verwendeten Konto und den Anmeldeinformationen übereinstimmt, bestätigen Sie, dass das Geheimnis korrekt kopiert wurde, und synchronisieren Sie Ihre Systemuhr mit einem zuverlässigen Zeitserver (TOTP ist auf eine genaue Zeitübereinstimmung mit dem Signaturserver angewiesen). |
|
|
„'C:\Users\Admin\Dropbox\My' wird nicht als interner oder externer Befehl, ausführbares Programm oder Batchdatei erkannt.“ / „Das System kann den angegebenen Pfad nicht finden.“ |
CLI |
Ein Dateipfad, der Leerzeichen enthielt, wurde ohne Anführungszeichen an CodeSignTool übergeben, sodass die Shell ihn als mehrere separate Argumente interpretierte. |
Setzen Sie den Pfad der Eingabedatei und den Pfad des Ausgabeverzeichnisses in Anführungszeichen und geben Sie die Parameter direkt in die Befehlszeile ein oder kopieren Sie sie hinein, anstatt einen anderen Texteditor zu verwenden. |
|
|
„Die Datei ‚Dokumente‘ war zu diesem Zeitpunkt unerwartet.“ |
CLI |
Fortsetzung des gleichen Fehlers beim Parsen des Pfades ohne Anführungszeichen – die Shell trennt den Pfad am Leerzeichen und behandelt den Rest als ein zufälliges Token. |
Setzen Sie den vollständigen Dateipfad in Anführungszeichen, damit die Shell ihn als einzelnes Argument behandelt. |
|
|
„WARNUNG: sun.reflect.Reflection.getCallerClass wird nicht unterstützt. Dies beeinträchtigt die Leistung.“ |
CLI |
Eine harmlose Java-Laufzeitwarnung, die durch die zum Ausführen von CodeSignTool verwendete JVM-Version ausgelöst wird. |
Dies ist eine Leistungswarnung, kein Signaturfehler – sie kann ignoriert werden; überprüfen Sie die tatsächliche Ausgabe auf eine Bestätigung „Code erfolgreich signiert“. |
|
|
Der Signierbefehl schlägt stillschweigend fehl oder lehnt die Anmeldeinformationen ab, wenn das Passwort Sonderzeichen enthält. |
CLI |
Der Parameter -password enthält Sonderzeichen (z. B. !, @, ^), wurde aber nicht in Anführungszeichen gesetzt, weshalb die Shell den Wert falsch interpretiert. |
Setzen Sie das Passwort in Anführungszeichen, wenn es Sonderzeichen enthält, z. B. -password=”P!@^^ssword12″. |
|
|
Der Parameter credential_id fehlt (bei Konten mit mehreren Zertifikaten). |
CLI |
Das Konto verfügt über mehr als ein eSigner-Codesignaturzertifikat, daher kann CodeSignTool nicht standardmäßig auf ein einzelnes Zertifikat zurückgreifen. |
Übergeben Sie explizit -credential_id= im Befehl; verwenden Sie get_credential_ids, um alle Anmeldeinformations-IDs des Kontos aufzulisten. |
|
|
{“error_description”:”code: QuotaExceededError – message: Quota exceeded”,”error”:”server_error”} |
CLI / CI-CD |
Das mit den Signaturanmeldeinformationen verknüpfte Add-on zum Scannen von Malware hat ein internes Nutzungslimit erreicht, auch wenn im Konto-Dashboard noch verbleibende Signaturen angezeigt werden. |
Dieses Problem sollten Sie nicht selbst beheben. Wenden Sie sich an den SSL.com-Support, damit das Team das Limit für Malware-Scans in Ihrem Konto anpassen kann. Warten Sie nach der Behebung des Problems 1–2 Stunden, bevor Sie es erneut versuchen. |
SSL.com-Support (intern / kontospezifisch) |
|
“com.ssl.code.signing.tool.exception.CscApiException: server_error 500 at com.ssl.code.signing.tool.csc.CscApi.sendOtp(…)” |
Logdatei |
Die Anmeldung ist erfolgreich, aber die Anfrage zum Senden des SMS-Einmalpassworts schlägt aufgrund eines Konfigurationsproblems im Zusammenhang mit den Signaturanmeldeinformationen auf Seiten von SSL.com fehl. |
Wenden Sie sich an den SSL.com-Support, um die OTP-Konfiguration der Anmeldeinformationen zurücksetzen zu lassen. |
SSL.com-Support (intern / kontospezifisch) |
|
CodeSignTool meldet Erfolg (Exit-Code 0), obwohl die Signierung tatsächlich fehlgeschlagen ist. |
CI/CD-Pipeline |
Ältere Versionen von CodeSignTool wiesen einen Fehler auf, der dazu führte, dass unabhängig vom tatsächlichen Ergebnis ein Erfolg gemeldet wurde, wodurch Fehler in der Pipeline schwer zu erkennen waren. |
Aktualisieren Sie auf die neueste Version von CodeSignTool, die Fehler korrekt meldet. |
|
|
Die Authentifizierungsratenbegrenzung wurde beim Signieren vieler Dateien nacheinander erreicht. |
CI/CD-Pipeline |
Für jede einzelne Datei wird eine neue Anmeldung/Authentifizierung angefordert, anstatt ein Sitzungstoken für mehrere Signierungen wiederzuverwenden. |
Verwenden Sie für die gesamte Signiersitzung dasselbe Authentifizierungstoken, anstatt sich vor jeder Datei neu zu authentifizieren. Kunden mit hohem Transaktionsvolumen oder Unternehmenskunden, die dennoch an die Limits stoßen, sollten sich an den SSL.com-Support wenden, um mögliche Anpassungen ihres Kontos zu besprechen. |
|
|
„Fehler: Ungültiges OTP“ (manuelle Signierung) |
App/GUI |
Der in die Authentifizierungs-App eingescannte QR-Code stimmt nicht mit dem verwendeten Benutzernamen/Passwort/der Anmeldeinformations-ID überein, oder das OTP ist abgelaufen. |
Vergewissern Sie sich, dass Sie den QR-Code des richtigen Kontos gescannt haben (und nicht den eines Teammitglieds), generieren Sie ein neues OTP und geben Sie es umgehend erneut ein, da OTPs schnell ablaufen. |
|
|
Ungültige Signatur auf MSI-Installationsprogrammen, die mit Visual Studio erstellt wurden |
App/GUI |
Ein bekanntes Kompatibilitätsproblem zwischen eSigner und MSI-Installationsprogrammen, die mit den Paketierungstools von Visual Studio erstellt wurden. |
Als Workaround können MSI-Installationsprogramme mit dem WiX Toolset anstelle von Visual Studio erstellt werden. |
eSignerCKA (Cloud Key Adapter)
Gilt für eSigner CKA, das eSigner-Zertifikate in den Windows-Zertifikatspeicher lädt, damit sie mit SignTool.exe oder Certutil.exe verwendet werden können, einschließlich CI/CD-Pipelines.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
„Das Zeitstempelzertifikat erfüllt nicht die Mindestanforderung an die Länge des öffentlichen Schlüssels.“ |
CLI |
Das gleiche Kompatibilitätsproblem mit ECDSA-Zeitstempeln wie bei tokenbasierter Signatur tritt auf, wenn eSigner CKA mit SignTool verwendet wird. |
Wenden Sie sich an Ihren Softwareanbieter, um die Verwendung von ECDSA-Zeitstempelschlüsseln zu ermöglichen, oder verwenden Sie den Legacy-Endpunkt. http://ts.ssl.com/legacy für einen RSA-Zeitstempel. |
Automatisierte EV-Codesignatur mit SignTool/Certutil unter Verwendung von eSigner CKA |
|
„Dieses Dateiformat kann nicht signiert werden, da es nicht erkannt wird.“ (Signieren von .app-Dateien) |
CLI |
Der Versuch, eine Microsoft Dynamics 365 Business Central .app-Datei mit eSigner CKA zu signieren, bevor die Dynamics 365 Business Central-Anwendung selbst installiert ist, schlägt fehl, sodass SignTool das Dateiformat nicht analysieren kann. |
Installieren Sie zuerst Microsoft Dynamics 365 Business Central (Server-Installationsoption) und signieren Sie anschließend die resultierende .app-Datei mit SignTool über eSigner CKA. |
|
|
VBA-Makrosignierung schlägt stillschweigend fehl / Signatur abgelehnt |
App/GUI |
VBA sendet eSigner einen SHA1-Hash des Codes, eSigner benötigt jedoch SHA256 oder höher. |
Fügen Sie den DWORD-Registrierungswert V1HashEnhanced unter HKCU\SOFTWARE\Microsoft\VBA\Security hinzu und setzen Sie ihn gemäß den Anweisungen von Microsoft auf 2 (SHA256), 3 (SHA384) oder 4 (SHA512). Signieren Sie anschließend erneut. |
|
|
Zertifikat wird nicht angezeigt / kann nicht über SignTool verwendet werden |
App/GUI |
eSigner CKA ist nicht installiert, oder der Signaturmodus (manuell/automatisiert) und der Zertifikatstyp (Produktion/Test) wurden nicht konfiguriert. |
Installieren Sie eSigner CKA und konfigurieren Sie explizit den Signaturmodus und den Zertifikatstyp, bevor Sie versuchen zu signieren; bestätigen Sie vorher die Registrierung bei eSigner. |
Automatisierte EV-Codesignatur mit SignTool/Certutil unter Verwendung von eSigner CKA |
|
„Signaturinformationen nicht konfiguriert. Stellen Sie sicher, dass ein Zertifikat vor dem Signieren ausgestellt wurde.“ + „Fehler beim Abrufen der Zertifikats-ID. Fehler: Objektverweis wurde nicht auf eine Objektinstanz festgelegt.“ / (CLI) „Unbehandelte Ausnahme: System.NullReferenceException: Objektverweis wurde nicht auf eine Objektinstanz festgelegt. bei eSignerCKATool.eSignerCKATool.Config(CommandLineInfo commandLineInfo)“ |
App/GUI + CLI |
Entweder handelt es sich um eine übriggebliebene/ungültige Signatur-Anmeldeinformation auf dem Konto (z. B. eine alte, ungenutzte Anmeldeinformation), die diese Version von eSigner CKA nicht korrekt überspringt, oder um ein Zertifikat, das auf dem Konto als „Ausgestellt“ angezeigt wird, dessen Verknüpfung mit dem Cloud-Signatur-Backend aber noch nicht abgeschlossen ist. |
Löschen Sie zunächst die lokalen Konfigurationsordner %APPDATA%\eSignerCKA und %LOCALAPPDATA%\eSignerCKA und führen Sie anschließend den Konfigurationsbefehl erneut aus. Verwenden Sie dabei unbedingt den Parameter `-mode product` und Ihren Benutzernamen (nicht Ihre E-Mail-Adresse). Sollte das Problem weiterhin bestehen, wenden Sie sich bitte an den SSL.com-Support. Das Entfernen ungültiger Anmeldeinformationen oder der Abschluss der Zertifikatseinrichtung erfordert einen Eingriff im Backend. Alternativ können Sie in der Zwischenzeit CodeSignTool verwenden. |
SSL.com-Unterstützung |
|
eSigner CKA stürzt unmittelbar nach der Anmeldung ab (Windows-Ereignisanzeige): „.NET-Laufzeitereignis 1026 – System.AccessViolationException in eSignerCSP.UI.Utils.CspWrapper.C_UnloadAllCertificate während DisplayData“; das Problem besteht auch nach Neustart/Neuinstallation. |
Protokolldatei / App-Absturz |
Ein bekannter Fehler in älteren Versionen von eSigner CKA kann dazu führen, dass das Programm beim Start abstürzt, selbst wenn der Zertifikatsspeicher leer ist; dies hängt manchmal mit dem Problem der verbliebenen Anmeldeinformationen zusammen. |
Hierfür ist eine aktualisierte Version von eSigner CKA erforderlich. Wenden Sie sich bitte an den SSL.com-Support, damit das Problem an die Entwicklungsabteilung weitergeleitet werden kann. Verwenden Sie in der Zwischenzeit CodeSignTool zum Signieren. |
SSL.com-Support (intern / kontospezifisch) |
|
„[Fehler] Die Datei 'C:\Program Files (x86)\SSL Corp eSigner CKA\eSignerKSP64.dll' konnte nicht gefunden werden.“ / „[Fehler] Die Datei 'C:\Program Files (x86)\SSL Corp eSigner CKA\eSignerKSP32.dll' konnte nicht gefunden werden.“ |
Logdatei |
Bei bestimmten Installationsdateien von eSigner CKA fehlen diese unterstützenden Dateien nach einer internen Komponentenumbenennung – dies wird nicht durch etwas auf Ihrem Computer verursacht. |
Installieren Sie eSigner CKA vollständig neu: Löschen Sie die Ordner „Programme“ und „AppData“, starten Sie den Computer neu und installieren Sie eSigner CKA anschließend neu. Das Signieren kann auch mit dieser Meldung weiterhin funktionieren. Sollten die Dateien danach immer noch fehlen, wenden Sie sich bitte an den SSL.com-Support, um ein korrigiertes Installationsprogramm zu erhalten. |
SSL.com-Unterstützung |
|
„Ungültiges OTP“ nur im automatisierten/automatischen Signaturmodus (manueller Modus funktioniert) |
App/GUI |
Üblicherweise liegt die Ursache in einem falschen TOTP-Geheimnis, einem TOTP-Geheimnis, das nicht mit der verwendeten Anmeldeinformations-ID übereinstimmt, oder einer nicht synchronisierten Computeruhr. Gelegentlich kann auch eine Konfigurationsdatei einer vorherigen Installation, die mit der aktuellen in Konflikt steht, die Ursache sein. |
Vergewissern Sie sich, dass Sie das korrekte TOTP-Geheimnis für die betreffende Anmeldeinformations-ID verwenden und die Systemuhr korrekt eingestellt ist. Sollte das Problem weiterhin bestehen, löschen Sie die Ordner %APPDATA%\eSignerCKA und %LOCALAPPDATA%\eSignerCKA und installieren Sie eSigner CKA neu. |
SSL.com-Unterstützung |
|
„SignerSign() fehlgeschlagen. (-2146893821/0x80090003 NTE_BAD_KEY)“ / „signtool.exe: SignTool-Fehler: Es ist ein unerwarteter interner Fehler aufgetreten.“ – während der Stapelsignierung großer Datenmengen (typischerweise nach ca. 100 Dateien) |
CLI / CI-CD |
Die Malware-Scan-Funktion des Kontos stößt bei der Stapelsignierung großer Datenmengen an ihre interne Nutzungsgrenze und unterbricht die Signiersitzung. |
Wenden Sie sich an den SSL.com-Support, um das Limit für Malware-Scans bei hohem Anmeldeaufkommen für Ihr Konto anpassen zu lassen. Alternativ können Sie sich in kleineren Gruppen anmelden und die Anmeldeinformationen zwischen den Anmeldungen aktualisieren (config -r). |
SSL.com-Support (intern / kontospezifisch) |
|
„Schlüsselstatus ist deaktiviert“ bei jeder eSigner-Aktion (Signieren, PIN-Zurücksetzen, QR-Zurücksetzen). |
App/GUI / CLI |
Die Signaturberechtigung wurde im Backend von SSL.com deaktiviert. |
Wenden Sie sich an den SSL.com-Support – nur SSL.com kann eine deaktivierte Signaturberechtigung wieder aktivieren; dies kann nicht vom Kunden aus behoben werden. |
SSL.com-Support (intern / kontospezifisch) |
eSignerMalware-Scan (vor der Signierung)
Gilt für die optionale Malware-Scan-Funktion von SSL.com vor der Signierung, die im gesamten eSigner-Toolkit (Express, CodeSignTool, API, CKA) verfügbar ist.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
„Fehler: Der zu signierende Hash ist ein Malware-Objekt-Hash.“ |
CLI |
Malware Scan hat eine Übereinstimmung mit der eingereichten Datei festgestellt und den Signiervorgang wie vorgesehen automatisch abgebrochen. |
Dies ist das zu erwartende Verhalten bei der Erkennung von Schadsoftware – überprüfen und korrigieren Sie die markierte Datei, bevor Sie sie erneut einreichen; es handelt sich nicht um einen Konfigurationsfehler, es sei denn, die Scanfunktion war nicht aktiviert. |
So verwenden Sie den vorsignierenden Malware-Scan mit SSL.com eSigner |
|
Malware-Scan gilt nicht für Signieranfragen |
App/GUI |
Die Option „Malware-Blocker aktiviert“ war im Abschnitt „Signaturanmeldeinformationen“ des Kontos nicht zusammen mit der Option „Signaturanmeldeinformationen aktiviert“ aktiviert. |
Stellen Sie auf der SSL.com-Zertifikatsbestellseite unter „Signaturinformationen“ sicher, dass vor dem Signieren sowohl „Signaturinformationen aktiviert“ als auch „Malware-Blocker aktiviert“ ausgewählt sind. |
So verwenden Sie den vorsignierenden Malware-Scan mit SSL.com eSigner |
CI/CD-Pipeline-Integration (GitHub Actions, GitLab CI, Jenkins, Travis, Azure DevOps)
Gilt für automatisierte eSigner CodeSignTool- oder eSigner CKA-Signaturschritte, die in CI/CD-Pipeline-Skripte eingebettet sind.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
Der Signierungsschritt schlägt mitten im Prozess ohne erkennbare Ursache fehl. |
CI/CD-Pipeline |
Im Pipeline-Skript (YAML/Groovy/etc.) um den Signierungsschritt herum wurden Tippfehler oder fehlerhafte Zeilenumbrüche eingefügt. |
Überprüfen Sie das Pipeline-Skript sorgfältig auf Rechtschreibfehler und überflüssige Zeilenumbrüche; vergleichen Sie es mit den veröffentlichten Beispiel-Pipelines von SSL.com (z. B. github.com/SSLcom/codesigner-github-sample), bevor Sie mit der Fehlersuche fortfahren. |
|
|
Tippfehler in Konfigurationsparametern, z. B. wurde -topt anstelle von -totp verwendet. |
CI/CD-Pipeline |
Ein falsch geschriebener Parametername in der Pipeline-Konfigurationsdatei. |
Korrigieren Sie den Parameternamen im Pipeline-Skript in -topp (nicht -topt). |
|
|
SignTool-Fehler bei Verwendung des x64-Builds innerhalb des Pipeline-Runners |
CI/CD-Pipeline |
Die Umgebung des Pipeline-Runners ist inkompatibel mit der x64-Version von signtool.exe, wenn diese mit eSigner CKA verwendet wird. |
Ändern Sie den Pipeline-Schritt so, dass stattdessen die x86-Version von signtool.exe aufgerufen wird. |
|
|
„Die bereitgestellte Autorisierung ist ungültig, abgelaufen, widerrufen, stimmt nicht mit der in der Autorisierungsanfrage verwendeten Umleitungs-URI überein oder wurde einem anderen Client ausgestellt.“ / „Fehler: ungültige_Berechtigung“ |
CI/CD-Pipeline |
Es gibt mehrere mögliche Ursachen: Das Kontopasswort wurde zurückgesetzt, aber die Pipeline speichert noch das alte; die Pipeline verwendet die E-Mail-Adresse anstelle des Benutzernamens; Sonderzeichen im Passwort (z. B. $, !, Backticks) werden im Skript nicht korrekt maskiert; dieselben Anmeldeinformationen funktionieren lokal, schlagen aber speziell auf den Servern des CI/CD-Anbieters fehl; oder die passwortbasierte API-Anmeldung ist für das Konto nicht aktiviert. |
Verwenden Sie für die Authentifizierung den Benutzernamen (nicht die E-Mail-Adresse). Falls das Passwort kürzlich zurückgesetzt wurde, aktualisieren Sie die gespeicherten Anmeldeinformationen in der Pipeline. Setzen Sie die Variablen für die Anmeldeinformationen im Pipeline-Skript in Anführungszeichen, insbesondere wenn das Passwort Sonderzeichen enthält. Testen Sie die Anmeldeinformationen zunächst lokal mit dem Befehl `get_credential_ids` von CodeSignTool. Sollte der Test weiterhin fehlschlagen – insbesondere, wenn das Problem nur beim CI/CD-Anbieter und nicht lokal auftritt –, wenden Sie sich an den SSL.com-Support. Möglicherweise muss die API-Anmeldung aktiviert oder die Kontoautorisierung im Backend aktualisiert werden. |
SSL.com-Unterstützung |
|
„Anmeldeinformationen konnten nicht abgerufen werden. Fehler: Unerwartetes Zeichen beim Parsen des Werts gefunden: <. Pfad", Zeile 0, Position 0.“ |
CI/CD-Pipeline |
Aufgrund einer kurzen Störung auf den Servern von SSL.com wurde eine Webseite anstelle der erwarteten Daten angezeigt. Dies ist in der Regel nur vorübergehend. |
Warten Sie einen Moment und führen Sie den Befehl erneut aus. Sollte das Problem wiederholt auftreten, wenden Sie sich bitte an den SSL.com-Support. |
SSL.com-Unterstützung |
Zertifikatslebenszyklus und allgemeine Fehler
Fehler, die unabhängig von der Signaturmethode auftreten können – im Zusammenhang mit der Zertifikatsgültigkeit, der Vertrauenskette und der Schlüsselverwaltung.
|
Fehler/Symptom |
Interface |
Wahrscheinliche Ursache |
Auflösung |
Quelle |
|
Das Zertifikat ist abgelaufen oder wird nach der Unterzeichnung nicht mehr als vertrauenswürdig angesehen. |
N / A |
Ein Codesignaturzertifikat ist abgelaufen, und zuvor signierter Code war nicht mit einem Zeitstempel versehen, sodass die Gültigkeit seiner Signatur nun an den Ablauf des Zertifikats gebunden ist. |
Besorgen Sie sich ein neues Zertifikat und signieren Sie den betroffenen Code zukünftig neu; versehen Sie die Signaturen stets mit einem Zeitstempel zum Zeitpunkt der Unterzeichnung, damit die Gültigkeit über den Ablauf des Zertifikats hinausreicht. |
|
|
Zertifikat mit unerwartet kurzer Gültigkeitsdauer ausgestellt |
N / A |
Die Anforderungen des CA/Browser Forums begrenzen die Gültigkeitsdauer neu ausgestellter, öffentlich vertrauenswürdiger Codesignaturzertifikate ab dem 27. Februar 2026 auf 458 Tage. |
Dies ist eine branchenweite Anforderung und kein Fehler – Zertifikate müssen innerhalb der gleichen Laufzeit gegebenenfalls häufiger neu ausgestellt werden, ohne dass zusätzliche Kosten entstehen. |
Kurzübersicht: Mit welchem Leitfaden sollte ich beginnen?
- Signieren mit einem physischen YubiKey oder SafeNet-Token: Beginnen Sie mit Verwenden Ihres Codesignaturzertifikats
- Unterschreiben mit eSigner CodeSignTool: Beginnen Sie mit eSigner CodeSignTool-Befehlshandbuch
- Signieren mit dem eSigner Cloud Key Adapter (CKA): Beginnen Sie mit Wie man die EV-Codesignierung mit SignTool.exe oder Certutil.exe mithilfe des eSigner CKA (Cloud Key Adapter) automatisiert
- Automatisierte Signatur in CI/CD mit eSigner CKA: Beginnen Sie mit Wie man eSigner CKA in CI/CD-Tools integriert
- Automatisierte Signaturerstellung in CI/CD mit eSigner CodeSignTool
- Cloud Code Signing-Integration mit CircleCI
- Cloud Code Signing-Integration mit GitHub-Aktionen
- Cloud Code Signing-Integration mit GitLab CI
- Cloud Code Signing-Integration mit Travis CI
- Cloud Code Signing-Integration mit Jenkins CI
- Cloud Code Signing-Integration mit Azure DevOps
- Cloud Code Signing-Integration mit BitBucket
