Навигация
Услуга удаленного подписания кода предоставляет различные клиенты, системные провайдеры, интерфейсы разработки и способы интеграции автоматизации.
Если вы не уверены, какой способ выбрать, вы можете начать со следующих вариантов в зависимости от сценария использования.
Как выбрать способ интеграции
| Сценарий использования | Рекомендуемый способ |
|---|---|
| Использование официального инструмента командной строки для непосредственного подписания файлов EXE, DLL, MSI и других | Инструмент клиента |
| Установка клиента подписания кода через Homebrew на macOS | Инструмент клиента |
| Инструменты Windows, такие как Microsoft SignTool, Visual Studio, MSBuild, которым необходимо напрямую использовать удаленный закрытый ключ | Windows Provider |
| Необходимость совместимости с традиционными приложениями Windows CryptoAPI / CSP | Windows Provider |
Использование jarsigner для подписания файлов Java JAR | Интеграция с Java |
| Автоматическое подписание кода в GitHub Actions | CI/CD и инструменты сборки |
| Использование Electron Builder для автоматического подписания приложений Windows | CI/CD и инструменты сборки |
| Использование Advanced Installer для сборки и подписи установочного пакета | CI/CD и инструменты сборки |
| Самостоятельная разработка клиента или прямой вызов службы удалённой подписи | Интеграция по API |
| Запрос количества подписей, сервера службы времени и другой публичной информации | Справочные материалы |
Клиентские инструменты
Подходит для пользователей, которые хотят напрямую использовать официальный клиент sslTrus для подписи кода.
В основном включает:
- SignTool CLI: подписание файлов непосредственно из командной строки.
- Проверка квоты подписей: запрос оставшегося и общего количества подписей сертификата.
- Обновление клиента: проверка и установка последней версии.
- Homebrew: установка CLI или настольного клиента в macOS.
Посмотреть клиентские инструменты →
Windows Provider
Подходит для Microsoft SignTool, Visual Studio, MSBuild, инструментов создания установочных пакетов и другого программного обеспечения, поддерживающего Windows Cryptography API.
Предоставляются два вида Provider:
- KSP (Key Storage Provider): на основе Windows CNG, подходит для современных процессов подписи в Windows.
- CSP (Cryptographic Service Provider): на основе традиционного CryptoAPI, подходит для приложений, которым требуется совместимость с CSP.
Закрытый ключ подписи всегда хранится в облачном HSM, а локальный Provider отвечает за отправку запроса подписи в службу удалённой подписи кода.
Интеграция с Java
Подходит для сценариев подписи кода на Java.
С помощью Java Provider от sslTrus можно выполнять удалённую подпись кода JAR-файлов стандартным инструментом jarsigner.
Посмотреть интеграцию с Java →
CI/CD и инструменты сборки
Подходит для сценариев, в которых подпись кода необходимо интегрировать в процессы автоматической сборки, публикации или упаковки.
В настоящее время включает:
- GitHub Actions
- Electron Builder
- Advanced Installer
В дальнейшем способы интеграции других CI/CD-систем и инструментов сборки также будут представлены на этой странице.
Посмотреть CI/CD и инструменты сборки →
Интеграция по API
Подходит для разработчиков, которым необходимо самостоятельно разработать клиент подписи кода или встроить возможности удалённой подписи в существующие системы.
API удалённой подписи кода поддерживает:
- Отправку дайджеста для подписи и получение результата подписи.
- Передачу итогового статуса обработки подписи от клиента.
Вызывающая сторона отвечает за локальное вычисление дайджеста файла, обработку структуры подписи и запись итогового результата подписи.
Справочные материалы
Здесь представлена общая справочная информация, подходящая для различных способов интеграции, включая:
- Описание расчета количества подписей: объясняет, как рассчитывается количество подписей в сценариях CLI, KSP, CSP, Jarsigner, Electron и установочных пакетов.
- Сервер меток времени: знакомит с Authenticode, RFC 3161 и распространенными службами меток времени для подписи кода.