GroupDocs.Signature for .NET 20.7 Release Notes

 /// <summary>
 /// Describes enumeration of PDF digital signature type.
 /// </summary>
 public enum PdfDigitalSignatureType
 {
  /// <summary>
  /// Digital signature.
  /// </summary>
  Signature = 0,

  /// <summary>
  /// Digital certificate. Each document could be certified only once.
  /// </summary>
  Certificate = 1
 }

/// <summary>
/// Represents data to get time stamp from third-party site.
/// </summary>
public struct TimeStamp
{
    /// <summary>
    /// Url of third-party site.
    /// </summary>
    public string Url { get; set; }

    /// <summary>
    /// User.
    /// </summary>
    public string User { get; set; }

    /// <summary>
    /// Password.
    /// </summary>
    public string Password { get; set; }

    /// <summary>
    /// Instantiates new time stamp structure.
    /// </summary>
    /// <param name="url">Url of third-party site.</param>
    /// <param name="user">User.</param>
    /// <param name="password">Password.</param>
    public TimeStamp(string url, string user, string password);
}

/// <summary>
/// Contains Pdf Digital signature properties.
/// </summary>
public class PdfDigitalSignature : DigitalSignature
{
    /// <summary>
    /// Type of Pdf digital signature.
    /// </summary>
    public PdfDigitalSignatureType Type { get; set; } = PdfDigitalSignatureType.Signature;

    /// <summary>
    /// Time stamp for Pdf digital signature.
    /// Default value is null.
    /// </summary>
    public TimeStamp TimeStamp { get; set; }

    /// <summary>
    /// Initialize Pdf Digital Signature with no certificate.
    /// </summary>
    public PdfDigitalSignature()

    /// <summary>
    /// Initialize Pdf Digital Signature based on specified X509 store. First certificate from specified store will be used.
    /// </summary>
    /// <param name="store">X509 store.</param>
    public PdfDigitalSignature(X509Store store);

    /// <summary>
    /// Create Pdf Digital signature based on specified X509 Store and index of certificate.
    /// </summary>
    /// <param name="store">X509 store.</param>
    /// <param name="index">Index of certificate.</param>
    public PdfDigitalSignature(X509Store store, int index);

    /// <summary>
    /// Create Pdf Digital signature with specified certificate.
    /// </summary>
    /// <param name="certificate">X509 certificate.</param>
    public PdfDigitalSignature(X509Certificate2 certificate);
}

//Certify pdf document with digital signature
using (Signature signature = new Signature("sample.pdf"))
{
    PdfDigitalSignature pdfDigitalSignature = new PdfDigitalSignature()
       { ContactInfo = "ContactInfo", Location = "Location", Reason = "Very important reason" };
    // Setting pdf digital signature type
    pdfDigitalSignature.Type = PdfDigitalSignatureType.Certificate;

    // Setting data for getting time stamp from third-party site for pdf digital signature
    pdfDigitalSignature.TimeStamp = new TimeStamp("https://freetsa.org/tsr", "", "");

    //Create digital signing options
    DigitalSignOptions options = new DigitalSignOptions(certificatePath)
    {
        // certificate password
        Password = "1234567890",
        // image as digital certificate appearance on document pages
        ImageFilePath = imagePath,
        // Setting document-specific options
        Signature = pdfDigitalSignature,
        Width = 160,
        Height = 80,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 10, Right = 10 },
        // setup signature border
        Border = new Border()
        {
            Visible = true,
            Color = Color.Red,
            DashStyle = DashStyle.DashDot,
            Weight = 2
        }
    };
    SignResult signResult = signature.Sign(outputFilePathCertified, options);
    Console.WriteLine($"\nSource document signed successfully with {signResult.Succeeded.Count} signature(s).\nFile saved at {outputFilePathSigned}.");
    Console.WriteLine("\nList of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

    /// <summary>
    /// Defines supported process with documents like Info, Preview, Sign, Verify, Search, Update, Delete
    /// </summary>
    public enum ProcessType
    {
        /// <summary>Indicates an error, unknown process type.</summary>
        Unknown,
        /// <summary>Obtain document information process.</summary>
        Info,
        /// <summary>Indicates method GeneratePreview().</summary>
        Preview,
        /// <summary>Signing process type.</summary>
        Sign,
        /// <summary>Document verification process.</summary>
        Verify,
        /// <summary>Signatures searching process.</summary>
        Search,
        /// <summary>Update document signatures process.</summary>
        Update,
        /// <summary>Delete document signatures process</summary>
        Delete
    }

    /// <summary>
    /// Represents document process details.
    /// </summary>
    public sealed class ProcessLog
    {
        /// <summary>
        /// Get the process date and time.
        /// </summary>
        public DateTime Date { get; }

        /// <summary>
        /// Get the process type.
        /// </summary>
        public ProcessType Type { get; }

        /// <summary>
        /// Get process description.
        /// </summary>
        public string Message { get; }

        /// <summary>
        /// Quantity of successfully processed signatures.
        /// </summary>
        public int Succeeded { get; }

        /// <summary>
        /// Quantity of signatures that failed process action.
        /// </summary>
        public int Failed { get; }
    }

    /// <summary>
    ///  Defines document description properties.
    /// </summary>
    public interface IDocumentInfo
	{
        /// <summary>
        /// Collection of document history process logs.
        /// </summary>
        IList<ProcessLog> ProcessLogs { get; }
	}

    public class DocumentInfo : IDocumentInfo
	{
        ...

        /// <summary>
        /// Collection of document history processes like Sign, Update, Delete.
        /// </summary>
        public IList<ProcessLog> ProcessLogs { get; }
	}