
rustls v/0.23.44
Bibliothèque TLS à sûreté mémoire écrite en Rust, implémentant TLS 1.2 et 1.3 avec des fournisseurs cryptographiques enfichables, des modes client/serveur et une authentification par certificats.
Rustls est une bibliothèque TLS moderne écrite en Rust.
Statut
Rustls est utilisé en production dans de nombreuses organisations et projets. Nous visons à maintenir une stabilité raisonnable de la surface d'API, mais l'API peut évoluer au fil des modifications que nous apportons pour intégrer de nouvelles fonctionnalités ou des améliorations de performances.
Nous avons une feuille de route pour nos projets futurs. Nous disposons également de benchmarks afin de prévenir les régressions de performances et de vous permettre d'évaluer rustls sur votre matériel cible.
Si vous souhaitez apporter votre aide, veuillez consulter CONTRIBUTING.md.
Les mainteneurs prononcent « rustls » comme rustles (plutôt que rust-TLS), mais cela ne nous tient pas particulièrement à cœur.
Journal des modifications
La liste détaillée des changements de chaque version est disponible à l'adresse https://github.com/rustls/rustls/releases.
Documentation
Approche
Rustls est une bibliothèque TLS qui vise à offrir un bon niveau de sécurité cryptographique, ne nécessite aucune configuration pour atteindre ce niveau de sécurité, et ne fournit par défaut aucune fonctionnalité non sécurisée ni de cryptographie obsolète.
Rustls implémente TLS1.2 et TLS1.3 pour les clients comme pour les serveurs. Voir la liste complète des fonctionnalités du protocole.
Prise en charge des plateformes
Bien que Rustls soit lui-même indépendant de la plateforme, il nécessite l'utilisation de primitives cryptographiques
pour implémenter les algorithmes cryptographiques utilisés dans TLS. Dans Rustls, un
crypto::CryptoProvider représente une collection d'implémentations de primitives cryptographiques.
En fournissant une instance personnalisée de la structure crypto::CryptoProvider, vous
pouvez remplacer toutes les dépendances cryptographiques de rustls. C'est une voie vers la portabilité
vers un plus large ensemble d'architectures et d'environnements, ou vers des exigences de conformité. Consultez la
documentation de crypto::CryptoProvider pour plus de détails.
Fournisseurs de cryptographie
Depuis Rustls 0.22, il est possible de choisir le fournisseur des primitives cryptographiques utilisées par Rustls. Cela peut être intéressant si vous avez des exigences spécifiques en matière de plateforme, de conformité ou de fonctionnalités.
À partir de la version 0.24, les utilisateurs doivent explicitement fournir un fournisseur de cryptographie lors de la construction d'instances de ClientConfig ou
ServerConfig. Consultez la documentation de crypto::CryptoProvider pour plus de détails.
Fournisseurs internes
Le projet Rustls maintient actuellement deux fournisseurs de cryptographie :
rustls-aws-lc-rs- un fournisseur qui utilise la crateaws-lc-rspour la cryptographie. Bien que ce fournisseur puisse être plus difficile à compiler sur certaines plateformes, il offre d'excellentes performances et un ensemble complet de fonctionnalités (y compris les algorithmes post-quantiques).rustls-ring- un fournisseur qui utilise la crateringpour la cryptographie. Ce fournisseur est plus facile à compiler sur une variété de plateformes, mais dispose d'un ensemble de fonctionnalités plus limité (par exemple, il ne prend pas en charge les algorithmes post-quantiques).
L'équipe Rustls recommande d'utiliser la crate rustls-aws-lc-rs pour son ensemble complet de fonctionnalités
et ses performances. Consultez la FAQ aws-lc-rs pour plus de détails sur les
contraintes de prise en charge des plateformes/architectures dans aws-lc-rs.
Consultez la documentation de crypto::CryptoProvider pour plus de détails sur la façon dont les fournisseurs sont sélectionnés.
(Pour les versions de rustls antérieures à 0.24, ces deux fournisseurs étaient livrés dans le crate rustls, et les fonctionnalités Cargo étaient utilisées pour sélectionner le fournisseur préféré. La fonctionnalité aws-lc-rs était activée par défaut.)
Fournisseurs tiers
La communauté a également développé de nombreux fournisseurs tiers pour Rustls. Certains particulièrement notables incluent :
rustls-graviola- un fournisseur qui utilisegraviolapour la cryptographie.rustls-symcrypt- un fournisseur qui utilise la bibliothèque SymCrypt de Microsoft.
Pour plus de fournisseurs tiers, consultez PROVIDERS.md.
Consultez la section Making a custom CryptoProvider de la documentation pour plus d'informations sur ce sujet.
Exemple de code
Notre répertoire examples contient des démonstrations qui montrent comment gérer les E/S à l'aide de l'assistant stream::Stream, ainsi que des E/S asynchrones plus complexes à l'aide de mio. Si vous utilisez déjà Tokio comme runtime asynchrone, vous préférerez peut-être utiliser tokio-rustls plutôt que d'interagir directement avec rustls.
Les exemples basés sur mio sont les plus complets, et sont discutés ci-dessous. Les utilisateurs découvrant Rustls préféreront peut-être consulter les exemples simples client/serveur avant de se plonger dans les exemples MIO plus complexes.
Programme d'exemple client
Le programme d'exemple client MIO est nommé tls-client-mio.
Quelques exécutions d'exemple :
$ cargo run --bin tls-client-mio -- --http jbp.io
HTTP/1.1 200 OK
Date: Tue, 23 Jun 2026 16:13:40 GMT
Content-Type: text/html; charset=utf-8
Connection: close
(...)
Exécutez cargo run --bin tls-client-mio -- --help pour plus d'options.
Programme d'exemple de serveur
Le programme d'exemple de serveur MIO est nommé tls-server-mio.