Skip to content

Latest commit

 

History

History
338 lines (235 loc) · 11.8 KB

changelog.md

File metadata and controls

338 lines (235 loc) · 11.8 KB
Raw

changelog

0.26.5

  • Future-proofing against an upcoming asn1crypto that is already being shipped in some distro packages.
  • Address some timing issues in tests.

0.26.4

  • Bump aiohttp requirement to >=3.8,<3.11.
  • Declare support for Python 3.12 and 3.13

0.26.3

  • Bump aiohttp requirement to >=3.8,<3.10.

  • Address two certificate fetching issues (see PR #13)

    • Tolerate CMS certificate-only message in response without Content-Type.
    • Deal with implicit reliance on order of certs when processing such messages.

0.26.2

  • Bump some dependency versions.

0.26.1

  • Handle nonspecific OCSP validation errors cleanly during validation.

0.26.0

  • Fix error reporting on banned algorithms in some cases
  • Allow caller to assert revocation status of a cert
  • More refined POE information tracking in experimental AdES API

0.25.0

  • Introduce a more precise error type to signal stale revocation information (see PR #11)

0.24.1

  • Ignore content types altogether when fetching certificates and the response payload is PEM (see PR #9)

0.24.0

  • Further increase leniency regarding content types when fetching certificates on-the-fly
  • Add SLSA provenance data to releases
  • Various updates in test dependencies and CI workflow dependencies.

0.23.0

  • Improve processing of OCSP responses without nextUpdate
  • Some more package metadata & release flow tweaks

0.22.0

  • No implementation changes compared to 0.21.2
  • Renamed async_http dependency group to async-http.
  • Move towards automated GitHub Actions-based release flow as a move towards better process standardisation.
  • Sign release artifacts with Sigstore.

0.21.2

  • Fix a typing issue caused by a typo in the requests cert fetcher.
  • Removed a piece of misbehaving and duplicative logic in the revocation freshness checker.

0.21.1

  • Fix DisallowedAlgorithmError parameters.
  • Preserve timestamp info in expiration-related errors.
  • Disable algo enforcement in prima facie past validation checks.
  • Correct a misunderstanding in the interaction between the AdES code and the old "retroactive revinfo" setting.

0.21.0

  • Switch to pyproject.toml to manage project metadata.
  • Path validation errors now carry information about the paths that triggered them.
  • InvalidCertificateError is no longer a subclass of PathValidationError, only of ValidationError. This is a minor but nonetheless breaking change.

0.20.1

Minor maintenance release without functional changes, only to metadata, documentation and typing.

0.20.0

This is a big release, with many breaking changes in the "deeper" APIs. The impact on the high-level API should be small to nonexistent, but caution when upgrading is advised.

  • More uniform and machine-processable errors.
  • Move towards a setup using "policy objects" that can be used to construct ValidationContexts in a systematic way.
  • Move revinfo gathering to a separate revinfo manager class. Some arguably internal methods on ValidationContext were moved to the RevinfoManager class.
  • Incubating API for AdES validation primitives (freshness, POE handling, more sophisticated revinfo gathering, time slide) and some certificate-related validation routines.
  • Introduce a more fully-fledged API to manage permissible algorithms.
  • Broaden trust root provisioning beyond certificates: trust roots can now have qualifiers, and be provisioned as a name-key pair as opposed to a (self-signed) certificate. This implies breaking changes for ValidationPath. In general, issuance semantics in the internals are now expressed through the Authority API as much as possible.
  • In the same vein, CertificateRegistry was refactored into TrustManager, CertificateRegistry and PathBuilder. These are respectively responsible for managing trust, maintaining the certificate cache, and building paths.
  • Thorough clean-up of legacy dev tooling; put in place mypy and black, move to pytest, get rid of pretty_message in favour of f-strings.

0.19.8

  • Fix double encoding when generating OCSP nonces

0.19.7

  • Make certificate fetcher more tolerant (see #2)

0.19.6

  • Update asn1crypto to 1.5.1
  • Declare Python 3.11 support

0.19.5

  • Maintenance update to bump asn1crypto to 1.5.0 and get rid of a number of compatibility shims for fixes that were upstreamed to asn1crypto.

0.19.4

  • Fix improper error handling when dealing with expired or not-yet-valid attribute certificates.

0.19.3

  • Correct and improve behaviour of certificate fetcher when the server does not supply a Content-Type header.

0.19.2

  • Patch asn1crypto to work around tagging issue in AC issuer field

0.19.1

  • Properly enforce algo matching in AC validation

0.19.0

  • Attribute certificate validation support
  • Support for AAControls extension
  • Refactored OCSP and CRL logic to work with attribute certificate validation
  • Many nominal type checks removed in favour of type annotations
  • Many API entry points now accept both asn1crypto.x509.Certificate and asn1crypto.cms.AttributeCertificateV2
  • Minor breaking change: bytes is no longer acceptable as a substitute for asn1crypto.x509.Certificate in the public API

0.18.1

  • Various improvements to error handling in certificate fetchers

0.18.0

  • Replace revocation_mode with more flexible revocation policy controls, aligned with ETSI TS 119 172. Old revocation_mode params will be transparently translated to corresponding 'refined' policies, but the revocation_mode property on ValidationContext was removed.
  • Handle soft fails as part of revocation policies. Concretely, this means that the SoftFailError exception type was removed. Exceptions arising from quashed 'soft' failures can still be retrieved via the soft_fail_exceptions property on ValidationContext instances; the resulting list can contain any exception type.
  • Fix various hiccups in CRL and OCSP handling.

0.17.4

  • Fix mistaken assumption when a certificate's MIME type is announced as application/x-x509-ca-cert.
  • Update aiohttp to 3.8.0

0.17.3

  • Fix a deadlocking bug caused by improper exception handling in the fetcher code.
  • Exceptions are now communicated to fetch jobs waiting for results.

0.17.2

  • Replace run_until_complete() with asyncio.run() for better event loop state management.

0.17.1

  • Fixes a packaging error in 0.17.0

0.17.0

!!Compatibility note!!

This release contains breaking changes in lower-level APIs. High-level API functions should continue to work as-is, although some have been deprecated. However, the rewrite of the CRL & OCSP fetch logic breaks compatibility with the previous version's API.

  • Refactor OCSP/certificate/CRL fetch logic to be more modular and swappable.
  • Automatically fetch missing issuer certificates if there is an AIA record indicating where to find them
  • Favour asynchronous I/O throughout the API. CertificateValidator.validate_usage, CertificateValidator.validate_tls and the ValidationContext.retrieve_XYZ methods were deprecated in favour of their asynchronous equivalents.
  • Support two backends for fetching revocation information and certificates: requests (legacy) and aiohttp (via the async-http optional dependency group).
    • It is expected that using aiohttp fetchers will yield better performance with the asynchronous APIs, but as these require some resource management on the caller's part, requests is still the default.
    • Fetcher backends can be swapped out by means of the fetcher_backend argument to ValidationContext.

0.16.0

  • Refactor CertificateRegistry
  • Change OCSP responder cert selection procedure to give priority to certificates embedded into the response data (if there are any).

0.15.3

  • Short-circuit anyPolicy when reporting policies
  • Export PKIXValidationParams
  • Limit CRL client to HTTP-based URLs

0.15.2

  • Properly handle missing Content-Type header in server response when fetching CA certificates referenced in a CRL.

0.15.1

  • Gracefully handle lack of thisUpdate / nextUpdate in OCSP responses.

0.15.0

  • Use pyca/cryptography for signature validation. oscrypto is still included to access the system trust list.
  • Support RSASSA-PSS and EdDSA certificates.
  • Support name constraints.
  • Support all input parameters to the PKIX validation algorithm (acceptable policy set, policy mapping inhibition, ...).
  • Further increase PKITS coverage.

0.14.1

  • No code changes, rerelease because distribution package was polluted due to improper build cache cleanup.

0.14.0

  • Raise RequestError if CRL / OCSP client returns a status code other than 200. Previously, this would fail with a cryptic ASN.1 deserialisation error instead.
  • Rename Python package to pyhanko_certvalidator to avoid the potential name conflict with the upstream certvalidator package.

0.13.1

  • Consider SHA-1 weak by default, and do not hard-code the list of potential weak hash algos.

0.13.0

  • Added an optional retroactive_revinfo flag to ValidationContext to ignore the thisUpdate field in OCSP responses and CRLs. The effect of this is that CRLs and OCSP responses are also considered valid for point-in-time validation with respect to a time in the past. This is useful for some validation profiles. The default state of the flag remains False nonetheless.

0.12.1

  • Fixed a packaging error.

0.12.0

  • Forked from certvalidator to add patches for pyHanko.
  • Replaced urllib calls with requests library for universal mocking.
  • Added a time_tolerance parameter to the validation context to allow for some time drift on CRLs and OCSP responses.
  • Deal with no-matches on OCSP and CRLs strictly in hard-fail mode.
  • Drop support for Python 2, and all Python 3 versions prior to 3.7. It is likely that the code still runs on older Python 3 versions, but I have no interest in maintaining support for those.

0.11.1

0.11.0

  • Updated for compatibility with oscrypto 0.16.0

0.10.0

  • Backwards compability break: the require_revocation_checks parameter was removed and a new keyword parameter, revocation_mode, was added to ValidationContext(). Validation may now be in a soft-fail (default), hard-fail, or require mode. See the documentation for information about the behavior of each mode.
  • Added certificate signature hash algorithm checks, with a default blacklist of md2 and md5
  • Trust roots no longer need to be self-signed, allowing for cross-signed roots
  • Keys with no key_usage extension are now permitted to sign CRLs
  • An OCSP or CRL check may fail and not result in an error if the other is successful
  • Exceptions for expired or not-yet-valid certificates now include full date and time
  • Self-signed certificates now have a unique exception message instead of a generic message indicating the issuer could not be found in the trust roots
  • crl_client can now handle CRLs that are PEM-encoded
  • Fixed encoding of URLs in Python 2 when fetching CRLs and OCSP responses
  • Corrected an error when trying to check the signature of a certificate to determine if it is self-signed or not
  • Fixed a bug with duplicate HTTP headers during OCSP requests on Python 3
  • Fixed an exception that would be thrown if a signature not using RSA, DSA or ECDSA is found

0.9.1

  • Fixed a bug with whitelisting certificates on Python 3.2

0.9.0

  • Initial release