ナビゲーション
リモートコードサイニングサービスは、多様なクライアント、システムプロバイダー、開発インターフェース、自動化統合方式を提供します。
どの方式を選べばよいか分からない場合は、利用シーンに応じて以下から始めてください。
統合方式の選び方
| 利用シーン | 推奨方式 |
|---|---|
| 公式コマンドラインツールで EXE、DLL、MSI などのファイルに直接署名する | クライアントツール |
| macOS で Homebrew を使ってコードサイニングクライアントをインストールする | クライアントツール |
| Microsoft SignTool、Visual Studio、MSBuild などの Windows ツールでリモート秘密鍵を直接使用する必要がある | 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：macOS に CLI またはデスクトップクライアントをインストールします。
Windows Provider
Microsoft SignTool、Visual Studio、MSBuild、インストールパッケージツール、および Windows Cryptography API に対応するその他のソフトウェア向けです。
2 種類の Provider を提供しています：
- KSP（Key Storage Provider）：Windows CNG に基づき、最新の Windows 署名フローに適しています。
- CSP（Cryptographic Service Provider）：従来の CryptoAPI に基づき、CSP 互換性が必要なアプリケーションに適しています。
署名秘密鍵は常にクラウド HSM 内に保存され、ローカル Provider は署名リクエストをリモートコード署名サービスへ送信する役割を担います。
Java 連携
Java コード署名のシーン向けです。
sslTrus が提供する Java Provider を使用すると、標準の jarsigner ツールで JAR ファイルに対してリモートコード署名を実行できます。
CI/CD とビルドツール
コード署名を自動ビルド、リリース、またはパッケージ化フローに統合する必要があるシーン向けです。
現在含まれているもの：
- GitHub Actions
- Electron Builder
- Advanced Installer
今後、その他の CI/CD またはビルドツールとの連携方法もこのページで提供される予定です。
API 連携
コード署名クライアントを独自開発するか、リモート署名機能を既存システムに統合する必要がある開発者向けです。
リモートコード署名 API は以下に対応しています：
- 署名対象ダイジェストを送信し、署名結果を取得します。
- クライアントの最終署名処理ステータスを報告します。
呼び出し側は、ローカルでファイルのダイジェスト計算、署名構造の処理、および最終署名結果の書き込みを担当します。
参考資料
ここでは、さまざまな連携方式に対応する共通の参考情報を提供します。内容は以下のとおりです。
- 署名回数の計算方法：CLI、KSP、CSP、Jarsigner、Electron、インストールパッケージなどのシナリオで署名回数を計算する方法について説明します。
- タイムスタンプサーバー：Authenticode、RFC 3161、および一般的なコード署名用タイムスタンプサービスを紹介します。