Delphi, C++ Builder e .NET Biblioteca e servidor de assinatura

Azure Trusted Signing com Delphi, .NET e CI/CD

Assine aplicativos Windows com o Azure Trusted Signing a partir do Delphi ou do .NET.

Assine arquivos EXE e DLL com Authenticode
A chave privada fica no Azure
Sem PFX local, sem token USB
Os agentes de build assinam sem segredos do Azure
TsgcAzureTrustedSigningProviderCredenciais de cliente OAuth2Certificado de confiança pública emitido pela MicrosoftServidor de assinatura remota

Assine a partir de um pipeline de CI → · Ver preços →

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;

Como o sgcSign usa o Azure Trusted Signing

Assine aplicativos Windows com o Azure Trusted Signing a partir do seu próprio código Delphi ou .NET, ou de qualquer pipeline de CI por meio do sgcSign Server, enquanto a chave privada permanece no Azure.

Um provedor de chaves, três lugares de onde assinar: o seu aplicativo Delphi, o seu código .NET ou o pipeline de build por meio do servidor de assinatura.

O Azure Trusted Signing (antes Azure Code Signing) é o serviço de assinatura de código da Microsoft. A Microsoft é dona do certificado e provisiona a chave de assinatura para você, e a chave privada fica inteiramente no Azure. O sgcSign se comunica com ele por meio de TsgcAzureTrustedSigningProvider, que se autentica com credenciais de cliente OAuth2.

Todo provedor de chaves do sgcSign implementa IsgcKeyProvider, então o código de assinatura não se importa com onde a chave está. Desenvolva com um PFX local, teste com o repositório de certificados do Windows e publique com o Azure Trusted Signing trocando um único provedor. As outras opções estão listadas na página de provedores de chaves.

A partir do Delphi e do C++ Builder

TsgcAuthenticodeSigner recebe o provedor Azure como seu KeyProvider e assina arquivos .exe, .dll, .sys, .ocx, .cpl e .scr no próprio processo, no Windows, sem nenhuma ferramenta de assinatura externa.

A partir do .NET

O pacote NuGet esegece.sgcSign tem a mesma classe TsgcAzureTrustedSigningProvider com as mesmas propriedades, atribuída ao KeyProvider de um signer em C#.

A partir do CI/CD

O sgcSign Server guarda as credenciais do Azure como um provedor AzureTS. Os agentes de build assinam por HTTPS com uma chave de API e nunca veem o tenant, o cliente nem o segredo.

O que você configura

Três passos no portal do Azure e depois os valores do provedor no sgcSign. Os mesmos valores alimentam o provedor Delphi e .NET e a configuração do servidor.

Da conta Azure à primeira assinatura

  1. Crie uma conta do Azure Trusted Signing no portal do Azure.
  2. Crie um perfil de certificado e anote o nome do perfil.
  3. Registre um aplicativo do Azure AD e conceda a ele a função Trusted Signing Certificate Profile Signer.
  4. Configure o provedor com o ID do tenant, o ID do cliente, o segredo do cliente, o nome da conta e o nome do perfil de certificado. Endpoint define a URL do endpoint de assinatura da sua conta.

Chame Connect no provedor antes de assinar. No servidor, o segredo do cliente pode vir de uma variável de ambiente, de modo que nunca seja gravado no arquivo de configuração.

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

Opções de Authenticode no Delphi

O código no topo acima é o trabalho todo. Estas propriedades de TsgcAuthenticodeSigner moldam a assinatura que ele produz.

Assinaturas com carimbo de data e hora

Level é alT por padrão, o que adiciona um carimbo de data e hora RFC 3161 por meio de um TsgcTSAClient atribuído a TSAClient. alBES assina sem um.

Hash e detalhes do publicador

Hash é ahSHA256 por padrão. Description e URL incorporam o nome do programa e um link de mais informações na assinatura.

Assinaturas duplas

Defina AppendSignature como True para adicionar uma assinatura aninhada a um arquivo que já está assinado, por exemplo SHA-1 para o Windows antigo e SHA-256 para o Windows atual.

Arquivos, streams e memória

SignFile lê e grava arquivos, SignStream trabalha com streams e SignBytes assina um binário mantido na memória.

O mesmo provedor em C#

A biblioteca .NET mantém os nomes do Delphi, então uma equipe que assina nas duas linguagens configura o Azure Trusted Signing uma única vez.

Instalar, configurar, atribuir

  • Adicione o pacote Registered com dotnet add package esegece.sgcSign.
  • Defina o tenant, o cliente, o segredo, a conta e o perfil de certificado em TsgcAzureTrustedSigningProvider.
  • Atribua-o ao KeyProvider do signer, exatamente como no Delphi.
  • Pacotes NuGet, manifestos ClickOnce e extensões VSIX são assinados pelo sgcSign Server com o mesmo provedor 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;

Assine a partir de um pipeline de CI com o Azure Trusted Signing

Coloque as credenciais do Azure em um único sgcSign Server em vez de em cada agente de build. Os runners guardam uma chave de API e assinam por HTTPS.

Uma entrada de provedor, todos os runners

  • Adicione um provedor AzureTS a sgcSignServer.conf.json. Qualquer parâmetro que termine em _env é lido de uma variável de ambiente, de modo que o segredo do cliente fique fora do arquivo.
  • sgcSignServer --selftest-providers carrega a configuração, inicializa cada provedor e encerra, para que você confira os valores do Azure antes de entrar em produção.
  • O cliente sgcsign calcula o hash do executável no runner e envia apenas o hash. O servidor o assina com o Azure Trusted Signing e o cliente incorpora a assinatura.
  • Chaves de API por projeto, aprovações opcionais e um log de auditoria encadeado por hash registram quem assinou o quê com o perfil do 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

Veja o sgcSign em dois minutos

Assinatura de código e de documentos a partir do Delphi e do .NET, com o mesmo modelo de provedor de chaves em que o provedor Azure se encaixa.

Assine código e documentos a partir do Delphi e do .NET: PAdES, XAdES, CAdES e Authenticode, com smart cards e HSMs.

Perguntas frequentes

Crie um TsgcAzureTrustedSigningProvider, defina TenantId, ClientId, ClientSecret, AccountName, CertificateProfileName e Endpoint, e chame Connect. Atribua-o ao KeyProvider de um TsgcAuthenticodeSigner e chame SignFile com os caminhos de entrada e de saída. O exemplo no topo desta página está completo.

Sim. Configure um provedor AzureTS no sgcSign Server e dê a cada runner uma chave de API. O runner chama sgcsign sign ou a API REST, o servidor assina com o Azure Trusted Signing, e o segredo do cliente do Azure nunca chega ao agente de build.

Sim, por meio do sgcSign Server. Ele assina arquivos .exe e .dll com Authenticode, pacotes .nupkg em POST /api/v1/sign/nuget, manifestos ClickOnce e extensões VSIX, tudo com o provedor de chaves que você configurar, inclusive o Azure Trusted Signing. No seu próprio código .NET, o pacote esegece.sgcSign oferece a mesma classe de provedor Azure.

Não. Com o Azure Trusted Signing, a Microsoft é dona do certificado e provisiona a chave de assinatura, e a chave privada fica inteiramente no Azure. O sgcSign assina com ela por meio de credenciais de cliente OAuth2, então nenhum arquivo de certificado ou de chave fica na máquina de build.

Uma conta do Azure Trusted Signing, um perfil de certificado e um aplicativo do Azure AD com a função Trusted Signing Certificate Profile Signer. Com isso você obtém o ID do tenant, o ID do cliente, um segredo do cliente, o nome da conta e o nome do perfil. A seção de configuração mapeia cada valor para a propriedade do Delphi e o parâmetro do servidor.

Sim. No Delphi, defina Level como alT e atribua um TsgcTSAClient a TSAClient. O sgcSign Server mantém uma lista de servidores de carimbo de data e hora RFC 3161 padrão e os tenta em ordem até que um responda, com listas tsa_urls por provedor quando um provedor precisa das suas próprias.

Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Assine hoje com o Azure Trusted Signing

A partir de um aplicativo Delphi, de um programa .NET ou de um pipeline de build, com a chave privada mantida no Azure.