Class VerifiedSignature

A class that represents a verified digital signature for a PDF document.

Inheritance
System.Object
VerifiedSignature
Namespace: IronPdf.Signing.Inspection
Assembly: IronPdf.dll
Syntax
public class VerifiedSignature : Object

Use VerifiedSignature in IronPDF when a C# application works with signature inspection. It represents that represents a verified digital signature for a PDF document.

VerifiedSignature matters when an application needs to configure or invoke signature inspection from C# code. The class encapsulates the related options and behavior in a single object that is set up once and reused across render or processing calls. Typical scenarios include batch generation pipelines, templated document workflows, and integration with existing C# document services.

To use VerifiedSignature, instantiate or obtain it from the relevant entry point in the IronPDF C# API. Key properties include CertificateChain, Filter, SignatureName, SignerCertificate. Assign options or invoke methods on the instance to configure or perform the operation.

using IronPdf;

// Obtain VerifiedSignature from the relevant entry point in the IronPDF API
void Configure(VerifiedSignature instance)
{
    var current = instance.CertificateChain;
    instance.ToString();
}

For the broader workflow, see the IronPDF C# documentation for related how-to guides and examples. For broader context, the signature inspection portion of the IronPDF C# API contains related types that work with VerifiedSignature directly. VerifiedSignature exposes additional members beyond those highlighted above; the reference tables on this page list the full set. In application code, treat VerifiedSignature as a configured object that is constructed once and reused across operations rather than instantiated per call. Configuration is generally idempotent: assigning the same property value twice has the same effect as assigning it once. For diagnostic purposes, inspect the relevant VerifiedSignature property after each operation to confirm the configured state. See the constructors, properties, and methods tables below for the complete API surface of VerifiedSignature. Application code typically obtains or instantiates a single VerifiedSignature and shares it across multiple IronPDF operations rather than recreating it per call.

Properties

CertificateChain

Gets the certificate chain from signer to root, if available. The first element is the signing certificate, the last is the root or highest intermediate. Empty if the chain could not be resolved.

Declaration
public IReadOnlyList<SignerCertificateInfo> CertificateChain { get; }
Property Value
Type Description
System.Collections.Generic.IReadOnlyList<SignerCertificateInfo>

Filter

Signature filter

Declaration
public string Filter { get; }
Property Value
Type Description
System.String

SignatureName

Gets the field name of the digital signature. This is the form field name from the /T key of the signature field dictionary.

Declaration
public string SignatureName { get; }
Property Value
Type Description
System.String

SignerCertificate

Gets the X.509 certificate details of the signer, including the full Subject DN, Issuer, Serial Number, validity period, convenience identity fields, and raw DER-encoded bytes. Returns null if the signing certificate could not be extracted from the signature.

Use SubjectSerialNumber to access the personal/national ID from the SERIALNUMBER OID in the certificate's Subject DN: 

var sig = document.GetVerifiedSignatures().First();
string nationalId = sig.SignerCertificate?.SubjectSerialNumber;

Declaration
public SignerCertificateInfo SignerCertificate { get; }
Property Value
Type Description
SignerCertificateInfo

SignerName

The common name of the certificate owner who signed the signature. This value is resolved from the /V/Name field of the signature dictionary, falling back to the certificate's Subject Distinguished Name (SubjectDN) CN field. Returns null if neither source provides a value.

Declaration
public string SignerName { get; }
Property Value
Type Description
System.String

SigningContact

The contact person or email address for signing related inquiries (optional). Resolved from /V/ContactInfo, certificate email, or certificate CN as a fallback.

Declaration
public string SigningContact { get; }
Property Value
Type Description
System.String

SigningDate

The date and time of the digital signature.

Declaration
public DateTime SigningDate { get; }
Property Value
Type Description
System.DateTime

SigningLocation

The physical location the PDF was signed (optional).

Declaration
public string SigningLocation { get; }
Property Value
Type Description
System.String

SigningReason

The reason the PDF was signed (optional).

Declaration
public string SigningReason { get; }
Property Value
Type Description
System.String

Status

Gets the validation status of the signature, indicating the overall result of all verification checks performed (e.g. cryptographic integrity, certificate trust, revocation status). Possible values are Valid, ValidWithWarnings, Indeterminate, and Invalid.

Declaration
public SignatureStatus Status { get; }
Property Value
Type Description
SignatureStatus

Valid

true if the signature is valid

Declaration
public bool Valid { get; }
Property Value
Type Description
System.Boolean

Warnings

Gets the list of warning and error messages generated during signature verification.

Declaration
public List<string> Warnings { get; }
Property Value
Type Description
System.Collections.Generic.List<System.String>

Methods

ToString()

Returns a string that represents the current digital signature for a PDF document.

Declaration
public override string ToString()
Returns
Type Description
System.String

A string that represents the current digital signature for a PDF document.