Как автоматизировать подписание кода EV с помощью SignTool.exe или Certutil.exe, используя eSigner CKA (Cloud Key Adapter)

eSigner CKA (адаптер облачного ключа) Это приложение для Windows, использующее интерфейс CNG (KSP Key Service Provider) для обеспечения... Certutil.exe и signtool.exe для выполнения операций по подписанию кода с помощью API eSigner CSC.

Функционируя как виртуальный USB-токенОн обеспечивает безопасную загрузку сертификатов для подписи кода в хранилище сертификатов Windows без необходимости использования физического оборудования. Будучи облачным методом подписи, eSigner CKA устраняет затраты, логистические проблемы и риски безопасности, связанные с USB-токенами, предоставляя при этом возможности подписи корпоративного уровня без сложностей, связанных с сетевыми HSM. Это делает его масштабируемое, безопасное и экономически эффективное решение для современных рабочих процессов цифровой подписи кода.

Это руководство охватывает Ручная и автоматизированная подпись кода в Windows с помощью SignTool. с производственными или тестовыми сертификатами. В отличие от физических токенов, eSigner CKA поддерживает продвинутая автоматизацияобеспечивая бесшовную интеграцию с инструментами CI/CD, такими как GitHub Actions, GitLab CI, CircleCI и Travis CIЕсли вы используете инструмент CI/CD, ознакомьтесь с этим руководством: Как интегрировать eSigner CKA с инструментами CI/CD для автоматической подписи кода.

Требования

  1. Сертификат подписи кода, выданный SSLcom. 
  2. Сертификат Code Signing должен быть в настоящее время зарегистрирован на eSigner. Обратитесь к этому руководству: Зарегистрируйтесь в eSigner для удаленной подписи документов и кода
  3. Установите eSigner CKA на свой компьютер и настройте режим подписи (ручной или автоматический) и тип подписи (производственный или тестовый). Инструкции по установке см. в этой статье: Как установить адаптер облачного ключа SSL.com eSigner (CKA).

Пользователи могут подписывать код с помощью функции подписи кода расширенной проверки eSigner. Щелкните ниже для получения дополнительной информации.

Подробнее

Дополнительная процедура: использование сканирования на наличие вредоносных программ с предварительной подписью

Malware Scan — это важный сервис от SSL.com, который гарантирует, что программное обеспечение не содержит вредоносных программ, прежде чем оно будет подписано сертификатом подписи кода. Интегрируя Malware Scan, разработчики добавляют надежный уровень безопасности, автоматически останавливая процесс подписи при обнаружении вредоносного ПО и предупреждая разработчика о необходимости предпринять необходимые действия.

SSL.com оставляет за собой право требовать сканирования на наличие вредоносного ПО при наличии явных признаков повышенного риска безопасности, и клиентам может быть не разрешено отказаться от сканирования до тех пор, пока проблемы безопасности не будут устранены.

Инструкция по применению

  1. Войдите в свою учетную запись SSL.com. Нажмите на вкладку заказы, а затем скачать ссылку вашего сертификата, чтобы отобразить его детали. Прокрутите вниз до ПОДПИСАНИЕ ПОЛНОМОЧИЙ раздел и найдите часть, показывающую ваши учетные данные сертификата eSigner. Убедитесь, что переключатели с надписью учетные данные для подписи включены  и  блокировщик вредоносных программ включен выбраны.
  2. Установите адаптер облачного ключа eSigner.
  3. Установите eSigner CodeSignTool. Нажмите здесь для загрузки eSigner CodeSignTool.
  4. Сканируйте код в CodeSignTool с помощью следующей команды: scan_code [-hV] -input_file_path=<inputFilePath> -password=<PASSWORD> [-program_name=<programName>] -username=<USERNAME>
  5. Используйте SignTool, чтобы подписать код с помощью eSigner CKA, используя следующую команду: scan_code -username=<USERNAME> -password=<PASSWORD> -credential_id=<eSigner Credential ID> -input_file_path=<inputFilePath>

Параметры:

  • -input_file_path=<PATH>: Путь к объекту кода, который нужно подписать.
  • -username=<USERNAME>: SSL.com имя пользователя учетной записи
  • -password=<PASSWORD>: SSL.com пароль от аккаунта.
  • -program_name=<PROGRAM_NAME>: Название программы
  • -credential_id=<CREDENTIAL_ID>: Идентификатор учетных данных для подписи сертификата. Ваш идентификатор учетной записи eSigner находится в вашем SSL.com страница заказа сертификата.

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

Компоненты команды

Как для ручного, так и для автоматического подписания кода команда содержит:

  1. Расположение SignTool (инструмент командной строки, отвечающий за цифровую подпись файла и проверяющий подпись), заключенное в двойные кавычки. Пример: «C:\Program Files (x86)\Windows Kits\10\bin\10.0.22000.0\x86\signtool.exe»
    Примечание: местоположение SignTool будет зависеть от версии загруженного SDK и используемой архитектуры.
  2. /ФД sha256 параметр, определяющий алгоритм хэширования
  3. / тр http://ts.ssl.com опция, указывающая адрес сервера временных меток
  4. / тд ша256 опция, которая определяет алгоритм дайджеста метки времени
  5. / sha1 параметр, указывающий отпечаток, который SignTool использует для поиска соответствующего сертификата подписи кода в хранилище ключей.
  6. Настоящий отпечаток сертификата
  7. Путь к файлу, который будет подписан, заключен в двойные кавычки: «SIGNABLE FILE PATH»

В целом команда должна выглядеть следующим образом: 

«C:\Program Files (x86)\Windows Kits\10\bin\10.0.22000.0\x86\signtool.exe» знак /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 отпечаток сертификата « ПОДПИСЫВАЕМЫЙ ПУТЬ К ФАЙЛУ». 

Примечание: По умолчанию SSL.com поддерживает метки времени из ключей ECDSA.

Если вы столкнулись с этой ошибкой: The timestamp certificate does not meet a minimum public key length requirement, вам следует обратиться к поставщику программного обеспечения, чтобы разрешить временные метки из ключей ECDSA.

Если ваш поставщик программного обеспечения не может разрешить использование обычной конечной точки, вы можете использовать эту устаревшую конечную точку. http://ts.ssl.com/legacy чтобы получить временную метку из модуля временных меток RSA.

Как найти отпечаток сертификата

Позже, после установки eSigner CKA и добавления сертификата подписи кода EV в Хранилище сертификатов пользователей, вы сможете проверить отпечаток своего сертификата подписи кода EV, нажав Windows Key + R а затем введите certmgr.msc для доступа к хранилищу сертификатов пользователей. Когда появится окно диспетчера сертификатов, нажмите кнопку Индивидуальный папку на левой панели, а затем выберите Сертификаты подпапку справа, чтобы найти сертификат подписи кода EV.

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

Подписание кода вручную

Установите eSigner CKA

Доступ к SignTool через командную строку

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

«C:\Program Files (x86)\Windows Kits\10\bin\10.0.22000.0\x86\signtool.exe» знак /fd sha256 /tr http://ts.ssl.com /td sha256 /sha1 отпечаток сертификата « ПОДПИСЫВАЕМЫЙ ПУТЬ К ФАЙЛУ»

После написания команды и нажатия Enter, вы увидите сообщение Готово Добавление дополнительного магазина. Затем появится всплывающее окно, требующее от вас ввести имя пользователя и пароль учетной записи SSL.com.

Введите одноразовый пароль (OTP) 

Одноразовый пароль (OTP) для вашего сертификата подписи кода EV, зарегистрированного eSigner, будет отправлен в ваше приложение Authenticator. После успешного ввода командная строка укажет, что ваш файл был успешно подписан.

Успех! Ваш код теперь подписан. 

Проверьте цифровую подпись в файле

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

Вы сможете прочитать информацию, гласящую: Эта цифровая подпись в порядке. Нажмите кнопку Посмотреть сертификат .

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

Автоматическая подпись кода

Доступ к SignTool через команду

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

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 отпечаток сертификата «SIGNABLE ПУТЬ ФАЙЛА"

Открыто Командная строка и поместите команду. После нажатия Enter вы увидите уведомление, в котором говорится: Готово Добавление дополнительного магазина.

Через несколько секунд вы увидите уведомление Успешно подписано. Это означает, что ваш файл был подписан автоматически, без дополнительных одноразовых паролей. 

Проверьте наличие цифровой подписи на вашем файле

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

Затем появится всплывающее окно с сообщением о том, что цифровая подпись файла действительна, а также с указанием конкретного времени, когда он был подписан. Нажмите на Посмотреть сертификат кнопку, чтобы просмотреть дополнительную информацию о выданном цифровом сертификате подписи кода EV. 

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

Сопутствующие руководства по подписанию кода с использованием eSigner CKA

  • Подписание файлов комплекта для разработки аппаратного обеспечения (HLK) – Используйте eSigner CKA с HLKSigntool Для тестирования и подготовки драйверов режима ядра для отправки в Microsoft. Интеграция с платформой HLK от Microsoft требует использования HLKSigntool.
  • Подписание макросов VBA – Узнайте, как подписывать макросы Microsoft Visual Basic for Applications (VBA), которые автоматизируют задачи в приложениях Office без необходимости обладать навыками программирования.
  • Подписание файлов .app - Знак .приложение файлы для безопасного определения и указания идентификаторов всего решения на основе приложений Microsoft.
  • Подписание файлов .vsix - Знак .vsix Установочные пакеты для расширений и дополнений Visual Studio, обеспечивающие целостность и подлинность компонентов IDE.

Нужна дополнительная информация о подписании документов в облаке? 

  1. eSigner: подпись кода как услуга
  2. Облачная автоматизация подписи кода с помощью CI/CD Services

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

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

SSL.com

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

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

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

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

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

3rd Party Cookies

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

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

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