readme.md

pyhanko_certvalidator Documentation

pyhanko_certvalidator is a Python library for validating X.509 certificates and paths.

The documentation consists of the following topics:

• Implementation Details
• Usage

Implementation Details

pyhanko_certvalidator implements the following algorithms:

• [X.509/CRL] Certificate Path Validation algorithm from RFC 5280 Section 5
• [OCSP] Signed Response Acceptance Requirements from RFC 6960
• [TLS] DNS-ID and CN-ID Matching from RFC 6125

Supported features include:

• X.509 path building
• X.509 basic path validation
  • Signatures
    • RSA, DSA and EC algorithms
  • Name chaining
  • Validity dates
  • Basic constraints extension
    • CA flag
    • Path length constraint
  • Key usage extension
  • Extended key usage extension
  • Certificate policies
    • Policy constraints
    • Policy mapping
    • Inhibit anyPolicy
  • Failure on unknown/unsupported critical extensions
• TLS/SSL server validation
• Whitelisting certificates
• Blacklisting hash algorithms
• Revocation checks
  • CRLs
    • Indirect CRLs
    • Delta CRLs
  • OCSP checks
    • Delegated OCSP responders
  • Disable, require or allow soft failures
  • Caching of CRLs/OCSP responses
• CRL and OCSP HTTP clients
• Point-in-time validation

Testing is performed using:

• Public Key Interoperability Test Suite from NIST
• OCSP tests from OpenSSL
• Various certificates generated for TLS certificate validation