主要なポイント(要点)
- コード署名証明書を使用すると、ソフトウェアに暗号署名を行うことができ、ユーザーやオペレーティングシステムは、誰がソフトウェアを公開したのかを確認し、リリース以降に改ざんされていないことを検証できます。
- SSL.com は、FIPS 認証済みのハードウェア (YubiKey または Thales SafeNet USB トークン) またはクラウドベースのサービスにのみコード署名秘密鍵を発行します。 電子署名者 サービス — 秘密鍵はダウンロード可能なファイルとしてエクスポートすることはできません .PFX ファイルにソフトウェアを指定する必要があります。
- 署名はマイクロソフトの サインツールまたは電子署名ツール(電子署名者CKA, 電子署名者 CodeSignTool証明書がトークン上に存在するかクラウド上に存在するかによって、eSigner CSC API または (eSigner CSC API)が使用されます。
- 2026年3月1日現在、CA/Browser Forumの基本要件により、公的に信頼されるコード署名証明書の有効期間は458日間に制限されています。お客様が購入された期間には影響はありませんが、その期間内の個々の証明書は定期的な再発行が必要になる場合があります。
- 署名には必ずタイムスタンプを付けてください。そうすれば、証明書の有効期限が切れた後も署名は有効です。
すべての署名方法に共通する前提条件
開始する前に、どの証明書配信方法を使用する場合でも、以下のものを用意してください。
- Windows SDKの インストール、含まれ サインツール (SignToolにはWindows 10/11 SDKが同梱されているため、別途ダウンロードする必要はありません。)
- その 署名する予定のファイル ローカルに保存され、コマンドラインからアクセス可能
- 署名マシンへの管理者アクセスが必要です。一部の設定手順とSignToolの操作には管理者権限が必要となるためです。
ここから先は、証明書がハードウェアトークン上にあるか、eSignerに登録されているかによって、セットアップの手順が分岐します。
オプション1:トークンベースのコード署名
SSL.comは、以下の2種類のハードウェアトークンにコード署名証明書を同梱して出荷しています。 YubiKey (FIPS認証済み) タレスセーフネット(ジェマルト)このガイドは、トークンに証明書が既にインストールされていることを前提としています。
A. YubiKeyコード署名
インストールと構成の要件
- Windows SDKとSignToolをインストールしてください。 SignToolはWindows 10/11 SDKにバンドルされており、通常は次のようなパスにインストールされます。 C:\ Program Files(x86)\ Windows Kits \ 10 \ bin \ \ x64 \ signtool.exe.
- ダウンロードしてインストール YubiKeyスマートカードミニドライバーYubico社から入手可能です。このドライバーは、WindowsがFIPSトークンを認識するために必要です。
- YubiKeyのPINコードを確認してください。 サインインするたびにこのPINコードの入力を求められます。PINコードはSSL.comアカウントから確認できます。
最初のファイルに署名する
トークンが接続され、ミニドライバーがインストールされたら、PowerShellまたはコマンドプロンプトを開いて、以下を実行します。
.\signtool.exe sign /fd sha256 /a "C:\path\to\MyExecutable.exe"
このコマンドの各部分が何をするのか、以下に説明します。
.\signtool.exeSignTool を呼び出します。SDK のバージョンと PATH の設定方法によっては、代わりに完全なパスが必要になる場合があります。 signtool.exe.
/fd sha256署名時に使用するダイジェスト(ハッシュ)アルゴリズムを設定します。このフラグは、Windows 10 SDK、HLK、WDK、およびADKのビルド20236以降で必須であり、セキュリティ強化のためSHA1よりもSHA256の使用が推奨されます。
/aSignToolに適切なコード署名証明書を自動的に選択するように指示します。これは、証明書が1つしかない場合に便利です。
"C:\path\to\MyExecutable.exe"これは、署名するファイルの完全なパスです。
操作を承認するために、YubiKeyのPINを入力するよう求められます。
タイムスタンプを追加する(推奨)
タイムスタンプは、証明書の有効期限が切れた後でも署名が有効であることを保証します。タイムスタンプによって、コードが証明書の有効期間中に署名されたことが証明されるからです。 /tr http://ts.ssl.com /td sha256 あなたのコマンドに対して — SSL.com のタイムスタンプ サーバーは、 /tr 特にフラグ (古いものではなく) /t 旗)、 /td 来なきゃ After /tr または、SignToolは警告なしに、より脆弱なSHA-1タイムスタンプアルゴリズムをデフォルトとして使用します。
B. タレスセーフネット(ジェマルト)USBトークン
インストールと構成の要件
- Windows SDKとSignToolをインストールしてください。 (上記と同じ)。
- SafeNet認証クライアントをインストールしますThales SafeNetハードウェアを管理するミドルウェア。 詳細なダウンロードおよびインストール手順を含む完全ガイドについては、以下をご覧ください。 コード署名証明書用の SafeNet 認証クライアントのダウンロード
- Thales SafeNetトークンを有効化してください。 SSL.comは出荷前にトークンに証明書をプリインストールするため、アクティベーションはローカルではなくSSL.comアカウントを通じて行われます。
- 物理的なトークンに印刷されているシリアル番号を探してください。
- SSL.comアカウントにサインインして、 注文 タブには何も表示されないことに注意してください。
- 証明書の注文のダウンロード/詳細リンクをクリックして、 物理トークン のセクションから無料でダウンロードできます。
- トークンのシリアル番号を入力して有効化してください。 アクティベーションPIN (トークンパスワードとも呼ばれ、署名時に入力します) 管理者PIN (PUKとも呼ばれ、ロックされたトークンをリセットするためにのみ使用されます。)
最初のファイルに署名する
- Thales SafeNetトークンをコンピュータに接続してください。
- トークンが認識されるように、SafeNet認証クライアントを開いてください。
- 署名コマンドを実行します。
signtool sign /tr http://ts.ssl.com /td sha256 /fd sha256 /a "PATH_OF_FILE_TO_BE_SIGNED"
/fd sha256— 署名に使用されるダイジェストアルゴリズム
/trhttp://ts.ssl.com— SSL.comのタイムスタンプサーバーアドレス
/td sha256— タイムスタンプダイジェストアルゴリズム
/a— 適切な証明書を自動的に選択します
- ファイルパスは二重引用符で囲み、ファイル名自体を含める必要があります。例:
"C:\Users\Admin\Documents\test file.dll".
Windowsが報告する場合 サインツール コマンドとして認識されません。 サインツール 引用符で囲まれた完全なパスを含むコマンドで signtool.exe (正確なパスは、インストールされているSDKのバージョンとアーキテクチャによって異なります。)
- コマンドプロンプトを実行する 管理者として そしてコマンドを実行します。
- プロンプトが表示されたら、あなたのものを入力してください トークンパスワード (SSL.comの注文ページに記載されているアクティベーションPIN)
- 成功メッセージが表示されれば、ファイルが署名されたことが確認できます。
トークンがロックされた場合、またはパスワードを変更する必要がある場合は、PINを繰り返し推測しようとしないでください。トークンがロックされる可能性があります。
署名の検証(両方のトークンタイプに対応)
署名後、署名が有効であることを確認してください。
.\signtool.exe verify /pa "C:\path\to\MyExecutable.exe"
成功した場合は、使用されたアルゴリズムとタイムスタンプが表示されます。署名されたファイルを右クリックして開くこともできます。 特性、およびを確認します デジタル署名 タブをタップして、署名者の身元と署名日を視覚的に確認してください。
オプション2:SSL.com eSignerクラウドコード署名
物理トークンの管理がチームにとって現実的でない場合(特に分散開発者や自動ビルドパイプラインの場合)、 電子署名者 eSignerを使用すると、インターネットに接続された任意のデバイスからリモートでコードに署名できます。秘密鍵は、管理対象のハードウェアではなく、SSL.comのクラウドHSMに保護されます。eSignerコード署名にはEVコード署名証明書が必要で、Microsoft Authenticode形式(.exeファイル, のDLL, .sys, .ocxMSIインストーラー、PowerShellスクリプト、CABファイルとCATファイル、Java、その他)、MSIインストーラー、PowerShellスクリプト、CABファイルとCATファイル、Java 。ジャー コード署名の場合、ファイル、およびeSigner CKAで署名した場合はMSIX、MDB、ACCDEファイルも署名対象となります。eSigner ExpressまたはeSigner APIのどちらを使用する場合でも、コード署名の最大ファイルサイズは200MBです。
ステップ1:eSignerに証明書を登録する
署名を行う前に、証明書の注文をeSignerに登録し、すべての署名操作で必須となる二要素認証(2FA)と組み合わせる必要があります。登録方法は2つあります。
QRコード(認証アプリ)方式
- SSL.comアカウントにログインし、クリックします。 注文そして、証明書注文の詳細ページを開きます。
- 見つける eSigner クラウド署名登録 セクションと選択 OTPアプリ 第二認証方法として使用します。
- 4桁のPINを作成し、安全な場所に保存してください。理想的にはパスワードマネージャーに保存するのが良いでしょう。後で署名デバイスを追加、削除、または交換する際に必要になるからです。
- 詳しくはこちら OTP の作成と証明書の発行QRコードが表示されます。
- Google AuthenticatorやAuthyなどの認証アプリでQRコードをスキャンしてください。アプリは、今後の署名操作すべてに使用する30秒間のワンタイムパスワードを生成します。QRコードは一度しか表示されないため、ページを再読み込みしても再表示されません。
OTP SMS メソッド
- SSL.comアカウントにログインし(複数のチームに所属している場合は、正しいチームを選択してください)、クリックします。 注文そして、証明書の詳細ページを開きます。
- 二要素認証選択 OTP SMS.
- 携帯番号の確認 セクションで、国コードを選択し、携帯電話番号を入力してクリックします。 OTP SMSを送信.
- 携帯電話で「AuthMSG」(SSL.comの認証サービス)から届いた6桁のコードを確認し、注文ページに入力してクリックしてください。 電話を確認する.
- 確認したらクリック OTP の作成と証明書の発行 登録を完了するには、以下の手順に従ってください。その後、アカウントページに認証済みの電話番号の下4桁が表示されます。
ステップ2:署名ツールを選択する
登録が完了したら、ご自身のワークフローに合った署名方法を選択してください。
eSigner クラウド キー アダプター (CKA)
仮想USBトークンのように動作するWindowsアプリケーションで、クラウドベースの証明書をWindows証明書ストアにロードし、次のような使い慣れたツールが signtool.exe (NAIST) と certutil.exe 直接使用できます。これは、物理的なハードウェアを使用せずに既存のSignToolベースのワークフローを継続して使用したいチームにとって最適な選択肢です。
認定要件: eSignerに証明書が登録されていること。eSigner CKAがインストールされ、手動署名または自動署名用に構成されていること。Windows SDK/SignToolがインストールされていること。署名するファイルがローカルに保存されていること。手動署名の場合は、2要素認証(2FA)方法が準備されていること。
典型的な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— ハッシュアルゴリズム
/trhttp://ts.ssl.com(NAIST) と/td sha256— タイムスタンプサーバーとダイジェストアルゴリズム
/sha1 CERTIFICATE_THUMBPRINT— 証明書ストアからどの証明書を使用するかをサムプリントで識別します。
- 署名可能なファイルのパスは引用符で囲む必要があります。
一部のファイルタイプでは、eSigner CKAで署名する前に追加の設定が必要です。SSL.comでは、それぞれのファイルタイプに対応した専用ガイドを提供しています。
- ハードウェア ラボ キット (HLK) ファイルの署名 — eSigner CKAとHLKSigntoolを使用してカーネルモードドライバを準備し、Microsoftに提出する
- VBAマクロの署名 — Office タスクを自動化するために使用される Microsoft Visual Basic for Applications マクロに署名する
- .app ファイルの署名 — 完全な Microsoft アプリケーション ソリューションの ID を安全に定義および参照する
- .vsix ファイルの署名 — Visual Studio拡張機能およびアドオンパッケージへの署名
eSigner CKAは、CircleCI、GitHub Actions、GitLab CI、Travis CI、Azure PipelinesなどのCI/CDプラットフォームとも統合されており、署名を完全に自動化できます。
電子署名者 CodeSignTool
CodeSignToolは、クロスプラットフォーム対応のJavaベースのコマンドラインユーティリティで、CI/CDパイプラインを含む自動化された大量署名処理向けに構築されています。CodeSignToolは、実際のファイルを送信するのではなく、ファイルの暗号化ハッシュのみをSSL.comに送信して署名を行います。これは、ネットワーク外に漏洩してはならない機密コードがファイルに含まれている場合に特に有効な利点となります。
CI/CD自動化において、CodeSignToolは以下の環境変数に依存します。
|
変数 |
目的 |
|
USERNAME |
SSL.comアカウントのユーザー名 |
|
PASSWORD |
SSL.comアカウントのパスワード |
|
CREDENTIAL_ID |
使用するコード署名証明書を指定します。複数のeSigner証明書をお持ちの場合にのみ必須です。単一の証明書で省略した場合、その証明書がデフォルトで使用されます。 |
|
TOTP_SECRET |
自動化された 2FA に使用される OAuth TOTP シークレットについては、以下を参照してください。 eSignerEVコード署名の自動化 ガイド |
|
ENVIRONMENT_NAME |
に設定され テスト or プロッド |
そして、これらの入力値:
- 入力ファイルパス (必須)— 署名対象ファイルのパス
- 出力ディレクトリのパス 署名済みファイルの保存先ディレクトリ。省略した場合、元のファイルは署名済みバージョンで上書きされます。
プラットフォーム固有の統合ガイドは、以下のタイトルでも入手可能です。
よくある質問
コード署名用の秘密鍵をエクスポートして、別のマシンで使用することはできますか? いいえ。CA/Browser Forumの基本要件に基づき、SSL.comのコード署名秘密鍵はエクスポートできず、ダウンロード可能な形で発行されることもありません。 .PFX ファイルは保存されます。鍵は、FIPS認証済みのYubiKey、Thales SafeNetトークン、またはSSL.comのeSignerクラウドHSM内にのみ保存されます。
なぜ私の証明書の有効期限が短くなったのですか? 2026年3月1日より、CA/Browser Forumの基本要件により、公開信頼コード署名証明書の最大有効期間が458日に制限されます。これはお客様が購入された証明書の価値を損なうものではありません。SSL.comは2026年2月27日から新規証明書の発行にこの制限を適用しており、お客様は購入された有効期間を全うできますが、有効期間内の個々の証明書はより頻繁に再発行が必要になる場合があります。
署名したコードにタイムスタンプを付ける必要はありますか? はい。信頼できるタイムスタンプがない場合、証明書の有効期限が切れた瞬間に署名は無効になります。タイムスタンプがあれば、証明書が有効な期間中にコードが署名されたことが証明されるため、署名は無期限に信頼できるままです。
トークンベース署名とeSignerの違いは何ですか? トークンベースの署名(YubiKeyやThales SafeNetなど)では、秘密鍵は署名マシンに接続する必要のある物理ハードウェア上に保管されます。一方、eSignerはSSL.comのクラウドHSMに鍵を保管し、2要素認証(2FA)を使用してインターネットに接続されたあらゆるデバイスから署名できるようにします。これは、分散型チームやCI/CD自動化に適しています。
eSignerで署名できるファイルの種類は何ですか? eSignerは、Microsoft Authenticode形式(EXE、DLL、SYS、OCX、および関連タイプ)、MSIインストーラー、PowerShellスクリプト、CAB/CATファイル、Java JARファイルに加え、eSigner CKAで署名されたMSIX、MDB、ACCDEファイルをサポートしています。ドキュメント署名(PDF、DOCX、PPTX、XLSX)は、eSignerのドキュメント署名ツールで別途処理されます。
結論
単一の開発者マシンから時折インストーラーに署名する場合でも、CI/CD パイプライン全体で数千もの署名操作を自動化する場合でも、根本的な目標は同じです。それは、ソフトウェアがまさにあなたが主張する通りのものであり、リリース後に変更されていないことを、顧客、パートナー、およびオペレーティングシステムに証明することです。YubiKey または Thales SafeNet を使用したトークンベースの署名は、小規模チームや署名頻度の低いニーズに適した、ハードウェアによる直接的な制御を提供します。一方、eSigner のクラウドベースのモデルは、物理的なトークンの煩わしさを完全に排除し、分散チームや自動ビルドシステムがどこからでも安全にコードに署名できるようにします。
署名環境が正しく設定されれば、日々のプロセスはハッシュ化、署名、タイムスタンプ、検証というルーチン作業になります。最初から正しく設定することで、ブラウザやOSのセキュリティ警告が減り、ブランドへの信頼が高まり、進化し続けるCA/Browser Forumの要件への準拠もスムーズになります。設定に関するご質問がある場合は、SSL.comのサポートチームまでメールでお問い合わせください。 Support@SSL.com、電話で 1-877-SSL-SECUREまたはライブチャットでお問い合わせください。