Table of Contents

Namespace PdfSharp.Pdf.Signatures

Classes

DigitalSignatureHandler

PdfDocument signature handler. Attaches a PKCS#7 signature digest to PdfDocument.

DigitalSignatureOptions

Sets the options of the DigitalSignatureHandler class.

PdfDocumentSecurityStore

The document security store (DSS, ISO 32000-2 12.8.4.3; ETSI EN 319 142-1 5.4.2): validation data for the document's signatures — certificates, OCSP responses and CRLs — kept in the document so the signatures can be validated after their certificates expire or are revoked. With it, PAdES B-T signatures become B-LT; a document time-stamp after it makes them B-LTA.

PdfSharpDefaultSigner

Signer implementation that uses .NET classes only. FreePDF: Format selects a PAdES baseline signature, and TimeStampClient replaces the HTTP call to the time-stamp authority. Time-stamps need .NET 8 or later.

PdfSignature

The signature dictionary added to a PDF file when it is to be signed.

PdfSignature.Keys

Predefined keys of this dictionary. The description comes from PDF 1.4 Reference.

PdfSignatureVerification

The facts FreePDF established about one signature, and a status. It is a technical check, not a statement about the legal effect of the signature.

PdfSignatureVerificationOptions

Options for PdfSignatureVerifier.

PdfSignatureVerifier

Checks the signatures and document time-stamps of a PDF file: that the bytes they cover are intact, who signed and when, whether the signer's chain ends at a trusted root, revocation, later changes, and the PAdES level (ISO 32000-2 12.8, ETSI EN 319 142-1, RFC 5652, RFC 3161, RFC 6960, RFC 5280). It reports facts and a technical status, not the legal effect of a signature; EU trusted lists and qualified status are not checked.

PdfTimeStampSigner

Adds a document time-stamp (ISO 32000-2 12.8.5, /SubFilter /ETSI.RFC3161): an RFC 3161 time-stamp token from a time-stamp authority over the bytes the signature covers. It shows that the document, with its signatures and its validation data, existed at that time; PAdES B-LTA adds one after the validation data (ETSI EN 319 142-1). Use it with DigitalSignatureHandler.ForDocument and no field name, certification or rectangle: a document time-stamp is an invisible new field. Needs .NET 8 or later.

PdfValidationDataOptions

Options for AddValidationDataAsync(PdfDocument, PdfValidationDataOptions?, CancellationToken).

PdfValidationDataReport

What AddValidationDataAsync(PdfDocument, PdfValidationDataOptions?, CancellationToken) found and added.

SigningManager

The PdfAManager bundles PDF/A specific functionality of a PDF document.

Interfaces

IDigitalSigner

Interface for classes that generate digital signatures.

IDigitalSignerFormat

Implemented by an IDigitalSigner whose CMS is not adbe.pkcs7.detached, so that the signature dictionary gets the matching /SubFilter. A signer without it writes adbe.pkcs7.detached. A signer that wraps another one (for logging or a hardware key, for example) must implement it too and return the wrapped signer's format; otherwise a PAdES signature is labelled adbe.pkcs7.detached.

Enums

PdfCertificationLevel

The changes a certified document permits after its certification signature (the DocMDP permission /P). Signing empty signature fields is always permitted.

PdfMessageDigestType

Specifies the algorithm used to generate the message digest.

PdfPadesLevel

The PAdES baseline level a signature reaches (ETSI EN 319 142-1), as far as FreePDF checks it.

PdfRevocationCheck

Where revocation data comes from when a signature is checked.

PdfRevocationStatus

The revocation status found for a signer's chain.

PdfSignatureFormat

The format of a signature's CMS (its /SubFilter, ISO 32000-2 12.8.3).

PdfSignatureKind

What a signature dictionary is.

PdfSignatureStatus

The overall result of checking one signature.