Module manual

This is the rustls manual.

This documentation primarily aims to explain design decisions taken in rustls.

It does this from a few aspects: how rustls attempts to avoid construction errors that occurred in other TLS libraries, how rustls attempts to avoid past TLS protocol vulnerabilities, and assorted advice for achieving common tasks with rustls.

Modules

_01_impl_vulnerabilities

This section discusses vulnerabilities in other TLS implementations, theorising their root cause and how we aim to avoid them in rustls.

_02_tls_vulnerabilities

This section discusses vulnerabilities and design errors in the TLS protocol.

_03_howto

This section collects together goal-oriented documentation.

_04_features

This section documents rustls itself: what protocol features are and are not implemented.

_05_defaults

This section provides rationale for the defaults in rustls.

_06_fips

This section provides guidance on using rustls with FIPS-approved cryptography.