
rustls v/0.23.44
Speichersichere TLS-Bibliothek in Rust, die TLS 1.2 und 1.3 mit austauschbaren Krypto-Anbietern, Client-/Server-Modi und zertifikatsbasierter Authentifizierung implementiert.
Rustls ist eine moderne TLS-Bibliothek, geschrieben in Rust.
Status
Rustls wird in der Produktion bei vielen Organisationen und Projekten eingesetzt. Wir streben danach, eine angemessene Stabilität der API-Oberfläche zu gewährleisten, aber die API kann sich weiterentwickeln, während wir Änderungen vornehmen, um neue Funktionen oder Leistungsverbesserungen zu ermöglichen.
Wir haben eine Roadmap für unsere zukünftigen Pläne. Wir haben außerdem Benchmarks, um Leistungsregressionen zu verhindern und Ihnen die Bewertung von rustls auf Ihrer Zielhardware zu ermöglichen.
Wenn Sie mithelfen möchten, lesen Sie bitte CONTRIBUTING.md.
Die Maintainer sprechen "rustls" als rustles aus (und nicht als rust-TLS), aber wir legen uns darauf nicht fest.
Changelog
Die detaillierte Liste der Änderungen in jeder Version finden Sie unter https://github.com/rustls/rustls/releases.
Dokumentation
Ansatz
Rustls ist eine TLS-Bibliothek, die ein gutes Maß an kryptografischer Sicherheit bieten möchte, keine Konfiguration erfordert, um diese Sicherheit zu erreichen, und standardmäßig keine unsicheren Funktionen oder veraltete Kryptografie bereitstellt.
Rustls implementiert TLS1.2 und TLS1.3 sowohl für Clients als auch für Server. Siehe die vollständige Liste der Protokollfunktionen.
Plattformunterstützung
Obwohl Rustls selbst plattformunabhängig ist, erfordert es die Verwendung kryptografischer Primitive
für die Implementierung der in TLS verwendeten kryptografischen Algorithmen. In Rustls repräsentiert ein
crypto::CryptoProvider eine Sammlung von Implementierungen kryptografischer Primitive.
Durch die Bereitstellung einer benutzerdefinierten Instanz der Struktur crypto::CryptoProvider können
Sie alle Kryptografie-Abhängigkeiten von rustls ersetzen. Dies ist ein Weg, um auf eine breitere
Menge von Architekturen und Umgebungen oder Compliance-Anforderungen portierbar zu sein. Weitere Details finden Sie in der
Dokumentation zu crypto::CryptoProvider.
Kryptografie-Provider
Seit Rustls 0.22 ist es möglich, den Provider der kryptografischen Primitive zu wählen, die Rustls verwendet. Dies kann attraktiv sein, wenn Sie spezifische Plattform-, Compliance- oder Funktions- anforderungen haben.
Ab 0.24 müssen Benutzer beim Erstellen von ClientConfig- oder
ServerConfig-Instanzen explizit einen Krypto-Provider bereitstellen. Weitere Details finden Sie in der
Dokumentation zu crypto::CryptoProvider.
First-Party-Provider
Das Rustls-Projekt pflegt derzeit zwei Kryptografie-Provider:
rustls-aws-lc-rs– ein Provider, der die Crateaws-lc-rsfür Kryptografie verwendet. Obwohl dieser Provider auf einigen Plattformen schwieriger zu bauen sein kann, bietet er hervorragende Leistung und einen vollständigen Funktionsumfang (einschließlich Post-Quanten-Algorithmen).rustls-ring– ein Provider, der die Crateringfür Kryptografie verwendet. Dieser Provider ist auf einer Vielzahl von Plattformen einfacher zu bauen, hat aber einen eingeschränkteren Funktionsumfang (zum Beispiel unterstützt er keine Post-Quanten-Algorithmen).
Das Rustls-Team empfiehlt die Verwendung der Crate rustls-aws-lc-rs wegen ihres vollständigen Funktionsumfangs
und ihrer Leistung. Weitere Details zu den
Plattform-/Architekturunterstützungsbeschränkungen in aws-lc-rs finden Sie in den aws-lc-rs-FAQ.
Siehe die Dokumentation für crypto::CryptoProvider für Details dazu, wie Provider
ausgewählt werden.
(Für rustls-Versionen vor 0.24 wurden beide dieser Provider als Teil des rustls-Crates
ausgeliefert, und Cargo-Features wurden verwendet, um den bevorzugten Provider auszuwählen. Das
Feature aws-lc-rs war standardmäßig aktiviert.)
Drittanbieter-Provider
Die Community hat auch viele Drittanbieter-Provider für Rustls entwickelt. Besonders erwähnenswerte sind:
rustls-graviola– ein Provider, dergraviolafür Kryptographie verwendet.rustls-symcrypt– ein Provider, der Microsofts SymCrypt-Bibliothek verwendet.
Weitere Drittanbieter-Provider finden Sie in PROVIDERS.md.
Siehe den Abschnitt Making a custom CryptoProvider der Dokumentation für weitere Informationen zu diesem Thema.
Beispielcode
Unser examples-Verzeichnis enthält Demos, die zeigen, wie man I/O mit dem
stream::Stream-Helfer handhabt, sowie komplexere asynchrone I/O mit mio.
Wenn Sie bereits Tokio als Async-Runtime verwenden, bevorzugen Sie möglicherweise
tokio-rustls anstelle der direkten Interaktion mit rustls.
Die auf mio basierenden Beispiele sind die vollständigsten und werden im Folgenden
besprochen. Nutzer, die neu bei Rustls sind, sollten sich möglicherweise zuerst die einfachen
Client/Server-Beispiele ansehen, bevor sie in die komplexeren MIO-Beispiele eintauchen.
Client-Beispielprogramm
Das MIO-Client-Beispielprogramm heißt tls-client-mio.
Einige Beispielausführungen:
$ 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
(...)
Führen Sie cargo run --bin tls-client-mio -- --help aus, um weitere Optionen anzuzeigen.
Beispielprogramm für den Server
Das MIO-Beispielprogramm für den Server heißt tls-server-mio.
Hier ist ein Beispiellauf; wir starten einen TLS-Echo-Server und verbinden uns dann mit
openssl und tls-client-mio damit: