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을 사용하는 방법

개인 키는 Azure에 두고, 자체 Delphi나 .NET 코드에서, 또는 sgcSign Server를 통해 모든 CI 파이프라인에서 Azure Trusted Signing으로 Windows 애플리케이션에 서명하세요.

키 공급자 하나로 세 곳에서 서명해요. Delphi 애플리케이션, .NET 코드, 또는 서명 서버를 통한 빌드 파이프라인이에요.

Azure Trusted Signing(이전 이름 Azure Code Signing)은 Microsoft의 코드 서명 서비스예요. Microsoft가 인증서를 소유하고 서명 키를 프로비저닝해 주며, 개인 키는 전적으로 Azure에 있어요. sgcSign은 OAuth2 클라이언트 자격 증명으로 인증하는 TsgcAzureTrustedSigningProvider를 통해 이 서비스와 통신해요.

모든 sgcSign 키 공급자는 IsgcKeyProvider를 구현하므로, 서명 코드는 키가 어디에 있는지 신경 쓰지 않아요. 로컬 PFX로 개발하고, Windows 인증서 저장소로 테스트하고, 공급자 하나만 바꿔서 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 포털에서 세 단계를 거친 다음 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 자격 증명을 모든 빌드 에이전트가 아니라 sgcSign Server 하나에 두세요. 러너는 API 키를 갖고 HTTPS로 서명해요.

공급자 항목 하나로 모든 러너 처리

  • 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

Azure 공급자가 연결되는 것과 같은 키 공급자 모델을 쓰는, Delphi와 .NET의 코드 및 문서 서명.

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-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

지금 Azure Trusted Signing으로 서명하세요

개인 키는 Azure에 둔 채로 Delphi 애플리케이션, .NET 프로그램, 빌드 파이프라인에서 서명할 수 있어요.