
rustls v/0.23.44
Rust로 구현된 메모리 안전 TLS 라이브러리로, TLS 1.2 및 1.3을 구현하며 플러그형 암호화 제공자, 클라이언트/서버 모드 및 인증서 기반 인증을 지원합니다.
Rustls는 Rust로 작성된 현대적인 TLS 라이브러리입니다.
상태
Rustls는 많은 조직과 프로젝트의 프로덕션 환경에서 사용되고 있습니다. 우리는 합리적인 수준의 API 표면 안정성을 유지하는 것을 목표로 하지만, 새로운 기능이나 성능 개선을 수용하기 위한 변경에 따라 API가 발전할 수 있습니다.
우리의 향후 계획에 대한 로드맵이 있습니다. 또한 성능 회귀를 방지하고 대상 하드웨어에서 rustls를 평가할 수 있도록 벤치마크도 제공합니다.
도움을 주고 싶으시다면 CONTRIBUTING.md를 참고하세요.
메인테이너들은 "rustls"를 rust-TLS가 아닌 rustles로 발음하지만, 이에 대해 강하게 생각하지는 않습니다.
변경 로그
각 릴리스의 상세한 변경 목록은 https://github.com/rustls/rustls/releases 에서 확인할 수 있습니다.
문서
접근 방식
Rustls는 좋은 수준의 암호화 보안을 제공하는 것을 목표로 하며, 그러한 보안을 달성하기 위해 별도의 구성이 필요하지 않고, 기본적으로 안전하지 않은 기능이나 구식 암호화를 제공하지 않는 TLS 라이브러리입니다.
Rustls는 클라이언트와 서버 모두에 대해 TLS1.2와 TLS1.3을 구현합니다. 프로토콜 기능의 전체 목록을 참고하세요.
플랫폼 지원
Rustls 자체는 플랫폼 독립적이지만, TLS에 사용되는 암호화 알고리즘을 구현하기 위해 암호화 프리미티브를 사용해야 합니다. Rustls에서 crypto::CryptoProvider는 암호화 프리미티브 구현의 집합을 나타냅니다.
crypto::CryptoProvider 구조체의 사용자 정의 인스턴스를 제공함으로써 rustls의 모든 암호화 의존성을 교체할 수 있습니다. 이는 더 넓은 범위의 아키텍처와 환경, 또는 규정 준수 요구 사항에 이식 가능하도록 하는 방법입니다. 자세한 내용은 crypto::CryptoProvider 문서를 참고하세요.
암호화 제공자
Rustls 0.22부터 Rustls가 사용하는 암호화 프리미티브의 제공자를 선택할 수 있게 되었습니다. 이는 특정 플랫폼, 규정 준수 또는 기능 요구 사항이 있는 경우 매력적일 수 있습니다.
0.24부터 사용자는 ClientConfig 또는 ServerConfig 인스턴스를 생성할 때 암호화 제공자를 명시적으로 제공해야 합니다. 자세한 내용은 crypto::CryptoProvider 문서를 참고하세요.
자체 제공자
Rustls 프로젝트는 현재 두 가지 암호화 제공자를 유지 관리합니다:
rustls-aws-lc-rs- 암호화에aws-lc-rs크레이트를 사용하는 제공자입니다. 이 제공자는 일부 플랫폼에서 빌드하기가 더 어려울 수 있지만, 뛰어난 성능과 완전한 기능 세트(양자 내성 알고리즘 포함)를 제공합니다.rustls-ring- 암호화에ring크레이트를 사용하는 제공자입니다. 이 제공자는 다양한 플랫폼에서 빌드하기가 더 쉽지만, 기능 세트가 더 제한적입니다(예: 양자 내성 알고리즘을 지원하지 않음).
Rustls 팀은 완전한 기능 세트와 성능을 위해 rustls-aws-lc-rs 크레이트를 사용할 것을 권장합니다. aws-lc-rs의 플랫폼/아키텍처 지원 제약에 대한 자세한 내용은 aws-lc-rs FAQ를 참고하세요.
프로바이더가 선택되는 방식에 대한 자세한 내용은 crypto::CryptoProvider 문서를 참조하십시오.
(0.24 이전의 rustls 버전에서는 이 두 프로바이더가 모두 rustls 크레이트의 일부로 제공되었으며, Cargo 기능을 사용하여 선호하는 프로바이더를 선택했습니다. aws-lc-rs 기능은 기본적으로 활성화되어 있었습니다.)
서드파티 프로바이더
커뮤니티는 또한 Rustls를 위한 많은 서드파티 프로바이더를 개발해 왔습니다. 특히 주목할 만한 것들은 다음과 같습니다:
rustls-graviola- 암호화에graviola를 사용하는 프로바이더입니다.rustls-symcrypt- Microsoft의 SymCrypt 라이브러리를 사용하는 프로바이더입니다.
더 많은 서드파티 프로바이더는 PROVIDERS.md를 참조하십시오.
이 주제에 대한 자세한 내용은 문서의 Making a custom CryptoProvider 섹션을 참조하십시오.
예제 코드
examples 디렉터리에는 stream::Stream 헬퍼를 사용하여 I/O를 처리하는 방법과 mio를 사용한 더 복잡한 비동기 I/O를 보여주는 데모가 포함되어 있습니다.
이미 비동기 런타임으로 Tokio를 사용하고 있다면 rustls와 직접 상호작용하는 대신
tokio-rustls를 사용하는 것을 선호할 수 있습니다.
mio 기반 예제가 가장 완전하며 아래에서 설명합니다. Rustls가 처음인 사용자는
더 복잡한 MIO 예제를 살펴보기 전에 간단한 클라이언트/서버 예제를 먼저 살펴보는 것을 선호할 수 있습니다.
클라이언트 예제 프로그램
MIO 클라이언트 예제 프로그램의 이름은 tls-client-mio입니다.
몇 가지 실행 예시:
$ 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
(...)
더 많은 옵션은 cargo run --bin tls-client-mio -- --help를 실행하세요.
서버 예제 프로그램
MIO 서버 예제 프로그램의 이름은 tls-server-mio입니다.
다음은 샘플 실행입니다. TLS 에코 서버를 시작한 다음, openssl과 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
추가 옵션은 cargo run --bin tls-server-mio -- --help를 실행하세요.
라이선스
Rustls는 다음 세 가지 라이선스로 배포됩니다:
- Apache License version 2.0.
- MIT license.
- ISC license.
이는 각각 LICENSE-APACHE, LICENSE-MIT, LICENSE-ISC로 포함되어 있습니다. 귀하는 선택에 따라 이 라이선스 중 어느 것의 조건으로든 이 소프트웨어를 사용할 수 있습니다.
프로젝트 멤버십
- Joe Birr-Pixton (@ctz, 프로젝트 창립자 - Prossimo의 전액 지원을 받는 상근)
- Dirkjan Ochtman (@djc, 공동 유지관리자)
- Daniel McCarney (@cpu, 공동 유지관리자)
- Josh Aas (@bdaehlie, 프로젝트 관리)
행동 강령
이 프로젝트는 Rust 행동 강령을 채택합니다. 위반 사례를 신고하거나 행동 강령에 대한 의견이나 질문이 있으시면 [email protected]으로 이메일을 보내주세요.