Delphi、C++ Builder、.NET ライブラリと署名サーバー

Delphi、.NET、CI/CD から使う Azure Trusted Signing

Delphi または .NET から、Azure Trusted Signing で Windows アプリケーションに署名します。

EXE と DLL ファイルに Authenticode 署名
秘密鍵は Azure に保管
ローカルの PFX も USB トークンも不要
ビルドエージェントは Azure のシークレットなしで署名
TsgcAzureTrustedSigningProviderOAuth2 クライアント資格情報Microsoft 発行のパブリックトラスト証明書リモート署名サーバー

CI パイプラインから署名 → · 価格を見る →

SignWithAzure.pas
// Authenticode-sign with Azure Trusted Signing
var
  vKeyProvider: TsgcAzureTrustedSigningProvider;
  vSigner: TsgcAuthenticodeSigner;
begin
  vKeyProvider := TsgcAzureTrustedSigningProvider.Create(nil);
  vSigner := TsgcAuthenticodeSigner.Create(nil);
  try
    vKeyProvider.TenantId := '00000000-0000-0000-0000-000000000000';
    vKeyProvider.ClientId := '11111111-1111-1111-1111-111111111111';
    vKeyProvider.ClientSecret := 'my-client-secret';
    vKeyProvider.AccountName := 'my-trusted-signing-account';
    vKeyProvider.CertificateProfileName := 'public-trust';
    vKeyProvider.Endpoint := 'https://eus.codesigning.azure.net';
    vKeyProvider.Connect;

    vSigner.KeyProvider := vKeyProvider;
    vSigner.Level := alBES;   // alT additionally requires a TSAClient
    vSigner.SignFile('myapp.exe', 'myapp-signed.exe');
  finally
    vSigner.Free;
    vKeyProvider.Free;
  end;
end;

sgcSign が Azure Trusted Signing を使う仕組み

自分の Delphi または .NET のコードから、あるいは sgcSign Server を通じて任意の CI パイプラインから、Azure Trusted Signing で Windows アプリケーションに署名します。秘密鍵は Azure に残ります。

1 つのキープロバイダーで、署名できる場所は 3 つです:Delphi アプリケーション、.NET コード、そして署名サーバー経由のビルドパイプライン。

Azure Trusted Signing(旧 Azure Code Signing)は Microsoft のコード署名サービスです。Microsoft が証明書を所有して署名鍵を用意し、秘密鍵はすべて Azure の中にあります。sgcSign は TsgcAzureTrustedSigningProvider を通じてこれと連携し、OAuth2 クライアント資格情報で認証します。

sgcSign のすべてのキープロバイダーは IsgcKeyProvider を実装しているため、署名コードは鍵の保管場所を気にしません。ローカルの PFX で開発し、Windows 証明書ストアでテストし、プロバイダーを 1 つ入れ替えるだけで Azure Trusted Signing でリリースできます。その他の選択肢はキープロバイダーのページに掲載しています。

Delphi と C++ Builder から

TsgcAuthenticodeSigner は Azure プロバイダーを KeyProvider として受け取り、Windows 上で、外部の署名ツールなしに、.exe、.dll、.sys、.ocx、.cpl、.scr ファイルをプロセス内で署名します。

.NET から

esegece.sgcSign の NuGet パッケージには、同じプロパティを持つ同じ TsgcAzureTrustedSigningProvider クラスがあり、C# で署名者の KeyProvider に割り当てます。

CI/CD から

sgcSign Server は、Azure の認証情報を AzureTS プロバイダーとして保持します。ビルドエージェントは API キーを使って HTTPS 経由で署名し、テナント、クライアント、シークレットを目にすることはありません。

設定する内容

Azure ポータルでの 3 つのステップの後、sgcSign にプロバイダーの値を設定します。同じ値が、Delphi と .NET のプロバイダー、およびサーバーの設定で使われます。

Azure アカウントから最初の署名まで

  1. Azure ポータルで Azure Trusted Signing アカウントを作成します。
  2. 証明書プロファイルを作成し、プロファイル名を控えます。
  3. Azure AD アプリケーションを登録し、Trusted Signing Certificate Profile Signer ロールを付与します。
  4. テナント ID、クライアント ID、クライアントシークレット、アカウント名、証明書プロファイル名でプロバイダーを設定します。Endpoint は、アカウントの署名エンドポイント URL を設定します。

署名の前に、プロバイダーの Connect を呼び出します。サーバーでは、クライアントシークレットを環境変数から取得できるため、設定ファイルに書き込まれることはありません。

settings.txt
Delphi / .NET property     Server param (AzureTS)
TenantId                   tenant_id
ClientId                   client_id
ClientSecret               client_secret_env
AccountName                account
CertificateProfileName     certificate_profile
Endpoint                   endpoint

Delphi での Authenticode オプション

上のヒーローセクションのコードで、作業のすべてです。TsgcAuthenticodeSigner のこれらのプロパティが、生成される署名の内容を決めます。

タイムスタンプ付き署名

Level の既定は alT で、TSAClient に割り当てた TsgcTSAClient を通じて RFC 3161 のタイムスタンプを追加します。alBES はタイムスタンプなしで署名します。

ハッシュと発行元の詳細

Hash の既定は ahSHA256 です。Description と URL は、プログラム名と詳細情報へのリンクを署名に埋め込みます。

デュアル署名

AppendSignature を True に設定すると、署名済みのファイルに入れ子の署名を追加できます。たとえば、古い Windows 向けに SHA-1、現在の Windows 向けに SHA-256 を使います。

ファイル、ストリーム、メモリ

SignFile はファイルを読み書きし、SignStream はストリームを扱い、SignBytes はメモリ上のバイナリに署名します。

C# でも同じプロバイダー

.NET ライブラリは Delphi の名前をそのまま保持しているため、両方の言語から署名するチームは、Azure Trusted Signing を一度設定するだけで済みます。

インストール、設定、割り当て

  • dotnet add package esegece.sgcSign で Registered パッケージを追加します。
  • TsgcAzureTrustedSigningProvider に、テナント、クライアント、シークレット、アカウント、証明書プロファイルを設定します。
  • Delphi とまったく同じように、署名者の KeyProvider に割り当てます。
  • NuGet パッケージ、ClickOnce マニフェスト、VSIX 拡張は、同じ Azure プロバイダーを使って sgcSign Server が署名します。
AzureProvider.cs
var azure = new TsgcAzureTrustedSigningProvider();
azure.TenantId = "your-tenant-id";
azure.ClientId = "your-client-id";
azure.ClientSecret = "your-client-secret";
azure.AccountName = "your-account-name";
azure.CertificateProfileName = "your-profile";

// Assign it to the KeyProvider of an sgcSign signer
signer.KeyProvider = azure;

Azure Trusted Signing で CI パイプラインから署名

Azure の認証情報を、すべてのビルドエージェントではなく、1 台の sgcSign Server に置きます。ランナーは API キーを持ち、HTTPS 経由で署名します。

1 つのプロバイダーエントリで、すべてのランナーに対応

  • sgcSignServer.conf.json に AzureTS プロバイダーを追加します。_env で終わるパラメーターは環境変数から読み取られるため、クライアントシークレットがファイルに残りません。
  • sgcSignServer --selftest-providers は、設定を読み込み、すべてのプロバイダーを初期化して終了するため、本番稼働前に Azure の値を確認できます。
  • sgcsign クライアントは、ランナー上で実行ファイルのハッシュを計算し、ハッシュだけを送信します。サーバーが Azure Trusted Signing で署名し、クライアントが署名を埋め込みます。
  • プロジェクトごとの API キー、任意の承認、ハッシュチェーン化された監査ログが、Azure プロファイルで誰が何に署名したかを記録します。
sgcSignServer.conf.json
"providers": [
  {
    "name": "release",
    "type": "AzureTS",
    "params": {
      "tenant_id": "00000000-0000-0000-0000-000000000000",
      "client_id": "00000000-0000-0000-0000-000000000000",
      "client_secret_env": "SGCSIGN_AZURE_TS_SECRET",
      "account": "your-account",
      "certificate_profile": "your-profile",
      "endpoint": "https://eus.codesigning.azure.net/"
    }
  }
]

rem On the build agent
set SGCSIGN_SERVER=https://sign.example.com:8443
set SGCSIGN_APIKEY=%SIGNING_API_KEY%
sgcsign sign -f authenticode -p release -o MyApp-signed.exe MyApp.exe

2 分でわかる sgcSign

Delphi と .NET からのコード署名とドキュメント署名。Azure プロバイダーが組み込まれるのと同じキープロバイダーモデルを使います。

Delphi と .NET からコードとドキュメントに署名:PAdES、XAdES、CAdES、Authenticode。スマートカードと HSM に対応。

よくある質問

TsgcAzureTrustedSigningProvider を作成し、TenantId、ClientId、ClientSecret、AccountName、CertificateProfileName、Endpoint を設定して、Connect を呼び出します。それを TsgcAuthenticodeSigner の KeyProvider に割り当て、入力パスと出力パスを指定して SignFile を呼び出します。このページ冒頭のサンプルで完結しています。

はい。sgcSign Server に AzureTS プロバイダーを設定し、各ランナーに API キーを渡します。ランナーは sgcsign sign または REST API を呼び出し、サーバーが Azure Trusted Signing で署名し、Azure のクライアントシークレットはビルドエージェントには届きません。

はい、sgcSign Server を通じて可能です。.exe と .dll ファイルには Authenticode、.nupkg パッケージには POST /api/v1/sign/nuget、ClickOnce マニフェストと VSIX 拡張にも、Azure Trusted Signing を含む、設定したキープロバイダーで署名します。自分の .NET コードでは、esegece.sgcSign パッケージが同じ Azure プロバイダークラスを提供します。

いいえ。Azure Trusted Signing では、Microsoft が証明書を所有して署名鍵を用意し、秘密鍵はすべて Azure の中にあります。sgcSign は OAuth2 クライアント資格情報でそれを使って署名するため、ビルドマシンに証明書や鍵のファイルは置かれません。

Azure Trusted Signing アカウント、証明書プロファイル、Trusted Signing Certificate Profile Signer ロールを持つ Azure AD アプリケーションです。これらから、テナント ID、クライアント ID、クライアントシークレット、アカウント名、プロファイル名を取得します。セットアップのセクションでは、各値を Delphi のプロパティとサーバーのパラメーターに対応づけています。

はい。Delphi では、Level を alT に設定し、TSAClient に TsgcTSAClient を割り当てます。sgcSign Server は既定の RFC 3161 タイムスタンプサーバーの一覧を保持し、応答があるまで順に試します。プロバイダーが専用のものを必要とする場合は、プロバイダーごとの tsa_urls リストを使えます。

最もお得な選択: All-AccesseSeGeCe の全製品にプレミアムサポートが付いて、年間 €1,059 からご利用いただけます。
All-Access の価格を見る

今日から Azure Trusted Signing で署名

Delphi アプリケーション、.NET プログラム、ビルドパイプラインから、秘密鍵を Azure に保管したまま署名できます。