Начало работы с сертификатом для подписи кода: установка, настройка и первая операция подписи.

Пошаговое руководство по подписанию кода с использованием токенов и облачных сервисов (eSigner) для разработчиков, ИТ-команд и PKI администраторы.

Основные выводы 

  • Сертификат цифровой подписи позволяет криптографически подписывать программное обеспечение, чтобы пользователи и операционные системы могли проверить, кто его опубликовал, и убедиться, что оно не было изменено после выпуска. 
  • SSL.com выдает закрытые ключи для подписи кода только на оборудование, прошедшее проверку FIPS (токены YubiKey или Thales SafeNet USB), или в облачные сервисы. Электронная подпись Сервис — закрытые ключи никогда не могут быть экспортированы в виде загружаемых файлов. . PFX . 
  • Подписание осуществляется с помощью программного обеспечения Microsoft. ЗнакИнструментили инструмент eSigner (eSigner ЦКА, eSigner CodeSignTool(или API eSigner CSC), в зависимости от того, хранится ли ваш сертификат на токене или в облаке. 
  • Начиная с 1 марта 2026 года, базовые требования CA/Browser Forum ограничивают срок действия общедоступных доверенных сертификатов для подписи кода 458 днями; приобретенный вами срок действия остается неизменным, но отдельные сертификаты в течение этого срока могут нуждаться в периодической перевыпуске. 
  • Всегда ставьте отметку времени на своих подписях, чтобы они оставались действительными после истечения срока действия самого сертификата. 

 

 

Общие предварительные условия для всех методов подписания документов. 

Прежде чем начать, независимо от используемого метода доставки сертификата, убедитесь, что у вас есть: 

  • Windows SDK установлен, Который включает в себя ЗнакИнструмент (SignTool поставляется с SDK для Windows 10/11 — отдельная загрузка не требуется) 
  • файл, который вы намереваетесь подписать сохранено локально и доступно из командной строки 
  • Для работы с машиной, на которой осуществляется подписание, необходимы права администратора, поскольку некоторые этапы настройки и операции SignTool требуют повышенных привилегий. 

Далее путь настройки разветвляется в зависимости от того, находится ли ваш сертификат на аппаратном токене или зарегистрирован в eSigner. 

 

Вариант 1: Подписание кода на основе токенов 

SSL.com поставляет сертификаты для подписи кода на двух поддерживаемых аппаратных токенах: YubiKey (Проверено по стандарту FIPS) и Thales SafeNet (Gemalto)Данное руководство предполагает, что сертификат уже установлен на вашем токене. 

А. Подписание кода YubiKey 

Требования к установке и настройке 

  1. Установите Windows SDK и SignTool. SignTool входит в состав Windows 10/11 SDK и обычно устанавливается по пути, аналогичному указанному в исходном коде. C: \ Program Files (x86) \ Комплекты Windows \ 10 \ bin \ \ x64 \ signtool.exe. 
  2. Загрузите и установите Мини-драйвер смарт-карты YubiKeyЭтот драйвер доступен у компании Yubico. Он необходим для того, чтобы Windows распознала токен FIPS. 
  3. Найдите свой PIN-код YubiKey. Этот PIN-код будет запрашиваться каждый раз при входе в систему. Его можно посмотреть в вашей учетной записи SSL.com. 

Полное руководство с подробными скриншотами по поиску PIN-кода и PUK-кода смотрите здесь: Получите доступ к PIN-коду и PUK YubiKey FIPS
 

Подписание вашего первого файла 

Подключив токен и установив мини-драйвер, откройте PowerShell или командную строку и выполните следующую команду: 

.\signtool.exe sign /fd sha256 /a "C:\path\to\MyExecutable.exe" 

Вот что делает каждая часть этой команды: 

  • .\signtool.exe Вызывает SignTool. В зависимости от версии вашего SDK и настроек переменной PATH, вам может потребоваться указать полный путь к signtool.exe. 
  • /fd sha256 Этот флаг задает алгоритм хеширования (дайджеста), используемый при подписи. Он обязателен для сборок Windows 10 SDK, HLK, WDK и ADK 20236 и выше, и для повышения безопасности рекомендуется использовать SHA256 вместо SHA1. 
  • /a Указывает SignTool автоматически выбрать подходящий сертификат для подписи кода — это полезно, когда присутствует только один сертификат. 
  • "C:\path\to\MyExecutable.exe" Это полный путь к файлу, который вы подписываете. 

Для подтверждения операции вам будет предложено ввести PIN-код вашего YubiKey. 

Добавление временной метки (рекомендуется)

Использование временной метки гарантирует, что ваша подпись останется действительной даже после истечения срока действия сертификата, поскольку временная метка доказывает, что код был подписан, когда сертификат еще был действителен. /tr http://ts.ssl.com /td sha256 по вашей команде — обратите внимание, что сервер временных меток SSL.com требует /tr конкретно флаг (не более старый) /t флаг), и /td должен прийти после /tr или SignTool молча будет использовать более слабый алгоритм временной метки SHA-1. 

Полное руководство — включая способы выбора конкретного сертификата при наличии нескольких, полные параметры добавления временных меток и дополнительные флаги SignTool — видеть: Использование сертификата для подписи кода: Подписание исполняемого файла с помощью YubiKey

B. Thales SafeNet (Gemalto) USB-токен 

Требования к установке и настройке 

  1. Установите Windows SDK и SignTool. (как указано выше). 
  2. Установите клиент аутентификации SafeNet., это промежуточное программное обеспечение, которое управляет оборудованием Thales SafeNet. Полное руководство, включая подробные инструкции по загрузке и установке, см.: Загрузка клиента аутентификации SafeNet для сертификатов подписи кода 
  3. Активируйте свой токен Thales SafeNet. Поскольку SSL.com предварительно устанавливает сертификат на токен перед отправкой, активация осуществляется через вашу учетную запись SSL.com, а не локально: 
  4. Найдите серийный номер, напечатанный на самом жетоне. 
  5. Войдите в свою учетную запись SSL.com и откройте Заказы меню. 
  6. Для заказа сертификата нажмите на ссылку «Загрузка/Подробности», затем найдите Физические токены . 
  7. Введите серийный номер токена для его активации. Это покажет ваш номер. PIN-код активации (также называемый паролем-токеном, вводимый при входе в систему) и ваш ПИН-код администратора (также называемый PUK, используется только для сброса заблокированного токена). 

Подписание вашего первого файла 

  1. Подключите токен Thales SafeNet к компьютеру. 
  2. Откройте клиент аутентификации SafeNet, чтобы токен был распознан. 
  3. Выполните команду подписи: 

signtool sign /tr http://ts.ssl.com /td sha256 /fd sha256 /a "PATH_OF_FILE_TO_BE_SIGNED" 

  • /fd sha256 — алгоритм дайджеста, используемый для подписи 
  • /tr http://ts.ssl.com — Адрес сервера временных меток SSL.com 
  • /td sha256 — алгоритм дайджеста временной метки 
  • /a — автоматически выбирает соответствующий сертификат 
  • Путь к файлу должен быть заключен в двойные кавычки и включать само имя файла, например: "C:\Users\Admin\Documents\test file.dll". 

Если Windows сообщит об этом вывеска не распознается как команда, замените вывеска в команде с полным указанием пути к signtool.exe (Точный путь зависит от установленной версии SDK и архитектуры). 

  1. Запустить командную строку как администратор и выполнить команду. 
  2. При появлении запроса введите свой Пароль токена (ПИН-код активации со страницы вашего заказа SSL.com). 
  3. Сообщение об успешном завершении работы подтвердит, что файл подписан. 

Полное руководство — включая инструкции по выбору конкретного сертификата по имени субъекта или отпечатку пальца, если их несколько, а также полные шаги проверки подписи. видеть: Подписание кода с помощью USB-токена Thales SafeNet (Gemalto).
 

Если ваш токен заблокирован или вам нужно изменить его пароль, не пытайтесь многократно угадывать PIN-код, так как это может заблокировать токен. 

Полное руководство см. здесь: Как изменить пароль токена Thales SafeNet/Gemalto
 

Проверка вашей подписи (для обоих типов токенов) 

После подписания подтвердите действительность подписи: 

.\signtool.exe verify /pa "C:\path\to\MyExecutable.exe" 

В случае успешного результата отображается использованный алгоритм и метка времени. Вы также можете щелкнуть правой кнопкой мыши по подписанному файлу и открыть его. Основные свойства, и включите Цифровые подписи Вкладка для визуального подтверждения личности подписавшего и даты подписания. 

Вариант 2: SSL.com eSigner Cloud Code Signing 

Если управление физическими токенами нецелесообразно для вашей команды — особенно для распределенных разработчиков или автоматизированных конвейеров сборки — Электронная подпись Позволяет подписывать код удалённо с любого устройства, подключенного к интернету, при этом закрытый ключ защищён в облачном HSM SSL.com, а не на управляемом вами оборудовании. Для подписи кода eSigner требуется сертификат EV Code Signing Certificate, и поддерживается широкий спектр типов файлов, включая форматы Microsoft Authenticode..exe, . DLL, .sys, .ocx(и другие), установщики MSI, сценарии PowerShell, файлы CAB и CAT, Java .jar файлы, а также — при подписании через eSigner CKA — файлы MSIX, MDB и ACCDE. Максимальный размер файла для подписи кода составляет 200 МБ независимо от того, используете ли вы eSigner Express или eSigner API. 

Полный и актуальный список поддерживаемых типов файлов и ограничений по размеру (включая форматы для подписи документов) см. в следующем: Типы файлов, поддерживаемые eSigner
 

Шаг 1: Зарегистрируйте свой сертификат в eSigner. 

Прежде чем вы сможете что-либо подписать, ваш заказ на сертификат должен быть зарегистрирован в eSigner и сопряжен с двухфакторной аутентификацией (2FA), которая требуется при каждой операции подписания. У вас есть два способа регистрации: 

Метод QR-кода (приложение-аутентификатор) 

  1. Войдите в свою учетную запись SSL.com, нажмите Заказыи откройте страницу с подробной информацией о вашем заказе на сертификат. 
  2. Найдите Регистрация подписи в облаке eSigner раздел и выберите ПРИЛОЖЕНИЕ OTP в качестве второго факторного метода. 
  3. Создайте 4-значный PIN-код и надежно сохраните его — в идеале в менеджере паролей, поскольку он понадобится вам позже для добавления, удаления или замены устройств подписи. 
  4. Нажмите создать OTP и выдать сертификатПоявляется QR-код. 
  5. Отсканируйте QR-код с помощью приложения-аутентификатора, например Google Authenticator или Authy. Приложение сгенерирует одноразовые пароли с интервалом в 30 секунд, которые будут использоваться для каждой последующей операции подписи. Обратите внимание, что QR-код отображается только один раз — он не появится снова при перезагрузке страницы. 

OTP SMS-метод 

  1. Войдите в свою учетную запись SSL.com (выберите правильную команду, если вы состоите в нескольких командах), нажмите Заказыи откройте страницу с подробными сведениями о вашем сертификате. 
  2. Под Второй фактор аутентификации, наведите на ОТП СМС. 
  3. В Верификация мобильного номера В разделе выберите код вашей страны, введите номер мобильного телефона и нажмите. отправить OTP SMS. 
  4. Проверьте свой телефон на наличие 6-значного кода от «AuthMSG» (сервис проверки SSL.com), введите его на странице заказа и нажмите кнопку. проверить телефон. 
  5. После проверки нажмите создать OTP и выдать сертификат Для завершения регистрации. После этого на странице вашего аккаунта отобразятся последние четыре цифры подтвержденного номера телефона. 

Полное руководство по регистрации, включая скриншоты для обоих способов, смотрите здесь: Зарегистрируйтесь в eSigner для удаленной подписи документов и кода
 

Шаг 2: Выберите инструмент для подписания. 

После регистрации выберите способ подписания, который подходит для вашего рабочего процесса: 

Адаптер облачного ключа eSigner (CKA) 

 Приложение для Windows, которое работает как виртуальный USB-токен, загружая ваш облачный сертификат в хранилище сертификатов Windows, чтобы такие привычные инструменты, как... signtool.exe и Certutil.exe Его можно использовать напрямую. Это лучший вариант для команд, которые хотят продолжать использовать существующие рабочие процессы на основе SignTool без физического оборудования. 

Обязательные условия: Сертификат зарегистрирован в eSigner; eSigner CKA установлен и настроен для ручного или автоматического подписания; Windows SDK/SignTool установлен; файл для подписи сохранен локально; и, для ручного подписания, ваш метод двухфакторной аутентификации готов. 

Полное руководство по установке и настройке см. в: Как установить адаптер облачного ключа SSL.com eSigner (CKA)
  

Типичная команда подписи CKA выглядит следующим образом: 

"C:\Program Files (x86)\Windows Kits\10\bin\10.0.22000.0\x86\signtool.exe" sign /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 CERTIFICATE_THUMBPRINT "SIGNABLE_FILE_PATH" 

  • /fd sha256 — алгоритм хеширования 
  • /tr http://ts.ssl.com и /td sha256 — сервер временных меток и алгоритм дайджеста 
  • /sha1 CERTIFICATE_THUMBPRINT — определяет, какой сертификат из хранилища сертификатов использовать по отпечатку. 
  • Путь к файлу, подлежащему подписанию, следует заключить в кавычки. 

Для некоторых типов файлов требуется дополнительная настройка, прежде чем eSigner CKA сможет их подписать. На сайте SSL.com есть отдельные руководства для каждого из них: 

  • Подписание макросов VBA — Подписание макросов Microsoft Visual Basic for Applications, используемых для автоматизации задач Office. 
  • Подписание файлов .app — Надежное определение и указание идентификатора полного решения на основе приложений Microsoft. 

eSigner CKA также интегрируется с платформами CI/CD, включая CircleCI, GitHub Actions, GitLab CI, Travis CI и Azure Pipelines, для полностью автоматизированного подписания. 

 

eSigner CodeSignTool 

Кроссплатформенная утилита командной строки на основе Java, созданная для автоматизированного и высокопроизводительного подписания файлов, включая конвейеры CI/CD. Вместо передачи самого файла, CodeSignTool отправляет в SSL.com только криптографический хеш файла для подписания, что является существенным преимуществом, если ваши файлы содержат конфиденциальный код, который не должен покидать вашу сеть. 

Для автоматизации CI/CD CodeSignTool использует следующие переменные среды: 

Технология 

Цель 

USERNAME 

Имя пользователя вашей учетной записи SSL.com 

PASSWORD 

Пароль вашей учетной записи SSL.com 

CREDENTIAL_ID 

Указывает, какой сертификат для подписи кода использовать — требуется только в том случае, если у вас более одного сертификата eSigner; если этот параметр отсутствует при наличии одного сертификата, по умолчанию используется именно он. 

TOTP_SECRET 

Секретный ключ TOTP OAuth используется для автоматической двухфакторной аутентификации — см. Автоматизация подписи кода eSigner EV инструкция 

ИМЯ_ОКРУЖАЮЩЕЙ СРЕДЫ 

Установить ИСПЫТАНИЕ or PROD 

И вот эти входные данные: 

  • путь_входного_файла (обязательно) — путь к файлу, который необходимо подписать. 
  • выходной_каталог_путь — Каталог назначения для подписанного файла; если этот параметр опущен, исходный файл будет перезаписан подписанной версией. 

Полную справочную информацию по командам локальной подписи см. в следующем: Руководство по командам eSigner CodeSignTool
 

Руководства по интеграции для конкретных платформ также доступны под следующими названиями: 

Часто задаваемые вопросы 

Могу ли я экспортировать свой закрытый ключ для подписи кода, чтобы использовать его на другом компьютере? Нет. В соответствии с базовыми требованиями CA/Browser Forum, закрытые ключи для подписи кода SSL.com не могут быть экспортированы и никогда не предоставляются для скачивания. . PFX Файлы. Ключи хранятся только на сертифицированном по стандарту FIPS YubiKey, токене Thales SafeNet или в облачном HSM eSigner от SSL.com. 

Почему срок действия моего сертификата сократился? С 1 марта 2026 года базовые требования CA/Browser Forum ограничивают максимальный срок действия общедоступных сертификатов подписи кода 458 днями. Это не снижает ценность приобретенного вами сертификата — SSL.com начал применять это ограничение на выдачу новых сертификатов с 27 февраля 2026 года, и клиенты по-прежнему получают сертификаты на весь приобретенный срок, хотя отдельные сертификаты в течение этого срока могут нуждаться в перевыпуске чаще. 

Нужно ли мне добавлять отметку времени к подписанному коду? Да. Без доверенной метки времени ваша подпись становится недействительной в момент истечения срока действия сертификата. С меткой времени подпись остается доверенной неограниченно долго, поскольку она доказывает, что код был подписан, пока сертификат был действителен. 

В чём разница между подписанием на основе токенов и электронной подписью (eSigner)? Подписание с использованием токенов (YubiKey или Thales SafeNet) хранит ваш закрытый ключ на физическом оборудовании, которое должно быть подключено к машине для подписания. eSigner хранит ключ в облачном HSM от SSL.com и позволяет подписывать с любого устройства, подключенного к интернету, используя двухфакторную аутентификацию — это лучше подходит для распределенных команд или автоматизации CI/CD. 

Какие типы файлов я могу подписать с помощью eSigner? eSigner поддерживает форматы Microsoft Authenticode (EXE, DLL, SYS, OCX и аналогичные типы), установщики MSI, сценарии PowerShell, файлы CAB/CAT и файлы Java JAR, а также MSIX, MDB и ACCDE при подписании через eSigner CKA. Подписание документов (PDF, DOCX, PPTX, XLSX) осуществляется отдельно с помощью инструментов подписи документов eSigner. 

Заключение 

Независимо от того, подписываете ли вы отдельные установщики с одного компьютера разработчика или автоматизируете тысячи операций подписи в рамках конвейера CI/CD, основная цель одна и та же: доказать вашим клиентам, партнерам и операционным системам, что ваше программное обеспечение в точности соответствует заявленному и не было изменено с момента его выпуска. Подписание на основе токенов с помощью YubiKey или Thales SafeNet обеспечивает прямой контроль с аппаратной поддержкой, что хорошо подходит для небольших команд или нечастых задач подписи, в то время как облачная модель eSigner полностью устраняет неудобства, связанные с физическими токенами, позволяя распределенным командам и автоматизированным системам сборки безопасно подписывать код из любого места. 

После правильной настройки среды подписи повседневный процесс становится рутинным: хеширование, подпись, метка времени, проверка. Правильная настройка с первого раза означает меньше предупреждений безопасности от браузера и операционной системы, укрепление доверия к бренду и более плавный путь к соответствию требованиям CA/Browser Forum по мере их постоянного развития. Если у вас возникнут вопросы, касающиеся вашей конфигурации, вы можете связаться со службой поддержки SSL.com по электронной почте: Support@SSL.com, по телефону 1-877-SSL-SECUREили через онлайн-чат. 

Будьте в курсе и будьте в безопасности

SSL.com является мировым лидером в области кибербезопасности, PKI и цифровые сертификаты. Подпишитесь, чтобы получать последние новости отрасли, советы и анонсы продуктов от SSL.com.

SSL.com

Мы будем рады вашим отзывам

Пройдите наш опрос и поделитесь с нами своими мыслями о своей недавней покупке.

Обзор конфиденциальности
SSL.com

Этот веб-сайт использует файлы cookie, чтобы мы могли предоставить вам наилучшие возможности для пользователей. Информация о файлах cookie хранится в вашем браузере и выполняет такие функции, как распознавание вас, когда вы возвращаетесь на наш сайт, и помогает нашей команде понять, какие разделы сайта вы считаете наиболее интересными и полезными.

Для получения дополнительной информации читайте наш Cookie и заявление о конфиденциальности.

3rd Party Cookies

Этот сайт использует Google Analytics и счетчик статистики собирать анонимную информацию, такую ​​как количество посетителей сайта и самых популярных страниц.

Включение этих файлов cookie помогает нам улучшить наш веб-сайт.

Показать детали