
rustls v/0.23.44
Libreria TLS memory-safe in Rust che implementa TLS 1.2 e 1.3 con provider crittografici pluggable, modalità client/server e autenticazione basata su certificati.
Rustls è una moderna libreria TLS scritta in Rust.
Stato
Rustls è utilizzata in produzione da molte organizzazioni e progetti. Miriamo a mantenere una ragionevole stabilità della superficie API, ma l'API può evolvere man mano che apportiamo modifiche per adattarci a nuove funzionalità o miglioramenti delle prestazioni.
Abbiamo una roadmap per i nostri piani futuri. Abbiamo anche dei benchmark per prevenire regressioni delle prestazioni e per permetterti di valutare rustls sull'hardware di destinazione.
Se desideri dare una mano, consulta CONTRIBUTING.md.
I manutentori pronunciano "rustls" come rustles (anziché rust-TLS), ma non ci teniamo particolarmente.
Changelog
L'elenco dettagliato delle modifiche in ciascuna release è disponibile su https://github.com/rustls/rustls/releases.
Documentazione
Approccio
Rustls è una libreria TLS che mira a fornire un buon livello di sicurezza crittografica, non richiede configurazione per raggiungere tale sicurezza e non fornisce funzionalità unsafe o crittografia obsoleta per impostazione predefinita.
Rustls implementa TLS1.2 e TLS1.3 sia per i client che per i server. Consulta l'elenco completo delle funzionalità del protocollo.
Supporto alle piattaforme
Sebbene Rustls stessa sia indipendente dalla piattaforma, richiede l'uso di primitive crittografiche
per implementare gli algoritmi crittografici utilizzati in TLS. In Rustls, un
crypto::CryptoProvider rappresenta una raccolta di implementazioni di primitive crittografiche.
Fornendo un'istanza personalizzata della struct crypto::CryptoProvider, puoi
sostituire tutte le dipendenze crittografiche di rustls. Questa è una via per essere portabile
su un insieme più ampio di architetture e ambienti, o per requisiti di conformità. Consulta la
documentazione di crypto::CryptoProvider per maggiori dettagli.
Provider crittografici
A partire da Rustls 0.22 è possibile scegliere il provider delle primitive crittografiche utilizzate da Rustls. Questo può essere interessante se hai requisiti specifici di piattaforma, conformità o funzionalità.
Dalla 0.24, gli utenti devono fornire esplicitamente un provider crittografico quando costruiscono istanze di ClientConfig o
ServerConfig. Consulta la documentazione di crypto::CryptoProvider per maggiori dettagli.
Provider first-party
Il progetto Rustls mantiene attualmente due provider crittografici:
rustls-aws-lc-rs- un provider che utilizza il crateaws-lc-rsper la crittografia. Sebbene questo provider possa essere più difficile da compilare su alcune piattaforme, offre eccellenti prestazioni e un set completo di funzionalità (inclusi algoritmi post-quantum).rustls-ring- un provider che utilizza il crateringper la crittografia. Questo provider è più facile da compilare su diverse piattaforme, ma ha un set di funzionalità più limitato (ad esempio, non supporta algoritmi post-quantum).
Il team di Rustls raccomanda di utilizzare il crate rustls-aws-lc-rs per il suo set completo di funzionalità
e le sue prestazioni. Consulta le FAQ di aws-lc-rs per maggiori dettagli sui
vincoli di supporto di piattaforma/architettura in aws-lc-rs.
Per i dettagli su come vengono selezionati i provider, consultare la documentazione di crypto::CryptoProvider.
(Per le versioni di rustls precedenti alla 0.24, entrambi questi provider erano inclusi come parte del crate rustls, e le feature di Cargo venivano utilizzate per selezionare il provider preferito. La feature aws-lc-rs era abilitata per impostazione predefinita.)
Provider di terze parti
La community ha inoltre sviluppato molti provider di terze parti per Rustls. Alcuni particolarmente degni di nota includono:
rustls-graviola- un provider che utilizzagraviolaper la crittografia.rustls-symcrypt- un provider che utilizza la libreria SymCrypt di Microsoft.
Per ulteriori provider di terze parti, consultare PROVIDERS.md.
Per maggiori informazioni su questo argomento, consultare la sezione Making a custom CryptoProvider della documentazione.
Codice di esempio
La nostra directory examples contiene demo che mostrano come gestire l'I/O utilizzando
l'helper stream::Stream, nonché I/O asincrono più complesso tramite mio.
Se stai già utilizzando Tokio come runtime asincrono, potresti preferire usare
tokio-rustls invece di interagire direttamente con rustls.
Gli esempi basati su mio sono i più completi e sono discussi di seguito. Gli utenti
nuovi a Rustls potrebbero preferire dare un'occhiata ai semplici esempi client/server prima di
addentrarsi negli esempi MIO più complessi.
Programma di esempio client
Il programma di esempio client MIO si chiama tls-client-mio.
Alcune esecuzioni di esempio:
$ 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
(...)
Esegui cargo run --bin tls-client-mio -- --help per ulteriori opzioni.
Programma di esempio server
Il programma di esempio del server MIO si chiama tls-server-mio.
Ecco un'esecuzione di esempio; avviamo un server echo TLS, poi vi ci connettiamo con
openssl e tls-client-mio: