Delphi, C++ Builder i .NET Biblioteka i serwer podpisywania

Azure Trusted Signing z Delphi, .NET i CI/CD

Podpisuj aplikacje Windows za pomocą Azure Trusted Signing z Delphi lub .NET.

Podpisuj pliki EXE i DLL przez Authenticode
Klucz prywatny zostaje w Azure
Bez lokalnego PFX, bez tokena USB
Agenci kompilacji podpisują bez sekretów Azure
TsgcAzureTrustedSigningProviderPoświadczenia klienta OAuth2Publicznie zaufany certyfikat wydany przez MicrosoftZdalny serwer podpisywania

Podpisuj z potoku CI → · Zobacz cennik →

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;

Jak sgcSign używa Azure Trusted Signing

Podpisuj aplikacje Windows za pomocą Azure Trusted Signing z własnego kodu Delphi lub .NET albo z dowolnego potoku CI przez sgcSign Server, podczas gdy klucz prywatny zostaje w Azure.

Jeden dostawca kluczy, trzy miejsca podpisywania: Twoja aplikacja Delphi, Twój kod .NET lub potok kompilacji przez serwer podpisywania.

Azure Trusted Signing (dawniej Azure Code Signing) to usługa podpisywania kodu firmy Microsoft. Microsoft jest właścicielem certyfikatu i udostępnia dla Ciebie klucz podpisywania, a klucz prywatny w całości znajduje się w Azure. sgcSign komunikuje się z nią przez TsgcAzureTrustedSigningProvider, który uwierzytelnia się poświadczeniami klienta OAuth2.

Każdy dostawca kluczy sgcSign implementuje IsgcKeyProvider, więc kod podpisywania nie dba o to, gdzie znajduje się klucz. Twórz z lokalnym PFX, testuj z magazynem certyfikatów Windows i wydawaj z Azure Trusted Signing, zamieniając jednego dostawcę. Pozostałe opcje są wymienione na stronie dostawców kluczy.

Z Delphi i C++ Builder

TsgcAuthenticodeSigner przyjmuje dostawcę Azure jako swój KeyProvider i podpisuje pliki .exe, .dll, .sys, .ocx, .cpl i .scr w procesie, w systemie Windows, bez zewnętrznego narzędzia do podpisywania.

Z .NET

Pakiet NuGet esegece.sgcSign ma tę samą klasę TsgcAzureTrustedSigningProvider z tymi samymi właściwościami, przypisywaną w C# do KeyProvider podpisującego.

Z CI/CD

sgcSign Server przechowuje poświadczenia Azure jako dostawcę AzureTS. Agenci kompilacji podpisują przez HTTPS za pomocą klucza API i nigdy nie widzą tenanta, klienta ani sekretu.

Co konfigurujesz

Trzy kroki w portalu Azure, a potem wartości dostawcy w sgcSign. Te same wartości zasilają dostawcę Delphi i .NET oraz konfigurację serwera.

Od konta Azure do pierwszego podpisu

  1. Utwórz konto Azure Trusted Signing w portalu Azure.
  2. Utwórz profil certyfikatu i zanotuj nazwę profilu.
  3. Zarejestruj aplikację Azure AD i przyznaj jej rolę Trusted Signing Certificate Profile Signer.
  4. Skonfiguruj dostawcę z identyfikatorem tenanta, identyfikatorem klienta, sekretem klienta, nazwą konta i nazwą profilu certyfikatu. Endpoint ustawia adres URL punktu końcowego podpisywania Twojego konta.

Wywołaj Connect na dostawcy przed podpisywaniem. W serwerze sekret klienta może pochodzić ze zmiennej środowiskowej, więc nigdy nie jest zapisywany w pliku konfiguracyjnym.

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

Opcje Authenticode w Delphi

Kod w sekcji głównej powyżej to cała praca. Te właściwości TsgcAuthenticodeSigner kształtują tworzony podpis.

Podpisy ze znacznikiem czasu

Level domyślnie ma wartość alT, co dodaje znacznik czasu RFC 3161 przez TsgcTSAClient przypisany do TSAClient. alBES podpisuje bez niego.

Skrót i dane wydawcy

Hash domyślnie ma wartość ahSHA256. Description i URL osadzają w podpisie nazwę programu i łącze do dodatkowych informacji.

Podpisy podwójne

Ustaw AppendSignature na True, aby dodać zagnieżdżony podpis do pliku, który jest już podpisany, na przykład SHA-1 dla starego Windows i SHA-256 dla obecnego Windows.

Pliki, strumienie i pamięć

SignFile czyta i zapisuje pliki, SignStream działa na strumieniach, a SignBytes podpisuje plik binarny przechowywany w pamięci.

Ten sam dostawca w C#

Biblioteka .NET zachowuje nazwy z Delphi, więc zespół podpisujący z obu języków konfiguruje Azure Trusted Signing raz.

Zainstaluj, skonfiguruj, przypisz

  • Dodaj pakiet Registered przez dotnet add package esegece.sgcSign.
  • Ustaw tenanta, klienta, sekret, konto i profil certyfikatu w TsgcAzureTrustedSigningProvider.
  • Przypisz go do KeyProvider podpisującego, dokładnie tak jak w Delphi.
  • Pakiety NuGet, manifesty ClickOnce i rozszerzenia VSIX są podpisywane przez sgcSign Server z tym samym dostawcą Azure.
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;

Podpisuj z potoku CI za pomocą Azure Trusted Signing

Umieść poświadczenia Azure na jednej instancji sgcSign Server zamiast na każdym agencie kompilacji. Runnery mają klucz API i podpisują przez HTTPS.

Jeden wpis dostawcy, każdy runner

  • Dodaj dostawcę AzureTS do sgcSignServer.conf.json. Każdy parametr kończący się na _env jest odczytywany ze zmiennej środowiskowej, więc sekret klienta nie trafia do pliku.
  • sgcSignServer --selftest-providers wczytuje konfigurację, inicjalizuje każdego dostawcę i kończy działanie, więc możesz sprawdzić wartości Azure przed uruchomieniem produkcyjnym.
  • Klient sgcsign haszuje plik wykonywalny na runnerze i wysyła tylko skrót. Serwer podpisuje go przez Azure Trusted Signing, a klient osadza podpis.
  • Klucze API dla każdego projektu, opcjonalne zatwierdzenia i dziennik audytu z łańcuchem skrótów rejestrują, kto co podpisał profilem 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

Zobacz sgcSign w dwie minuty

Podpisywanie kodu i dokumentów z Delphi i .NET, z tym samym modelem dostawcy kluczy, do którego podłącza się dostawca Azure.

Podpisuj kod i dokumenty z Delphi i .NET: PAdES, XAdES, CAdES i Authenticode, z kartami inteligentnymi i HSM.

Najczęściej zadawane pytania

Utwórz TsgcAzureTrustedSigningProvider, ustaw TenantId, ClientId, ClientSecret, AccountName, CertificateProfileName i Endpoint i wywołaj Connect. Przypisz go do KeyProvider obiektu TsgcAuthenticodeSigner i wywołaj SignFile ze ścieżkami wejściową i wyjściową. Przykład na górze tej strony jest kompletny.

Tak. Skonfiguruj dostawcę AzureTS na sgcSign Server i daj każdemu runnerowi klucz API. Runner wywołuje sgcsign sign lub REST API, serwer podpisuje przez Azure Trusted Signing, a sekret klienta Azure nigdy nie trafia do agenta kompilacji.

Tak, przez sgcSign Server. Podpisuje pliki .exe i .dll przez Authenticode, pakiety .nupkg przez POST /api/v1/sign/nuget, manifesty ClickOnce i rozszerzenia VSIX, wszystko z dostawcą kluczy, którego skonfigurujesz, w tym Azure Trusted Signing. We własnym kodzie .NET pakiet esegece.sgcSign oferuje tę samą klasę dostawcy Azure.

Nie. Z Azure Trusted Signing Microsoft jest właścicielem certyfikatu i udostępnia klucz podpisywania, a klucz prywatny w całości znajduje się w Azure. sgcSign podpisuje nim przez poświadczenia klienta OAuth2, więc na maszynie kompilacji nie ma pliku certyfikatu ani klucza.

Konta Azure Trusted Signing, profilu certyfikatu i aplikacji Azure AD z rolą Trusted Signing Certificate Profile Signer. Z nich bierzesz identyfikator tenanta, identyfikator klienta, sekret klienta, nazwę konta i nazwę profilu. Sekcja konfiguracji mapuje każdą wartość na właściwość Delphi i parametr serwera.

Tak. W Delphi ustaw Level na alT i przypisz TsgcTSAClient do TSAClient. sgcSign Server utrzymuje listę domyślnych serwerów znaczników czasu RFC 3161 i próbuje ich po kolei, aż któryś odpowie, z listami tsa_urls dla każdego dostawcy, gdy dostawca potrzebuje własnych.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Podpisuj z Azure Trusted Signing już dziś

Z aplikacji Delphi, programu .NET lub potoku kompilacji, z kluczem prywatnym zachowanym w Azure.