Security fixes will be backported only to the rustls versions for which the original semver-compatible release was published less than 2 years ago.
For example, as of 2024-04-18 the latest release is 0.23.4.
- 0.23.0 was released in February of 2024
- 0.22.0 was released in December of 2023
- 0.21.0 was released in March of 2023
- 0.20.0 was released in September of 2021
- 0.19.0 was released in November of 2020
Therefore 0.23.x, 0.22.x and 0.21.x will be updated, while 0.20.x and 0.19.x will not be.
Note
We use the date of crates.io
publication when evaluating the security
policy. For example, while the Rustls 0.20.0 GitHub release note was created
Jul, 2023 the actual release in crates.io
was published in Sept. 2021.
From time to time we will update our minimum supported Rust version (MSRV) in the course of normal development, subject to these constraints:
- Our MSRV will be no more recent than 9 versions old, or approximately 12 months.
Tip
At the time of writing, the most recent Rust release is 1.82.0. That means our MSRV could be as recent as 1.73.0. As it happens, it is 1.71.0.
-
Our MSRV policy only covers the core library crate: it does not cover tests or example code, and is not binding on our dependencies.
-
We do not consider MSRV changes to be breaking for the purposes of semver.
-
Once we reach 1.0.0, we will not make MSRV changes in patch releases. (Prior to reaching 1.0.0, cargo does not support patch releases.)
-
We will not make MSRV changes to security maintenance branches.
Note
For the avoidance of doubt: security maintenance branches exist for each
release line that is not the latest: so (at the time of writing) 0.22
and 0.21 have maintenance branches, but 0.23 does not and is released from
the main
branch.
We may take non-default optional new dependencies on a crate with a later MSRV than this policy.
Note
This is currently the case for our optional dependency on zlib-rs
, which
has a current MSRV of 1.75.0.
Please report security bugs via github. We'll then:
- Prepare a fix and regression tests.
- Backport the fix and make a patch release for most recent release.
- Submit an advisory to rustsec/advisory-db.
- Refer to the advisory on the main README.md and release notes.
If you're looking for security bugs, this crate is set up for
cargo fuzz
but would benefit from more runtime, targets and corpora.