Retour aux mises à jour
New releaseSep 8, 2026

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.

Partager

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.

Build Status Coverage Status (codecov.io) Documentation Chat OpenSSF Best Practices

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

https://docs.rs/rustls/

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 crate aws-lc-rs pour 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 crate ring pour 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 :

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.

Catégories