Click or drag to resize

PdfTimestamper Class

Represents a timestamper that gets the TimeStampToken as specified in RFC 3161 as updated by RFC 5816.

The value of the messageImprint field within the TimeStampToken shall be a hash of either:

  • the bytes of the signature field within SignerInfo for the CMS-based Content if the generated timestamp token is included as a unsigned attribute of that SignerInfo (signature timestamp).
  • the bytes of the document indicated by the ByteRange and the ByteRange shall specify the complete PDF file contents (excepting the Content value) if the generated timestamp token is included as a content of a signature dictionary (whose Type entry has a value of DocTimeStamp) that is a value of a signature field added as an incremental update (document timestamp).
Inheritance Hierarchy
SystemObject
  SautinSoft.Pdf.SecurityPdfTimestamper

Namespace: SautinSoft.Pdf.Security
Assembly: SautinSoft.Pdf (in SautinSoft.Pdf.dll) Version: 2025.3.13
Syntax
Copy
public class PdfTimestamper

The PdfTimestamper type exposes the following members.

Constructors
 NameDescription
Public methodPdfTimestamper Initializes a new instance of the PdfTimestamper class with the specified address of a Timestamp Authority (TSA) that generates the timestamp token.
Top
Properties
 NameDescription
Public propertyAddress Gets the address of a Timestamp Authority (TSA) that generates the timestamp token.
Public propertyApplicationName

(Optional; PDF 1.5) The name of the software module used to create the timestamp. When used as an entry in the data dictionary of the Filter attribute (Table 2.1), the value is the name of the signature handler. The value is normally equal to the value of the Filter attribute in the signature dictionary.

Default value: Name.

Public propertyApplicationVersion

(Optional; PDF 1.6) A text string indicating the version of the application implementation, as described by the Name attribute in this dictionary. When set by Adobe Acrobat, this entry is in the format: major.minor.micro (for example 7.0.7).

Default value: Version.

Public propertyClientId

Gets or sets the client digital ID used in a Transport Layer Security protocol if Timestamp Authority (TSA) requires it to identify the TimeStampToken request client.

Default value: .

Public propertyHashAlgorithm

Gets or sets the hash algorithm that hashes either:

  • the bytes of the signature field within SignerInfo for the CMS-based Content if the generated timestamp token is included as an unsigned attribute of that SignerInfo (signature timestamp).
  • the bytes of the document indicated by the ByteRange and the ByteRange shall specify the complete PDF file contents (excepting the Content value) if the generated timestamp token is included as a content of a signature dictionary (whose Type entry has a value of DocTimeStamp) that is a value of a signature field added as an incremental update (document timestamp).

Default value: SHA512.

Public propertyPassword

Gets or sets the password used in an HTTP Authorization header if Timestamp Authority (TSA) requires authentication information for the TimeStampToken request.

Default value: .

Public propertyProxy

Gets or sets the proxy used by the PdfTimestamper.

Default value:

Public propertyUsername

Gets or sets the user name used in an HTTP Authorization header if Timestamp Authority (TSA) requires authentication information for the TimeStampToken request.

Default value: .

Top
Methods
 NameDescription
Public methodGetTimestampToken A method called when saving the PDF file that takes either the signature field value (in case of a signature timestamp) or the PDF file stream (without Content entry) (in case of a document timestamp) as an input and returns the TimeStampToken as specified in RFC 3161 as updated by RFC 5816.
Top
See Also