pyHanko

PyHanko is a tool for signing and stamping PDF files.

Contents:

• CLI user’s guide
  • Signing PDF files
    • Some background on PDF signatures
    • Creating signature fields
    • Creating simple signatures
    • Creating signatures with long lifetimes
    • Customising signature appearances
  • Validating PDF signatures
    • Basic use
    • Factors in play when validating a signature
  • Stamping PDF files
  • Configuration options
    • Config file location
    • Configuration options
• Library (SDK) user’s guide
  • Reading and writing PDF files
    • Reading files
    • Modifying files
  • Signature fields
    • General API design
    • Positioning
    • Seed value settings
    • Document modification policy settings
  • Signing functionality
    • General API design
    • A simple example
    • Signature appearance generation
    • Timestamp handling
    • Creating PAdES signatures
    • Using aiohttp for network I/O
    • Extending Signer
    • The low-level PdfCMSEmbedder API
    • Interrupted signing
    • Generic data signing
  • Validation functionality
    • General API design
    • Accessing signatures in a document
    • Validating a PDF signature
    • Long-term verifiability checking
    • Incremental update analysis
    • Probing different aspects of the validity of a signature
  • The pdf-utils package
    • Background and future perspectives
    • PDF object model
    • PDF content abstractions
  • Developing CLI plugins
    • General principles
    • The plugin API
    • Plugin discovery and registration
  • Advanced examples
    • A custom Signer to use AWS KMS asynchronously
• API reference
  • pyhanko package
    • Subpackages
    • Submodules
    • pyhanko.keys module
    • pyhanko.stamp module
    • pyhanko.version module
  • pyhanko_certvalidator package
    • Subpackages
    • Submodules
    • pyhanko_certvalidator.asn1_types module
    • pyhanko_certvalidator.authority module
    • pyhanko_certvalidator.context module
    • pyhanko_certvalidator.errors module
    • pyhanko_certvalidator.name_trees module
    • pyhanko_certvalidator.path module
    • pyhanko_certvalidator.policy_decl module
    • pyhanko_certvalidator.policy_tree module
    • pyhanko_certvalidator.registry module
    • pyhanko_certvalidator.util module
    • pyhanko_certvalidator.validate module
    • pyhanko_certvalidator.version module
    • Module contents
• Release history
  • Dependency changes
  • Dependency changes
  • Bugs fixed
  • Bugs fixed
  • New features and enhancements
    • Encryption
  • Breaking changes
  • Dependency changes
  • Bugs fixed
  • Dependency changes
  • Bugs fixed
  • Bugs fixed
  • Breaking changes
  • Dependency changes
  • New features and enhancements
    • Signing
    • CLI
  • Bugs fixed
  • Dependency changes
  • New features and enhancements
    • Signing
    • Validation
    • CLI
  • Bugs fixed
  • Miscellaneous
  • Dependency changes
  • Miscellaneous
  • Dependency changes
  • Miscellaneous
  • Dependency changes
  • Breaking changes
  • New features and enhancements
    • Encryption
    • CLI
  • Bugs fixed
  • Dependency changes
  • Note
  • Breaking changes
  • Organisational changes
  • Dependency changes
  • Bugs fixed
  • New features and enhancements
    • Signing
    • Validation
  • Note
  • Bugs fixed
  • Note
  • Bugs fixed
  • Note
  • Dependency updates
  • Breaking changes
  • New features and enhancements
    • Validation
  • Dependency updates
  • Breaking changes
  • New features and enhancements
    • Signing
    • Validation
  • Bugs fixed
  • Note
  • Dependency updates
  • Bugs fixed
  • Note
  • Bugs fixed
  • New features and enhancements
    • Signing
    • Validation
  • Note
  • Breaking changes
  • Dependency updates
  • Bugs fixed
  • New features and enhancements
    • Signing
    • Validation
    • Encryption
    • Layout
    • Miscellaneous
  • Note
  • Dependency updates
  • Bugs fixed
  • Note
  • Dependency updates
  • Note
  • Dependency updates
  • Bugs fixed
  • New features and enhancements
    • Miscellaneous
    • Encryption
    • Signing
    • Validation
  • Dependency updates
  • Bugs fixed
  • Note
  • New features and enhancements
    • Miscellaneous
  • Bugs fixed
  • Dependency changes
  • Breaking changes
  • New features and enhancements
    • Signing
    • Validation
    • Miscellaneous
  • Bugs fixed
  • Dependency changes
  • New features and enhancements
    • Signing
    • Validation
    • Miscellaneous
  • Bugs fixed
  • Dependency changes
  • API-breaking changes
  • New features and enhancements
    • Signing
    • Validation
    • Miscellaneous
  • Bugs fixed
  • Dependency changes
  • API-breaking changes
  • New features and enhancements
    • Signing
    • Validation
    • Encryption
    • Miscellaneous
  • Bugs fixed
  • Dependency changes
  • API-breaking changes
    • Signing code refactor
    • Fonts
    • Miscellaneous
  • New features and enhancements
    • Signing
    • Validation
    • Encryption
    • Miscellaneous
  • Bugs fixed
    • Signing
    • Validation
    • Encryption
    • Miscellaneous
  • Dependency changes
  • Bugs fixed
  • Dependency changes
  • New features and enhancements
    • Signing
    • Validation
    • Encryption
    • Miscellaneous
  • Bugs fixed
  • Bugs fixed
  • Dependency changes
  • New features and enhancements
    • Encryption
    • Signing
    • Validation
    • Miscellaneous
  • Bugs fixed
  • New features and enhancements
    • Encryption
    • Signing
    • Validation
    • Miscellaneous
  • Bugs fixed
  • New features and enhancements
    • Encryption
    • Signing
    • Miscellaneous
    • Validation
  • Bugs fixed
  • New features and enhancements
    • Signing
    • Validation
    • CLI
    • General PDF API
  • Bugs fixed
• Frequently asked questions (FAQ)
  • Errors and other unexpected behaviour
    • I’m getting an error about hybrid reference files when trying to sign / validate a file. What gives?
    • Why am I getting path building errors?
  • Features & customisation
    • How do I use pyHanko to sign PDFs with a remote signing service?
    • I can’t get pyHanko to work with <insert PKCS#11 device here>. Can you help me?
    • I want to put Unicode text in my signatures, but I’m only seeing blanks. What gives?
• Known issues
• Release artifact authenticity
  • Overview
  • PGP signatures
    • Scope
    • Verifying PGP signatures using GnuPG
  • Sigstore signatures
    • Scope
    • Verifying Sigstore signatures issued through GitHub Actions OIDC
  • SLSA provenance data
    • Scope
    • Verifying SLSA provenance data on release builds
• Licenses
  • pyHanko License
  • Original PyPDF2 license

Indices and tables

• Index

• Module Index

• Search Page