Delphi, C++ Builder en .NET Bibliotheek en ondertekeningsserver

Azure Trusted Signing vanuit Delphi, .NET en CI/CD

Onderteken Windows-toepassingen met Azure Trusted Signing vanuit Delphi of .NET.

EXE- en DLL-bestanden ondertekenen met Authenticode
Privésleutel blijft in Azure
Geen lokale PFX, geen USB-token
Buildagents ondertekenen zonder Azure-geheimen
TsgcAzureTrustedSigningProviderOAuth2-clientreferentiesDoor Microsoft uitgegeven certificaat met publiek vertrouwenExterne ondertekeningsserver

Ondertekenen vanuit een CI-pipeline → · Bekijk de prijzen →

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;

Hoe sgcSign Azure Trusted Signing gebruikt

Onderteken Windows-toepassingen met Azure Trusted Signing vanuit je eigen Delphi- of .NET-code, of vanuit elke CI-pipeline via de sgcSign Server, terwijl de privésleutel in Azure blijft.

Eén sleutelprovider, drie plekken om vanuit te ondertekenen: je Delphi-toepassing, je .NET-code, of de buildpipeline via de ondertekeningsserver.

Azure Trusted Signing (voorheen Azure Code Signing) is de codeondertekeningsservice van Microsoft. Microsoft bezit het certificaat en richt de ondertekeningssleutel voor je in, en de privésleutel staat volledig in Azure. sgcSign praat ermee via TsgcAzureTrustedSigningProvider, dat authenticeert met OAuth2-clientreferenties.

Elke sgcSign-sleutelprovider implementeert IsgcKeyProvider, dus de ondertekeningscode maakt niet uit waar de sleutel staat. Ontwikkel met een lokale PFX, test met het Windows-certificaatarchief en release met Azure Trusted Signing door één provider te verwisselen. De andere opties staan op de pagina sleutelproviders.

Vanuit Delphi en C++ Builder

TsgcAuthenticodeSigner neemt de Azure-provider als zijn KeyProvider en ondertekent bestanden van het type .exe, .dll, .sys, .ocx, .cpl en .scr in het proces, op Windows, zonder extern ondertekeningsprogramma.

Vanuit .NET

Het NuGet-package esegece.sgcSign heeft dezelfde klasse TsgcAzureTrustedSigningProvider met dezelfde eigenschappen, in C# toegewezen aan de KeyProvider van een signer.

Vanuit CI/CD

De sgcSign Server bewaart de Azure-referenties als een AzureTS-provider. Buildagents ondertekenen via HTTPS met een API-sleutel en zien de tenant, client of het geheim nooit.

Wat je configureert

Drie stappen in de Azure-portal, daarna de providerwaarden in sgcSign. Dezelfde waarden voeden de Delphi- en .NET-provider en de serverconfiguratie.

Van Azure-account tot eerste handtekening

  1. Maak een Azure Trusted Signing-account aan in de Azure-portal.
  2. Maak een certificaatprofiel aan en noteer de profielnaam.
  3. Registreer een Azure AD-toepassing en geef haar de rol Trusted Signing Certificate Profile Signer.
  4. Configureer de provider met de tenant-id, client-id, het clientgeheim, de accountnaam en de naam van het certificaatprofiel. Endpoint stelt de URL van het ondertekeningseindpunt van je account in.

Roep Connect aan op de provider voordat je ondertekent. In de server kan het clientgeheim uit een omgevingsvariabele komen, zodat het nooit in het configuratiebestand wordt geschreven.

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

Authenticode-opties in Delphi

De code in de hero hierboven is het hele werk. Deze eigenschappen van TsgcAuthenticodeSigner bepalen de handtekening die hij maakt.

Handtekeningen met tijdstempel

Level is standaard alT, wat een RFC 3161-tijdstempel toevoegt via een TsgcTSAClient die aan TSAClient is toegewezen. alBES ondertekent zonder.

Hash en uitgevergegevens

Hash is standaard ahSHA256. Description en URL sluiten de programmanaam en een koppeling voor meer informatie in de handtekening in.

Dubbele handtekeningen

Stel AppendSignature in op True om een geneste handtekening toe te voegen aan een bestand dat al is ondertekend, bijvoorbeeld SHA-1 voor oude Windows-versies en SHA-256 voor huidige.

Bestanden, streams en geheugen

SignFile leest en schrijft bestanden, SignStream werkt op streams en SignBytes ondertekent een binary in het geheugen.

Dezelfde provider in C#

De .NET-bibliotheek behoudt de Delphi-namen, dus een team dat vanuit beide talen ondertekent, configureert Azure Trusted Signing maar één keer.

Installeren, configureren, toewijzen

  • Voeg het Registered-package toe met dotnet add package esegece.sgcSign.
  • Stel de tenant, client, het geheim, het account en het certificaatprofiel in op TsgcAzureTrustedSigningProvider.
  • Wijs hem toe aan de KeyProvider van de signer, precies zoals in Delphi.
  • NuGet-packages, ClickOnce-manifesten en VSIX-extensies worden ondertekend door de sgcSign Server met dezelfde Azure-provider.
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;

Ondertekenen vanuit een CI-pipeline met Azure Trusted Signing

Zet de Azure-referenties op één sgcSign Server in plaats van op elke buildagent. Runners hebben een API-sleutel en ondertekenen via HTTPS.

Eén provider-item, elke runner

  • Voeg een AzureTS-provider toe aan sgcSignServer.conf.json. Elke parameter die op _env eindigt wordt uit een omgevingsvariabele gelezen, zodat het clientgeheim buiten het bestand blijft.
  • sgcSignServer --selftest-providers laadt de configuratie, initialiseert elke provider en sluit af, zodat je de Azure-waarden kunt controleren voordat je live gaat.
  • De client sgcsign hasht het uitvoerbare bestand op de runner en stuurt alleen de hash. De server ondertekent die met Azure Trusted Signing en de client sluit de handtekening in.
  • API-sleutels per project, optionele goedkeuringen en een auditlog met hashketen leggen vast wie wat met het Azure-profiel heeft ondertekend.
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

Zie sgcSign in twee minuten

Code en documenten ondertekenen vanuit Delphi en .NET, met hetzelfde sleutelprovidermodel waarin de Azure-provider past.

Onderteken code en documenten vanuit Delphi en .NET: PAdES, XAdES, CAdES en Authenticode, met smartcards en HSM's.

Veelgestelde vragen

Maak een TsgcAzureTrustedSigningProvider aan, stel TenantId, ClientId, ClientSecret, AccountName, CertificateProfileName en Endpoint in, en roep Connect aan. Wijs hem toe aan de KeyProvider van een TsgcAuthenticodeSigner en roep SignFile aan met de invoer- en uitvoerpaden. Het voorbeeld bovenaan deze pagina is compleet.

Ja. Configureer een AzureTS-provider op de sgcSign Server en geef elke runner een API-sleutel. De runner roept sgcsign sign of de REST-API aan, de server ondertekent met Azure Trusted Signing, en het Azure-clientgeheim bereikt de buildagent nooit.

Ja, via de sgcSign Server. Hij ondertekent .exe- en .dll-bestanden met Authenticode, .nupkg-packages op POST /api/v1/sign/nuget, ClickOnce-manifesten en VSIX-extensies, allemaal met de sleutelprovider die je configureert, Azure Trusted Signing inbegrepen. In je eigen .NET-code biedt het package esegece.sgcSign dezelfde Azure-providerklasse.

Nee. Met Azure Trusted Signing bezit Microsoft het certificaat en richt de ondertekeningssleutel in, en de privésleutel staat volledig in Azure. sgcSign ondertekent ermee via OAuth2-clientreferenties, dus er staat geen certificaat- of sleutelbestand op de buildmachine.

Een Azure Trusted Signing-account, een certificaatprofiel en een Azure AD-toepassing met de rol Trusted Signing Certificate Profile Signer. Hieruit haal je de tenant-id, de client-id, een clientgeheim, de accountnaam en de profielnaam. De sectie Instellen koppelt elke waarde aan de Delphi-eigenschap en de serverparameter.

Ja. Stel in Delphi Level in op alT en wijs een TsgcTSAClient toe aan TSAClient. De sgcSign Server houdt een lijst bij van standaard RFC 3161-tijdstempelservers en probeert ze in volgorde tot er een antwoordt, met tsa_urls-lijsten per provider wanneer een provider zijn eigen lijst nodig heeft.

De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Onderteken vandaag met Azure Trusted Signing

Vanuit een Delphi-toepassing, een .NET-programma of een buildpipeline, met de privésleutel bewaard in Azure.