
rustls v/0.23.44
Безопасная по памяти TLS-библиотека на Rust, реализующая TLS 1.2 и 1.3, с подключаемыми криптопровайдерами, клиентским/серверным режимами и аутентификацией на основе сертификатов.
Rustls — современная библиотека TLS, написанная на Rust.
Статус
Rustls используется в production во многих организациях и проектах. Мы стремимся поддерживать разумную стабильность 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 поддерживает два криптографических провайдера:
rustls-aws-lc-rs— провайдер, использующий крейтaws-lc-rsдля криптографии. Хотя этот провайдер может быть сложнее собрать на некоторых платформах, он обеспечивает отличную производительность и полный набор возможностей (включая постквантовые алгоритмы).rustls-ring— провайдер, использующий крейтringдля криптографии. Этот провайдер проще собрать на различных платформах, но он имеет более ограниченный набор возможностей (например, он не поддерживает постквантовые алгоритмы).
Команда Rustls рекомендует использовать крейт rustls-aws-lc-rs благодаря его полному набору возможностей
и производительности. Подробнее об ограничениях поддержки
платформ/архитектур в aws-lc-rs см. в FAQ по aws-lc-rs.
Подробности о том, как выбираются провайдеры, см. в документации для crypto::CryptoProvider.
(В версиях rustls до 0.24 оба этих провайдера поставлялись в составе крейта rustls, а для выбора предпочтительного провайдера использовались функции Cargo. Функция aws-lc-rs была включена по умолчанию.)
Сторонние провайдеры
Сообщество также разработало множество сторонних провайдеров для Rustls. К числу особо примечательных относятся:
rustls-graviola— провайдер, использующийgraviolaдля криптографии.rustls-symcrypt— провайдер, использующий библиотеку SymCrypt от Microsoft.
Другие сторонние провайдеры см. в PROVIDERS.md.
Дополнительную информацию по этой теме см. в разделе Making a custom CryptoProvider документации.
Пример кода
Наш каталог examples содержит демонстрационные программы, показывающие, как обрабатывать ввод-вывод с помощью вспомогательного средства stream::Stream, а также более сложный асинхронный ввод-вывод с использованием mio.
Если вы уже используете Tokio в качестве асинхронной среды выполнения, возможно, вы предпочтёте использовать tokio-rustls вместо прямого взаимодействия с 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 распространяется под следующими тремя лицензиями: