Sample code for 30+ languages & platforms
PureBasic Requires Chilkat v11.7.0+

Authenticode Sign a Windows Installer Package (MSI)

See more Code Signing Examples

Demonstrates how to Authenticode sign a Windows Installer package (.msi). Signing MSI packages requires Chilkat v11.7.0 or later. The package is signed in place, and the certificate must have an RSA key: Windows does not accept the signature of an MSI that was signed with an ECDSA certificate.

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkCodeSign.pb"
IncludeFile "CkCert.pb"
IncludeFile "CkJsonObject.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  This example requires the Chilkat API to have been previously unlocked.
    ;  See Global Unlock Sample for sample code.

    ;  Signing a Windows Installer package (.msi) requires Chilkat v11.7.0 or later.

    ;  Load the code signing certificate.  It must have access to its private key.
    cert.i = CkCert::ckCreate()
    If cert.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkCert::ckLoadPfxFile(cert,"C:/someDir/myCodeSigningCert.pfx","pfx password")
    If success = 0
        Debug CkCert::ckLastErrorText(cert)
        CkCert::ckDispose(cert)
        ProcedureReturn
    EndIf

    ;  Use a certificate with an RSA key to sign an MSI.
    ;  Windows does not accept the signature of an MSI that was signed with an ECDSA certificate
    ;  (signtool verify and the Digital Signatures tab of the file's properties report it as invalid).
    ;  This is a limitation of signed MSI files on Windows.  It does not apply to EXE, DLL, PowerShell,
    ;  or VBScript files, which can be signed with either kind of certificate.
    If CkCert::ckIsRsa(cert) = 0
        Debug "Use an RSA code signing certificate to sign an MSI."
        CkCert::ckDispose(cert)
        ProcedureReturn
    EndIf

    ;  Sign with SHA256, and ask a timestamp authority for a timestamp.  A timestamp lets the
    ;  signature continue to validate after the code signing certificate has expired.
    ;  
    ;  {
    ;    "hashAlg": "sha256",
    ;    "timestampToken": {
    ;      "enabled": true,
    ;      "tsaUrl": "http://timestamp.digicert.com",
    ;      "requestTsaCert": true,
    ;      "hashAlg": "sha256"
    ;    }
    ;  }
    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(json,"hashAlg","sha256")
    CkJsonObject::ckUpdateBool(json,"timestampToken.enabled",1)
    CkJsonObject::ckUpdateString(json,"timestampToken.tsaUrl","http://timestamp.digicert.com")
    CkJsonObject::ckUpdateBool(json,"timestampToken.requestTsaCert",1)
    CkJsonObject::ckUpdateString(json,"timestampToken.hashAlg","sha256")

    msiPath.s = "C:/someDir/MyAppSetup.msi"

    signer.i = CkCodeSign::ckCreate()
    If signer.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  The .msi is modified in place.  The signature is stored in the package's digital signature stream.
    ;  If the package is already signed, the new signature replaces the existing one.
    success = CkCodeSign::ckAddSignature(signer,msiPath,cert,json)
    If success = 0
        Debug CkCodeSign::ckLastErrorText(signer)
        CkCert::ckDispose(cert)
        CkJsonObject::ckDispose(json)
        CkCodeSign::ckDispose(signer)
        ProcedureReturn
    EndIf

    Debug "Signed the MSI."

    ;  Verify the signature that was just added.
    sigInfo.i = CkJsonObject::ckCreate()
    If sigInfo.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    valid.i = CkCodeSign::ckVerifySignature(signer,msiPath,sigInfo)
    If valid = 0
        Debug CkCodeSign::ckLastErrorText(signer)
        CkCert::ckDispose(cert)
        CkJsonObject::ckDispose(json)
        CkCodeSign::ckDispose(signer)
        CkJsonObject::ckDispose(sigInfo)
        ProcedureReturn
    EndIf

    Debug "The signature is valid."


    CkCert::ckDispose(cert)
    CkJsonObject::ckDispose(json)
    CkCodeSign::ckDispose(signer)
    CkJsonObject::ckDispose(sigInfo)


    ProcedureReturn
EndProcedure