Справочник за грешки при подписване на код: Често срещани съобщения за грешки, причини и решения

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

„Signtool“ не се разпознава като вътрешна или външна команда, изпълнима програма или пакетен файл“ 

CLI 

Командата беше въведена само с думата „signtool“ вместо с пълния път до signtool.exe. 

Заменете „signtool“ в командата с пълния път до signtool.exe (напр. C:\Program Files (x86)\Windows Kits\10\bin\) \x64\signtool.exe). 

Използване на вашия сертификат за подписване на код 

„Сертификатът за времева маркировка не отговаря на изискването за минимална дължина на публичния ключ“ 

CLI 

Сървърът за времеви печати по подразбиране на SSL.com издава времеви печати, базирани на ECDSA, а софтуерът/доставчикът за подписване не приема ключове за времеви печати на ECDSA. 

Помолете вашия доставчик на софтуер да разреши ECDSA ключове за времеви печати или използвайте остарялата крайна точка за времеви печати RSA. http://ts.ssl.com/legacy. 

Използване на вашия сертификат за подписване на код 

„Windows не може да провери издателя на този драйвер“ 

Windows система 

Софтуерът или драйверът е разпространен без приложен валиден сертификат за подписване на код, така че Windows не може да потвърди самоличността на издателя. 

Подпишете софтуера с валиден сертификат за подписване на код OV или EV преди разпространение. 

eSigner: Подписване на код като услуга 

Проблеми с конфигурацията след инсталиране на OV/EV сертификат 

Windows система 

Сертификатите за подписване на код OV и EV бяха инсталирани ръчно в хранилището за сертификати на компютъра, вместо да бъдат използвани от хардуерния токен/HSM. 

Не инсталирайте ръчно сертификати за подписване на код OV/EV; използвайте ги директно от токена YubiKey FIPS, токена SafeNet или чрез облачното подписване eSigner. 

Използване на вашия сертификат за подписване на код 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

Не знам/не мога да намеря ПИН или ПУК кода на YubiKey 

N / A 

ПИН/ПУК кодът никога не са били извлечени от портала на акаунта или токенът е бил преиздаден. 

Влезте в клиентския портал на SSL.com, отворете поръчката за сертификат и използвайте връзката „активиране“ под „Физически токени / YubiKey FIPS 140-2“, за да получите ПИН и PUK кода. 

Достъп до вашия PIN код и PUK на YubiKey FIPS 

YubiKey не е открит от компютъра / сертификатът не е намерен от SignTool 

Windows система 

Yubico Authenticator или необходимият мини-драйвер не е инсталиран, така че операционната система не може да види сертификата на токена. 

Инсталирайте Yubico Authenticator и мини-драйвера на YubiKey; преди да подпишете, проверете дали серийният номер на токена се показва в Yubico Authenticator. 

Използване на вашия сертификат за подписване на код 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

„Неправилна парола“ 

Приложение/GUI 

При подписване със SignTool беше въведена грешна парола/ПИН код за токен. 

Въведете отново правилната парола за токена; ако я забравите, извлечете я от данните за поръчката на вашия SSL.com акаунт или я нулирайте, като използвате вашия PUK код. 

Как да промените паролата си за Thales SafeNet/Gemalto Token 

„Токенът е заключен поради твърде много неуспешни опити за влизане“ 

Приложение/GUI 

Максималният брой разрешени опити за неправилно въвеждане на парола/ПИН е превишен. 

Отворете клиента за удостоверяване на SafeNet, използвайте разширения изглед, изберете „Задаване на парола за токен“, въведете вашия PUK код като администраторска парола, след което задайте и потвърдете нова парола за токен. 

Как да промените паролата си за Thales SafeNet/Gemalto Token 

„Signtool“ не се разпознава като вътрешна или външна команда, изпълнима програма или пакетен файл“ 

CLI 

Същият проблем с пътя на SignTool като в секцията с общия токен — командата е въведена без пълния път на изпълнимия файл. 

Заменете „signtool“ с пълния път до signtool.exe в командата. 

Използване на вашия сертификат за подписване на код 

Клиентът за удостоверяване на SafeNet не открива токена след инсталиране 

Windows система 

SAC беше инсталиран, но компютърът не беше рестартиран, така че промените в драйвера/услугата не са влезли в сила. 

Рестартирайте компютъра след инсталиране на SafeNet Authentication Client; тогава токенът би трябвало да бъде разпознат. 

Изтегляне на клиента за удостоверяване на SafeNet за сертификати за подписване на код 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

Не мога да намеря идентификационния номер на eSigner Credential ID 

Приложение/GUI 

Идентификаторът за идентификационни данни (задължителен за CodeSignTool и CSC API) не е намерен в портала на акаунта. 

В акаунта на SSL.com отворете поръчката за сертификат и превъртете до секцията „Удостоверения за подписване“, за да видите идентификационния номер на идентификационните данни на eSigner, серийния номер на сертификата и етикета на eSigner. 

Ръководство за идентификационни данни за подписване на eSigner 

„Грешка: невалиден OTP“ (ръчно подписване) 

Приложение/GUI 

QR кодът, сканиран в приложението за удостоверяване, не съвпада с използваното потребителско име/парола/идентификационен номер или еднократната парола (OTP) е с изтекъл срок. 

Уверете се, че сте сканирали QR кода на правилния акаунт (не споделения на съотборник), генерирайте отново нов OTP и го въведете отново незабавно, тъй като OTP изтичат бързо. 

eSigner CodeSignTool Командно ръководство 

„Грешка: невалиден OTP“ (автоматизирано / TOTP подписване) 

CLI 

Тайната TOTP принадлежи на различен акаунт/сертификат от посочените потребителско име, парола и идентификационен номер на идентификационните данни; самата тайна е невалидна; или системното време не е синхронизирано. 

Проверете дали тайната TOTP съответства на използвания акаунт и идентификационен номер за идентификация, потвърдете, че тайната е копирана правилно и синхронизирайте системния си часовник с надежден сървър за време (TOTP зависи от близкото съгласуване на времето със сървъра за подписване). 

Автоматизирайте подписването на eSigner EV Code 

„'C:\Users\Admin\Dropbox\My' не е разпознат като вътрешна или външна команда, изпълнима програма или пакетен файл.“ / „Системата не може да намери посочения път.“ 

CLI 

Път до файл, съдържащ интервали, беше предаден на CodeSignTool без кавички, така че обвивката го анализира като няколко отделни аргумента. 

Затворете пътя на входния файл и пътя на изходната директория в кавички и въведете или копирайте и поставете параметрите директно в командния ред, а не чрез друг текстов редактор. 

Подписване на код в NuGet пакети с eSigner 

„\Документи\примерът беше неочакван в този момент.“ 

CLI 

Продължение на същия неуспешен анализ на нецитиран път — шелът прекъсва пътя на мястото и третира останалата част като разпръснат токен. 

Отворете пълния път до файла в кавички, така че обвивката да го третира като един аргумент. 

Подписване на код в NuGet пакети с eSigner 

„ПРЕДУПРЕЖДЕНИЕ: sun.reflect.Reflection.getCallerClass не се поддържа. Това ще повлияе на производителността.“ 

CLI 

Безобидно предупреждение по време на изпълнение на Java, задействано от версията на JVM, използвана за изпълнение на CodeSignTool. 

Това е предупреждение за производителност, а не грешка при подписване — може да бъде пренебрегнато; проверете действителния изход за потвърждение „Кодът е подписан успешно“. 

Подписване на код в NuGet пакети с eSigner 

Командата за подписване е неуспешна безшумно или отхвърля идентификационни данни, когато паролата съдържа специални символи 

CLI 

Параметърът -password съдържа специални символи (напр. !, @, ^), но не е ограден в кавички, така че shell-ът неправилно анализира стойността. 

Поставете паролата в кавички, когато съдържа специални символи, например -password=”P!@^^ssword12″. 

eSigner CodeSignTool Командно ръководство 

Липсва параметърът credential_id (акаунти с множество сертификати) 

CLI 

Акаунтът има повече от един сертификат за подписване на код от eSigner, така че CodeSignTool не може да използва по подразбиране един единствен идентификационен номер. 

Изрично предайте -credential_id= в командата; използвайте get_credential_ids, за да изброите всички идентификационни номера на идентификационни данни за акаунта. 

eSigner CodeSignTool Командно ръководство 

{„error_description“: „код: QuotaExceededError – съобщение: Квотата е превишена“, „грешка“: „грешка_на_сървъра“} 

CLI / CI-CD 

Добавката за сканиране за злонамерен софтуер, свързана с идентификационните данни за подписване, е достигнала вътрешен лимит за употреба, дори ако таблото за управление на акаунта показва оставащи подписвания. 

Това не е нещо, което трябва да отстранявате сами. Свържете се с екипа за поддръжка на SSL.com, за да може екипът да коригира лимита за сканиране за злонамерен софтуер за акаунта; изчакайте до 1-2 часа след прилагането на корекцията, преди да опитате отново. 

Поддръжка на SSL.com (вътрешна / специфична за акаунта) 

„com.ssl.code.signing.tool.exception.CscApiException: грешка_на_сервера 500 в com.ssl.code.signing.tool.csc.CscApi.sendOtp(…)“ 

Файл на журнала 

Влизането е успешно, но заявката за изпращане на SMS еднократна парола е неуспешна поради проблем с конфигурацията, свързан с идентификационните данни за подписване от страна на SSL.com. 

Свържете се с поддръжката на SSL.com, за да нулирате конфигурацията на OTP на идентификационните данни. 

Поддръжка на SSL.com (вътрешна / специфична за акаунта) 

CodeSignTool отчита успех (код на изход 0), дори когато подписването всъщност е неуспешно 

CI/CD тръбопровод 

По-старите версии на CodeSignTool имаха грешка, която го караше да отчита успех, независимо от реалния резултат, което правеше откриването на повреди в конвейера трудно. 

Актуализирайте до най-новата версия на CodeSignTool, която правилно докладва за грешки. 

eSigner CodeSignTool Командно ръководство 

Достигнат е лимит на скоростта на удостоверяване при подписване на много файлове подред 

CI/CD тръбопровод 

За всеки отделен файл се изисква ново влизане/удостоверяване, вместо да се използва повторно един сесиен токен за множество подписвания. 

Използвайте повторно един и същ токен за удостоверяване по време на сесия за подписване, вместо да се удостоверявате преди всеки файл. Клиентите с голям обем/корпоративни клиенти, които все още достигат ограничения, трябва да се свържат с поддръжката на SSL.com, за да обсъдят ограниченията за своя акаунт. 

eSigner CodeSignTool Командно ръководство 

„Грешка: невалиден OTP“ (ръчно подписване) 

Приложение/GUI 

QR кодът, сканиран в приложението за удостоверяване, не съвпада с използваното потребителско име/парола/идентификационен номер или еднократната парола (OTP) е с изтекъл срок. 

Уверете се, че сте сканирали QR кода на правилния акаунт (не споделения на съотборник), генерирайте отново нов OTP и го въведете отново незабавно, тъй като OTP изтичат бързо. 

eSigner CodeSignTool Командно ръководство 

Невалиден подпис на MSI инсталатори, изградени с Visual Studio 

Приложение/GUI 

Известен проблем със съвместимостта между инсталаторите на eSigner и MSI, създадени от инструментите за пакетиране на Visual Studio. 

Създайте MSI инсталатори, използвайки WiX Toolset вместо Visual Studio като заобиколно решение. 

eSigner CodeSignTool Командно ръководство 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

„Сертификатът за времева маркировка не отговаря на изискването за минимална дължина на публичния ключ“ 

CLI 

Същият проблем със съвместимостта на ECDSA-timestamp като при подписване, базирано на токени, възникнал при използване на eSigner CKA със SignTool. 

Свържете се с вашия доставчик на софтуер, за да разрешите ECDSA ключове за времеви печати или използвайте старата крайна точка. http://ts.ssl.com/legacy за RSA времеви печат. 

Автоматизирайте подписването на EV код със SignTool/Certutil, използвайки eSigner CKA 

„Този ​​файлов формат не може да бъде подписан, защото не е разпознат.“ (подписване на .app файлове) 

CLI 

Опит за подписване на .app файл на Microsoft Dynamics 365 Business Central с eSigner CKA, преди самото приложение Dynamics 365 Business Central да е инсталирано, така че SignTool не може да анализира файловия формат. 

Първо инсталирайте Microsoft Dynamics 365 Business Central (опция за инсталиране на сървър), след което подпишете получения .app файл със SignTool чрез eSigner CKA. 

Как да подписвате цифрово .app файлове с помощта на eSigner CKA 

Подписването на VBA макрос се проваля безшумно / подписът е отхвърлен 

Приложение/GUI 

VBA изпраща на eSigner SHA1 хеш на кода, но eSigner изисква SHA256 или по-висок. 

Добавете DWORD стойността на системния регистър V1HashEnhanced под HKCU\SOFTWARE\Microsoft\VBA\Security и я задайте на 2 (SHA256), 3 (SHA384) или 4 (SHA512) според указанията на Microsoft, след което подпишете отново. 

Как да подписвате цифрово VBA макроси с помощта на eSigner CKA 

Сертификатът не се показва / не е използваем чрез SignTool 

Приложение/GUI 

eSigner CKA не е инсталиран или режимът на подписване (ръчен/автоматизиран) и типът на сертификата (продукционен/тестов) не са конфигурирани. 

Инсталирайте eSigner CKA и изрично конфигурирайте режима на подписване и типа на сертификата, преди да се опитате да подпишете; първо потвърдете регистрацията в eSigner. 

Автоматизирайте подписването на EV код със SignTool/Certutil, използвайки eSigner CKA 

„Идентификационните данни за подписване не са конфигурирани. Уверете се, че сертификатът е издаден преди подписване“ + „Неуспешно извличане на идентификатора на сертификата. Грешка: Препратката към обект не е зададена на екземпляр на обект.“ / (CLI) „Необработено изключение: System.NullReferenceException: Препратката към обект не е зададена на екземпляр на обект. в eSignerCKATool.eSignerCKATool.Config(CommandLineInfo commandLineInfo)“ 

Приложение/GUI + CLI 

Или останали/невалидни идентификационни данни за подпис в акаунта (като например стари, неизползвани идентификационни данни), които тази версия на eSigner CKA не пропуска правилно, или сертификат, който се показва като „Издаден“ в акаунта, но все още не е завършил свързването към облачния бекенд за подписване. 

Първо, опитайте да изтриете локалните конфигурационни папки %APPDATA%\eSignerCKA и %LOCALAPPDATA%\eSignerCKA, след което изпълнете отново командата config, като се уверите, че използвате -mode product и потребителското име на вашия акаунт (не имейл адреса си). Ако това не помогне, свържете се с поддръжката на SSL.com — премахването на невалидни идентификационни данни или завършването на настройката на сертификата изисква действие от страна на backend-а. CodeSignTool може да се използва като алтернатива междувременно. 

Поддръжка на SSL.com 

eSigner CKA се срива веднага след влизане (Windows Event Viewer): „.NET Runtime Event 1026 — System.AccessViolationException in eSignerCSP.UI.Utils.CspWrapper.C_UnloadAllCertificate during DisplayData“; продължава след рестартиране/преинсталиране 

Срив на лог файл / приложение 

Известен дефект в по-старите версии на eSigner CKA може да доведе до срив при стартиране, дори когато хранилището за сертификати е празно; понякога това е свързано с проблема с оставащите идентификационни данни. 

Това изисква актуализирана версия на eSigner CKA. Свържете се с поддръжката на SSL.com, за да може проблемът да бъде ескалиран до инженерния отдел. Междувременно използвайте CodeSignTool за подписване. 

Поддръжка на SSL.com (вътрешна / специфична за акаунта) 

„[Грешка] Не можа да бъде намерен файл „C:\Program Files (x86)\SSL Corp eSigner CKA\eSignerKSP64.dll“.“ / „[Грешка] Не можа да бъде намерен файл „C:\Program Files (x86)\SSL Corp eSigner CKA\eSignerKSP32.dll“.“ 

Файл на журнала 

Някои компилации на инсталатора на eSigner CKA липсват тези поддържащи файлове след преименуване на вътрешен компонент – това не е причинено от нищо на вашия компютър. 

Преинсталирайте напълно eSigner CKA: премахнете папките Program Files и AppData, рестартирайте и след това преинсталирайте. Подписването може да продължи да работи дори когато това съобщение е налично. Ако файловете все още липсват, свържете се с поддръжката на SSL.com за коригиран инсталатор. 

Поддръжка на SSL.com 

„Невалиден OTP“ само в автоматичен/автоматичен режим на подписване (ръчният режим работи) 

Приложение/GUI 

Обикновено е неправилен TOTP секретен код, TOTP секретен код, който не съответства на използвания идентификационен номер за идентификация, или часовникът на компютъра не е синхронизиран. Понякога се причинява от останал конфигурационен файл от предишна инсталация, който е в конфликт с текущия. 

Уверете се, че използвате правилния TOTP секретен код за въпросния идентификационен номер и че системният ви часовник е точен. Ако това продължава, изтрийте %APPDATA%\eSignerCKA и %LOCALAPPDATA%\eSignerCKA и преинсталирайте eSigner CKA. 

Поддръжка на SSL.com 

„SignerSign() е неуспешно. (-2146893821/0x80090003 NTE_BAD_KEY)“ / „signtool.exe: Грешка в SignTool: Възникна неочаквана вътрешна грешка.“ — по време на подписване на голям обем пакети (обикновено след ~100 файла) 

CLI / CI-CD 

Функцията за сканиране за злонамерен софтуер в акаунта достига вътрешен лимит за използване по време на подписване на голям обем пакети, прекъсвайки сесията за подписване. 

Свържете се с поддръжката на SSL.com, за да коригирате лимита за сканиране за злонамерен софтуер за подписване с голям обем в акаунта. Като заобиколно решение, влизайте на по-малки партиди и обновявайте идентификационните данни (config -r) между партидите. 

Поддръжка на SSL.com (вътрешна / специфична за акаунта) 

„Състоянието на ключа е деактивирано“ при всяко действие на eSigner (подписване, нулиране на ПИН, нулиране на QR код) 

Приложение/GUI / CLI 

Идентификационните данни за подпис са деактивирани в бекенда на SSL.com. 

Свържете се с поддръжката на SSL.com — само SSL.com може да активира отново деактивирани идентификационни данни за подпис; това не може да бъде решено от страна на клиента. 

Поддръжка на SSL.com (вътрешна / специфична за акаунта) 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

„Грешка: хешът, който трябва да бъде подписан, е хеш на обект на злонамерен софтуер“ 

CLI 

Сканирането за зловреден софтуер откри положително съвпадение в изпратения файл и автоматично спря процеса на подписване, както е проектирано. 

Това е очаквано поведение при откриване на злонамерен софтуер — прегледайте и отстранете маркирания файл, преди да го изпратите отново; това не е конфигурационна грешка, освен ако сканирането не е било предвидено да бъде включено. 

Как да използвате сканиране за злонамерен софтуер преди подписване с SSL.com eSigner 

Сканирането за злонамерен софтуер не се прилага към заявките за подписване 

Приложение/GUI 

Бутонът за избор „блокирането на зловреден софтуер е активирано“ не беше активиран заедно с „идентификационните данни за подписване са активирани“ в секцията „Идентификационни данни за подписване“ на акаунта. 

На страницата за поръчка на сертификат на SSL.com, под „Удостоверения за подписване“, се уверете, че са избрани и двете опции: „удостоверенията за подписване са активирани“ и „блокирането на зловреден софтуер е активирано“, преди да подпишете. 

Как да използвате сканиране за злонамерен софтуер преди подписване с SSL.com eSigner 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

Стъпката за подписване се проваля по средата на процеса без ясна причина 

CI/CD тръбопровод 

В скрипта на конвейера (YAML/Groovy/и др.) около стъпката на подписване бяха въведени типографски грешки или погрешни прекъсвания на редовете. 

Внимателно прегледайте скрипта на конвейера за правописни грешки и прекъсвания на редовете; сравнете с публикуваните от SSL.com примерни конвейери (напр. github.com/SSLcom/codesigner-github-sample), преди да продължите с отстраняването на неизправности. 

Интегриране на подписване на облачен код с GitHub Actions 

Печатна грешка в конфигурационния параметър, например използва се -topt вместо -totp 

CI/CD тръбопровод 

Неправилно изписано име на параметър в конфигурационния файл на конвейера. 

Коригирайте името на параметъра на -totp (не -topt) в скрипта на конвейера. 

eSigner CodeSignTool Командно ръководство 

Грешка в SignTool при използване на x64 компилация вътре в конвейера 

CI/CD тръбопровод 

Средата на pipeline runner е несъвместима с x64 версията на signtool.exe, когато се използва с eSigner CKA. 

Превключете стъпката на конвейера, за да извикате x86 версията на signtool.exe вместо това. 

Как да интегрирате eSigner CKA с CI/CD инструменти 

„Предоставеното разрешение за оторизация е невалидно, изтекло, отменено, не съответства на URI адреса за пренасочване, използван в заявката за оторизация, или е издадено на друг клиент.“ / „Грешка: invalid_grant“ 

CI/CD тръбопровод 

Няколко възможни причини: паролата за акаунта е била нулирана, но в конвейера все още е запазена старата; конвейерът използва имейл адреса вместо потребителското име на акаунта; специалните символи в паролата (напр. $, !, обратни бележки) не са правилно цитирани в скрипта; същите идентификационни данни работят локално, но не се получават правилно от сървърите на доставчика на CI/CD; или входът в API, базиран на парола, не е активиран за акаунта. 

Използвайте потребителското име на акаунта (не имейл адреса) за удостоверяване. Ако паролата е била нулирана наскоро, актуализирайте запазените идентификационни данни в конвейера. Поставете променливите на идентификационните данни в кавички в скрипта на конвейера, особено ако паролата съдържа специални символи. Първо тествайте идентификационните данни локално с командата get_credential_ids на CodeSignTool. Ако все още не е възможно — особено ако се случва само от доставчика на CI/CD, а не локално — свържете се с поддръжката на SSL.com, тъй като може да се изисква активиране на вход през API или обновяване на оторизацията на акаунта в backend-а. 

Поддръжка на SSL.com 

„Не може да се извлече идентификатор на идентификационни данни. Грешка: Открит е неочакван символ при анализа на стойността: <. Път“, ред 0, позиция 0.“ 

CI/CD тръбопровод 

Кратък проблем на сървърите на SSL.com върна уеб страница вместо очакваните данни. Това обикновено е временно. 

Изчакайте малко и изпълнете командата отново. Ако това се случва многократно, свържете се с поддръжката на SSL.com.  

Поддръжка на SSL.com 

Грешка / Симптом 

Interface 

Вероятна причина 

Резолюция 

източник 

Сертификатът е изтекъл или вече не е надежден след подписването му 

N / A 

Сертификатът за подписване на код е с изтекъл срок на валидност и подписаният преди това код не е бил с времеви печат, така че валидността на подписа му вече е обвързана с изтичането на срока на валидност на сертификата. 

Вземете нов сертификат и подпишете отново засегнатия код оттук нататък; винаги поставяйте времеви печат на подписите в момента на подписване, така че валидността да е удължена след изтичане на срока на валидност на сертификата. 

Какво е сертификат за подписване на код? 

Сертификат, издаден с неочаквано кратък срок на валидност 

N / A 

Изискванията на CA/Browser Forum вече ограничават новоиздадените публично доверени сертификати за подписване на код до 458 дни, считано от 27 февруари 2026 г. 

Това е изискване за целия бранш, а не грешка — сертификатите може да се нуждаят от преиздаване по-често в рамките на един и същ закупен срок, без допълнителни разходи. 

Какво е сертификат за подписване на код?