Delphi, C++ Builder ve .NET Kitaplık ve imzalama sunucusu

Delphi, .NET ve CI/CD'den Azure Trusted Signing

Windows uygulamalarını Delphi ya da .NET'ten Azure Trusted Signing ile imzalayın.

EXE ve DLL dosyalarını Authenticode ile imzalayın
Özel anahtar Azure'da kalır
Yerel PFX yok, USB belirteci yok
Derleme aracıları Azure gizli bilgileri olmadan imzalar
TsgcAzureTrustedSigningProviderOAuth2 istemci kimlik bilgileriMicrosoft tarafından verilen genel güven sertifikasıUzak imzalama sunucusu

Bir CI işlem hattından imzalayın → · Fiyatlandırmaya bakın →

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'i Nasıl Kullanır

Windows uygulamalarını kendi Delphi ya da .NET kodunuzdan veya sgcSign Server aracılığıyla herhangi bir CI işlem hattından Azure Trusted Signing ile imzalayın, özel anahtar Azure'da kalır.

Bir anahtar sağlayıcı, imzalanacak üç yer: Delphi uygulamanız, .NET kodunuz ya da imzalama sunucusu aracılığıyla derleme işlem hattı.

Azure Trusted Signing (eski adıyla Azure Code Signing) Microsoft'un kod imzalama hizmetidir. Sertifika Microsoft'a aittir, imzalama anahtarını sizin için Microsoft hazırlar ve özel anahtar tamamen Azure'da bulunur. sgcSign onunla, OAuth2 istemci kimlik bilgileriyle kimlik doğrulayan TsgcAzureTrustedSigningProvider aracılığıyla konuşur.

Her sgcSign anahtar sağlayıcısı IsgcKeyProvider arayüzünü uygular, bu nedenle imzalama kodu anahtarın nerede durduğuyla ilgilenmez. Yerel bir PFX ile geliştirin, Windows sertifika deposuyla test edin ve bir sağlayıcıyı değiştirerek Azure Trusted Signing ile yayınlayın. Diğer seçenekler anahtar sağlayıcıları sayfasında listelenir.

Delphi ve C++ Builder'dan

TsgcAuthenticodeSigner Azure sağlayıcısını KeyProvider olarak alır ve .exe, .dll, .sys, .ocx, .cpl ve .scr dosyalarını Windows'ta, harici imzalama aracı olmadan, işlem içinde imzalar.

.NET'ten

esegece.sgcSign NuGet paketi, aynı özelliklerle aynı TsgcAzureTrustedSigningProvider sınıfına sahiptir ve C#'ta bir imzalayıcının KeyProvider özelliğine atanır.

CI/CD'den

sgcSign Server Azure kimlik bilgilerini bir AzureTS sağlayıcısı olarak tutar. Derleme aracıları bir API anahtarıyla HTTPS üzerinden imzalar ve kiracıyı, istemciyi ya da gizli anahtarı asla görmez.

Neleri Yapılandırırsınız

Azure portalında üç adım, ardından sgcSign'da sağlayıcı değerleri. Aynı değerler Delphi ve .NET sağlayıcısını ve sunucu yapılandırmasını besler.

Azure hesabından ilk imzaya

  1. Azure portalında bir Azure Trusted Signing hesabı oluşturun.
  2. Bir sertifika profili oluşturun ve profil adını not edin.
  3. Bir Azure AD uygulaması kaydedin ve ona Trusted Signing Certificate Profile Signer rolünü verin.
  4. Sağlayıcıyı kiracı kimliği, istemci kimliği, istemci gizli anahtarı, hesap adı ve sertifika profili adıyla yapılandırın. Endpoint hesabınızın imzalama uç noktası URL'sini ayarlar.

İmzalamadan önce sağlayıcıda Connect çağırın. Sunucuda istemci gizli anahtarı bir ortam değişkeninden gelebilir, böylece yapılandırma dosyasına hiç yazılmaz.

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'de Authenticode Seçenekleri

Yukarıdaki üst bölümdeki kod işin tamamıdır. TsgcAuthenticodeSigner bileşeninin bu özellikleri ürettiği imzayı şekillendirir.

Zaman damgalı imzalar

Level varsayılan olarak alT değerindedir ve TSAClient özelliğine atanan bir TsgcTSAClient aracılığıyla bir RFC 3161 zaman damgası ekler. alBES zaman damgasız imzalar.

Karma ve yayıncı ayrıntıları

Hash varsayılan olarak ahSHA256 değerindedir. Description ve URL program adını ve bir daha fazla bilgi bağlantısını imzaya gömer.

Çift imzalar

Zaten imzalı bir dosyaya iç içe bir imza eklemek için AppendSignature değerini True yapın, örneğin eski Windows için SHA-1 ve güncel Windows için SHA-256.

Dosyalar, akışlar ve bellek

SignFile dosyaları okur ve yazar, SignStream akışlarda çalışır ve SignBytes bellekte tutulan bir ikili dosyayı imzalar.

C#'ta Aynı Sağlayıcı

.NET kitaplığı Delphi adlarını korur, böylece her iki dilden imzalayan bir ekip Azure Trusted Signing'i bir kez yapılandırır.

Kurun, yapılandırın, atayın

  • Registered paketi dotnet add package esegece.sgcSign ile ekleyin.
  • TsgcAzureTrustedSigningProvider üzerinde kiracıyı, istemciyi, gizli anahtarı, hesabı ve sertifika profilini ayarlayın.
  • Delphi'deki gibi, imzalayıcının KeyProvider özelliğine atayın.
  • NuGet paketleri, ClickOnce bildirimleri ve VSIX uzantıları sgcSign Server tarafından aynı Azure sağlayıcısıyla imzalanır.
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 ile Bir CI İşlem Hattından İmzalayın

Azure kimlik bilgilerini her derleme aracısı yerine tek bir sgcSign Server üzerine koyun. Çalıştırıcılar bir API anahtarı tutar ve HTTPS üzerinden imzalar.

Bir sağlayıcı girdisi, her çalıştırıcı

  • sgcSignServer.conf.json dosyasına bir AzureTS sağlayıcısı ekleyin. _env ile biten her parametre bir ortam değişkeninden okunur, böylece istemci gizli anahtarı dosyanın dışında kalır.
  • sgcSignServer --selftest-providers yapılandırmayı yükler, her sağlayıcıyı başlatır ve çıkar, böylece canlıya geçmeden önce Azure değerlerini denetleyebilirsiniz.
  • sgcsign istemcisi yürütülebilir dosyanın karmasını çalıştırıcıda hesaplar ve yalnızca karmayı gönderir. Sunucu onu Azure Trusted Signing ile imzalar ve istemci imzayı gömer.
  • Proje başına API anahtarları, isteğe bağlı onaylar ve karma zincirli bir denetim günlüğü, Azure profiliyle kimin neyi imzaladığını kaydeder.
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

sgcSign'ı İki Dakikada Görün

Delphi ve .NET'ten kod ve belge imzalama, Azure sağlayıcısının da takıldığı aynı anahtar sağlayıcı modeliyle.

Delphi ve .NET'ten kod ve belge imzalayın: akıllı kartlar ve HSM'lerle PAdES, XAdES, CAdES ve Authenticode.

Sıkça Sorulan Sorular

Bir TsgcAzureTrustedSigningProvider oluşturun, TenantId, ClientId, ClientSecret, AccountName, CertificateProfileName ve Endpoint değerlerini ayarlayın ve Connect çağırın. Onu bir TsgcAuthenticodeSigner bileşeninin KeyProvider özelliğine atayın ve giriş ve çıkış yollarıyla SignFile çağırın. Bu sayfanın üstündeki örnek eksiksizdir.

Evet. sgcSign Server üzerinde bir AzureTS sağlayıcısı yapılandırın ve her çalıştırıcıya bir API anahtarı verin. Çalıştırıcı sgcsign sign komutunu ya da REST API'sini çağırır, sunucu Azure Trusted Signing ile imzalar ve Azure istemci gizli anahtarı derleme aracısına hiç ulaşmaz.

Evet, sgcSign Server aracılığıyla. .exe ve .dll dosyalarını Authenticode ile, .nupkg paketlerini POST /api/v1/sign/nuget adresinde, ClickOnce bildirimlerini ve VSIX uzantılarını, yapılandırdığınız anahtar sağlayıcıyla, Azure Trusted Signing dahil, imzalar. Kendi .NET kodunuzda esegece.sgcSign paketi aynı Azure sağlayıcı sınıfını sunar.

Hayır. Azure Trusted Signing ile sertifika Microsoft'a aittir ve imzalama anahtarını Microsoft hazırlar, özel anahtar tamamen Azure'da bulunur. sgcSign onunla OAuth2 istemci kimlik bilgileri üzerinden imzalar, böylece derleme makinesinde hiçbir sertifika ya da anahtar dosyası bulunmaz.

Bir Azure Trusted Signing hesabı, bir sertifika profili ve Trusted Signing Certificate Profile Signer rolüne sahip bir Azure AD uygulaması. Bunlardan kiracı kimliğini, istemci kimliğini, bir istemci gizli anahtarını, hesap adını ve profil adını alırsınız. Kurulum bölümü her değeri Delphi özelliğine ve sunucu parametresine eşler.

Evet. Delphi'de Level değerini alT yapın ve TSAClient özelliğine bir TsgcTSAClient atayın. sgcSign Server varsayılan RFC 3161 zaman damgası sunucularının bir listesini tutar ve biri yanıt verene kadar sırayla dener; bir sağlayıcının kendine ait olması gerektiğinde sağlayıcı başına tsa_urls listeleri kullanılır.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

Bugün Azure Trusted Signing ile İmzalayın

Bir Delphi uygulamasından, bir .NET programından ya da bir derleme işlem hattından, özel anahtar Azure'da kalarak.