
rustls v/0.23.44
TLS 1.2および1.3を実装した、Rust製のメモリ安全なTLSライブラリ。プラグイン可能な暗号プロバイダ、クライアント/サーバーモード、証明書ベースの認証を備えています。
RustlsはRustで書かれたモダンなTLSライブラリです。
ステータス
Rustlsは多くの組織やプロジェクトで本番環境にて使用されています。私たちは妥当な範囲でのAPIの安定性を維持することを目指していますが、新機能への対応やパフォーマンス改善のための変更に伴い、APIが進化する可能性があります。
今後の計画についてはロードマップを用意しています。また、パフォーマンスのリグレッションを防ぎ、お使いのハードウェア上でrustlsを評価できるようにするためのベンチマークも用意しています。
貢献をご希望の場合は、CONTRIBUTING.mdをご覧ください。
メンテナーは「rustls」をrustles(rust-TLSではなく)と発音していますが、これについて特にこだわりはありません。
変更履歴
各リリースにおける詳細な変更点の一覧は 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プロジェクトは現在、2つの暗号プロバイダーをメンテナンスしています:
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 は以下の3つのライセンスの下で配布されています:
- 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 Code of Conduct を採用しています。 不正行為の事例を報告する場合、または行動規範に関するコメントや質問がある場合は、[email protected] までメールをお送りください。