Excel Digital Signature

With the following example you will learn how to create a digitally signed Excel file in C# and VB.NET with the GemBox.Spreadsheet component.

Upload your file (Drag file here)
View on GitHub 
using GemBox.Spreadsheet;

class Program
{
    static void Main()
    {
        // If using the Professional version, put your serial key below.
        SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY");

        var workbook = ExcelFile.Load("%InputFileName%");

        var saveOptions = new XlsxSaveOptions();
        saveOptions.DigitalSignatures.Add(new XlsxDigitalSignatureSaveOptions()
        {
            CertificatePath = "%InputDigitalId%",
            CertificatePassword = "GemBoxPassword"
        });

        workbook.Save("XLSX Digital Signature.xlsx", saveOptions);
    }
}
Imports GemBox.Spreadsheet

Module Program

    Sub Main()

        ' If using the Professional version, put your serial key below.
        SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY")

        Dim workbook = ExcelFile.Load("%InputFileName%")

        Dim saveOptions As New XlsxSaveOptions()
        saveOptions.DigitalSignatures.Add(New XlsxDigitalSignatureSaveOptions() With
        {
            .CertificatePath = "%InputDigitalId%",
            .CertificatePassword = "GemBoxPassword"
        })

        workbook.Save("XLSX Digital Signature.xlsx", saveOptions)
    End Sub
End Module
XLSX file digitally signed with GemBox.Spreadsheet
Screenshot of an Excel XLSX file digitally signed with GemBox.Spreadsheet

To get a valid signature in MS Excel, as seen in the screenshot above, you will have to install GemBoxCA.crt certificate as a trusted root certification authority and install either GemBoxRSA.crt or GemBoxECDsa.crt certificate as an Intermediate Certification Authority, as described in the Digital ID notes.

To avoid installing the whole certificate chain, you can embed certificates in the signature. With this approach only the root certificate (GemBoxCA.crt) needs to be installed.

The following example shows how to add multiple signatures, set additional signature properties, and embed an intermediate certificate.

Upload your file (Drag file here)
View on GitHub 
using GemBox.Spreadsheet;
using GemBox.Spreadsheet.Security;

class Program
{
    static void Main()
    {
        // If using the Professional version, put your serial key below.
        SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY");

        var workbook = ExcelFile.Load("%InputFileName%");

        var signature1 = new XlsxDigitalSignatureSaveOptions()
        {
            CertificatePath = "%#GemBoxECDsa521.pfx%",
            CertificatePassword = "GemBoxPassword",
            CommitmentType = DigitalSignatureCommitmentType.Created,
            SignerRole = "Developer"
        };
        // Embed intermediate certificate.
        signature1.Certificates.Add(new Certificate("%#GemBoxECDsa.crt%"));

        var signature2 = new XlsxDigitalSignatureSaveOptions()
        {
            CertificatePath = "%#GemBoxRSA4096.pfx%",
            CertificatePassword = "GemBoxPassword",
            CommitmentType = DigitalSignatureCommitmentType.Approved,
            SignerRole = "Manager"
        };
        // Embed intermediate certificate.
        signature2.Certificates.Add(new Certificate("%#GemBoxRSA.crt%"));

        var saveOptions = new XlsxSaveOptions();
        saveOptions.DigitalSignatures.Add(signature1);
        saveOptions.DigitalSignatures.Add(signature2);

        workbook.Save("XLSX Digital Signatures.xlsx", saveOptions);
    }
}
Imports GemBox.Spreadsheet
Imports GemBox.Spreadsheet.Security

Module Program

    Sub Main()

        ' If using the Professional version, put your serial key below.
        SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY")

        Dim workbook = ExcelFile.Load("%InputFileName%")

        Dim signature1 As New XlsxDigitalSignatureSaveOptions() With
        {
            .CertificatePath = "%#GemBoxECDsa521.pfx%",
            .CertificatePassword = "GemBoxPassword",
            .CommitmentType = DigitalSignatureCommitmentType.Created,
            .SignerRole = "Developer"
        }
        ' Embed intermediate certificate.
        signature1.Certificates.Add(New Certificate("%#GemBoxECDsa.crt%"))

        Dim signature2 As New XlsxDigitalSignatureSaveOptions() With
        {
            .CertificatePath = "%#GemBoxRSA4096.pfx%",
            .CertificatePassword = "GemBoxPassword",
            .CommitmentType = DigitalSignatureCommitmentType.Approved,
            .SignerRole = "Manager"
        }
        ' Embed intermediate certificate.
        signature2.Certificates.Add(New Certificate("%#GemBoxRSA.crt%"))

        Dim saveOptions As New XlsxSaveOptions()
        saveOptions.DigitalSignatures.Add(signature1)
        saveOptions.DigitalSignatures.Add(signature2)

        workbook.Save("XLSX Digital Signatures.xlsx", saveOptions)
    End Sub
End Module

Digital ID notes

Digital ID files used in the preceding example are part of a simple Public Key Infrastructure (PKI) created just for this demonstration which contains the following hierarchy of certificates and CRLs:

To get a valid signature in an MS Office Application, as seen in the screenshot above, you will have to add GemBoxCA.crt certificate to the list of Trusted Certificates on your machine using the following steps:

  1. Download GemBoxCA.crt certificate.
  2. Open the file and click Install Certificate....
  3. If you are adding a Root Certificate, choose the option "Place all certificates in the following store" and Browse for "Trusted Root Certification Authorities".
  4. After the installation is finished, you can see the certificate under "User Accounts" > "Manage User Certificates" in the Control Panel.
  5. Once you finish the verification, it is safer to uninstall the certificate.

See also

Excel Encryption from C# and VB.NET applications

Excel Encryption from C# and VB.NET applications

PDF Encryption in Excel Files using C# and VB.NET

PDF Encryption in Excel Files using C# and VB.NET

Next steps

GemBox.Spreadsheet is a .NET component that enables you to read, write, edit, convert, and print spreadsheet files from your .NET applications using one simple API.

Download Buy