IExternalSigner Interface

Exposes the basic functionality to generate signatures.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v20.2.Core.dll

NuGet Package: DevExpress.Pdf.Core

NuGet Packages: DevExpress.Pdf.Core, DevExpress.WindowsDesktop.Pdf.Core

Declaration

C#

public interface IExternalSigner

VB.NET

Public Interface IExternalSigner

Remarks

The Pkcs7Signer and PdfTimeStamp classes are default IExternalSigner implementations. Use these classes to generate signatures or create an implementation.

Pass the IExternalSigner implementation object to the PdfSignatureBuilder instance constructor to apply the signature to the signature field, as shown below:

C#

using (var signer = new PdfDocumentSigner("Document.pdf"))
{
    //Create a timestamp:
    ITsaClient tsaClient = new PdfTsaClient(new Uri(@"https://freetsa.org/tsr"), HashAlgorithmType.SHA256);

    //Create a PKCS#7 PAdES signature:
    Pkcs7Signer pkcs7Signature = new Pkcs7Signer("Signing Documents/certificate.pfx", "123", HashAlgorithmType.SHA256, tsaClient, null, null, PdfSignatureProfile.PAdES_BES);

    //Apply the signature to an existing form field:
    var santuzzaSignature = new PdfSignatureBuilder(pkcs7Signature, "Sign");

    //Specify an image and signer information:
    santuzzaSignature.SetImageData(System.IO.File.ReadAllBytes("Signing Documents/SantuzzaValentina.jpg"));
    santuzzaSignature.Location = "Australia";
    santuzzaSignature.Name = "Santuzza Valentina";
    santuzzaSignature.Reason = "I Agree";
    santuzzaSignature.CertificationLevel = PdfCertificationLevel.FillFormsAndAnnotate;

    //Create a new signature form field:
    var signatureFieldInfo1 = new PdfSignatureFieldInfo(1);
    signatureFieldInfo1.Name = "SignatureField1";
    signatureFieldInfo1.SignatureBounds = new PdfRectangle(200, 200, 250, 250);

    //Create a document-level timestamp:
    PdfTimeStamp pdfTimeStamp = new PdfTimeStamp(tsaClient);

    //Apply this timestamp to the form field:
    var timeStampSignature = new PdfSignatureBuilder(pdfTimeStamp, signatureFieldInfo1);

    //Add signatures to an array:
    PdfSignatureBuilder[] signatures = { santuzzaSignature, timeStampSignature };

    //Sign and save the document:
    signer.SaveDocument("SignedDocument.pdf", signatures);
}

VB.NET

Using signer = New PdfDocumentSigner("Document.pdf")
  'Create a timestamp:
  Dim tsaClient As ITsaClient = New PdfTsaClient(New Uri("https://freetsa.org/tsr"), HashAlgorithmType.SHA256)

  'Create a PKCS#7 PAdES signature:
  Dim pkcs7Signature As New Pkcs7Signer("Signing Documents/certificate.pfx", "123", HashAlgorithmType.SHA256, tsaClient, Nothing, Nothing, PdfSignatureProfile.PAdES_BES)

  'Apply the signature to an existing form field:
  Dim santuzzaSignature = New PdfSignatureBuilder(pkcs7Signature, "Sign")

  'Specify an image and signer information:
  santuzzaSignature.SetImageData(System.IO.File.ReadAllBytes("Signing Documents/SantuzzaValentina.jpg"))
  santuzzaSignature.Location = "Australia"
  santuzzaSignature.Name = "Santuzza Valentina"
  santuzzaSignature.Reason = "I Agree"
  santuzzaSignature.CertificationLevel = PdfCertificationLevel.FillFormsAndAnnotate

  'Create a new signature form field:
  Dim signatureFieldInfo1 = New PdfSignatureFieldInfo(1)
  signatureFieldInfo1.Name = "SignatureField1"
  signatureFieldInfo1.SignatureBounds = New PdfRectangle(200, 200, 250, 250)

  'Create a document-level timestamp:
  Dim pdfTimeStamp As New PdfTimeStamp(tsaClient)

  'Apply this timestamp to the form field:
  Dim timeStampSignature = New PdfSignatureBuilder(pdfTimeStamp, signatureFieldInfo1)

  'Add signatures to an array:
  Dim signatures() As PdfSignatureBuilder = { santuzzaSignature, timeStampSignature }

  'Sign and save the document:
  signer.SaveDocument("SignedDocument.pdf", signatures)
End Using