Torna agli aggiornamenti
New releaseSep 8, 2026

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.

Condividi

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.

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

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

https://docs.rs/rustls/

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

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:

Categorie