Voltar às atualizações
New releaseSep 8, 2026

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.

Compartilhar

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.

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

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

https://docs.rs/rustls/

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

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.

Licença

Categorias