
rustls v/0.23.44
Biblioteca TLS memory-safe em Rust que implementa TLS 1.2 e 1.3 com provedores de criptografia plugáveis, modos cliente/servidor e autenticação baseada em certificados.
Rustls é uma biblioteca TLS moderna escrita em Rust.
Status
Rustls é usado em produção em muitas organizações e projetos. Pretendemos manter uma estabilidade razoável da superfície da API, mas a API pode evoluir à medida que fazemos alterações para acomodar novos recursos ou melhorias de desempenho.
Temos um roadmap para os nossos planos futuros. Também temos benchmarks para prevenir regressões de desempenho e permitir que avalie o rustls no seu hardware alvo.
Se gostaria de ajudar, consulte CONTRIBUTING.md.
Os mantenedores pronunciam "rustls" como rustles (em vez de rust-TLS), mas não temos uma opinião forte sobre isso.
Changelog
A lista detalhada de alterações em cada versão pode ser encontrada em https://github.com/rustls/rustls/releases.
Documentação
Abordagem
Rustls é uma biblioteca TLS que visa proporcionar um bom nível de segurança criptográfica, não requer configuração para alcançar essa segurança, e não fornece recursos inseguros ou criptografia obsoleta por padrão.
Rustls implementa TLS1.2 e TLS1.3 tanto para clientes como para servidores. Consulte a lista completa de recursos de protocolo.
Suporte de plataforma
Embora o próprio Rustls seja independente de plataforma, requer o uso de primitivas criptográficas
para implementar os algoritmos criptográficos usados em TLS. No Rustls, um
crypto::CryptoProvider representa uma coleção de implementações de primitivas criptográficas.
Ao fornecer uma instância personalizada da estrutura crypto::CryptoProvider, pode
substituir todas as dependências criptográficas do rustls. Este é um caminho para ser portável
para um conjunto mais amplo de arquiteturas e ambientes, ou requisitos de conformidade. Consulte a
documentação de crypto::CryptoProvider para mais detalhes.
Provedores de criptografia
Desde o Rustls 0.22 tem sido possível escolher o provedor das primitivas criptográficas que o Rustls utiliza. Isto pode ser atrativo se tiver requisitos específicos de plataforma, conformidade ou funcionalidades.
A partir da 0.24, os utilizadores devem fornecer explicitamente um provedor de criptografia ao construir instâncias de ClientConfig ou
ServerConfig. Consulte a documentação de crypto::CryptoProvider para mais detalhes.
Provedores de primeira parte
O projeto Rustls mantém atualmente dois provedores de criptografia:
rustls-aws-lc-rs- um provedor que usa a crateaws-lc-rspara criptografia. Embora este provedor possa ser mais difícil de compilar em algumas plataformas, proporciona excelente desempenho e um conjunto completo de funcionalidades (incluindo algoritmos pós-quânticos).rustls-ring- um provedor que usa a crateringpara criptografia. Este provedor é mais fácil de compilar numa variedade de plataformas, mas tem um conjunto de funcionalidades mais limitado (por exemplo, não suporta algoritmos pós-quânticos).
A equipa do Rustls recomenda o uso da crate rustls-aws-lc-rs pelo seu conjunto completo de funcionalidades
e desempenho. Consulte as FAQ do aws-lc-rs para mais detalhes sobre as
restrições de suporte de plataforma/arquitetura no aws-lc-rs.
Consulte a documentação de crypto::CryptoProvider para obter detalhes sobre como os provedores são
selecionados.
(Para versões do rustls anteriores à 0.24, ambos os provedores eram distribuídos como parte do crate
rustls, e os recursos do Cargo eram usados para selecionar o provedor preferido. O recurso aws-lc-rs
era habilitado por padrão.)
Provedores de terceiros
A comunidade também desenvolveu muitos provedores de terceiros para o Rustls. Alguns de particular destaque incluem:
rustls-graviola- um provedor que usagraviolapara criptografia.rustls-symcrypt- um provedor que usa a biblioteca SymCrypt da Microsoft.
Para mais provedores de terceiros, consulte PROVIDERS.md.
Consulte a seção Making a custom CryptoProvider da documentação para mais informações sobre este tópico.
Código de exemplo
Nosso diretório examples contém demonstrações que mostram como lidar com E/S usando o
auxiliar stream::Stream, bem como E/S assíncrona mais complexa usando mio.
Se você já usa Tokio como runtime assíncrono, pode preferir usar
tokio-rustls em vez de interagir diretamente com o rustls.
Os exemplos baseados em mio são os mais completos e são discutidos abaixo. Usuários
novos no Rustls podem preferir olhar os exemplos simples de cliente/servidor antes de
mergulhar nos exemplos mais complexos de MIO.
Programa de exemplo de cliente
O programa de exemplo de cliente MIO chama-se tls-client-mio.
Algumas execuções de exemplo:
$ 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
(...)
Execute cargo run --bin tls-client-mio -- --help para ver mais opções.
Programa de exemplo do servidor
O programa de exemplo do servidor MIO chama-se tls-server-mio.
Segue-se uma execução de exemplo; iniciamos um servidor TLS de eco e, em seguida, ligamo-nos a ele com
openssl e tls-client-mio:
$ cargo run --bin tls-server-mio -- --certs test-ca/rsa-2048/end.fullchain --key test-ca/rsa-2048/end.key -p 8443 echo &
$ echo hello world | openssl s_client -ign_eof -quiet -connect localhost:8443
depth=2 CN = ponytown RSA CA
verify error:num=19:self signed certificate in certificate chain
hello world
^C
$ echo hello world | cargo run --bin tls-client-mio -- --cafile test-ca/rsa-2048/ca.cert --port 8443 localhost
hello world
^C
Execute cargo run --bin tls-server-mio -- --help para mais opções.