
openssl openssl-4.0.3
Универсальная библиотека TLS и криптографии
Добро пожаловать в проект OpenSSL
[![openssl logo]][www.openssl.org]
[![github actions ci badge]][github actions ci]
OpenSSL — это надёжный, коммерческого уровня, полнофункциональный набор инструментов с открытым исходным кодом для протоколов Transport Layer Security (TLS, ранее SSL), Datagram TLS (DTLS) и QUIC.
Реализации протоколов основаны на полноценной универсальной криптографической библиотеке, которую также можно использовать отдельно. Также включён криптографический модуль, прошедший валидацию на соответствие стандартам FIPS.
OpenSSL происходит от библиотеки SSLeay, разработанной Eric A. Young и Tim J. Hudson.
Официальная домашняя страница проекта OpenSSL — [www.openssl.org].
Содержание
- Обзор
- Загрузка
- Сборка и установка
- Документация
- Лицензия
- Поддержка
- Участие в разработке
- Правовые вопросы
Обзор
Набор инструментов OpenSSL включает:
-
libssl реализацию всех версий протокола TLS вплоть до TLSv1.3 ([RFC 8446]), версий протокола DTLS вплоть до DTLSv1.3 ([RFC 9147]) и протокола QUIC версии 1 ([RFC 9000]).
-
libcrypto полноценную универсальную криптографическую библиотеку. Она составляет основу реализации TLS, но также может использоваться независимо.
-
openssl инструмент командной строки OpenSSL, швейцарский нож для криптографических задач, тестирования и анализа. Его можно использовать для
- создания параметров ключей
- создания сертификатов X.509, CSR и CRL
- вычисления дайджестов сообщений
- шифрования и дешифрования
- тестирования SSL/TLS/DTLS и клиентов и серверов
- тестирования клиента QUIC
- обработки подписанной или зашифрованной почты S/MIME
- и многого другого...
Загрузка
Для промышленного использования
Архивы исходного кода официальных выпусков можно загрузить с openssl-library.org/source/. Проект OpenSSL не распространяет набор инструментов в бинарной форме.
Однако для большого разнообразия операционных систем доступны предкомпилированные версии набора инструментов OpenSSL. В частности, в Linux и других Unix-подобных операционных системах обычно рекомендуется компоноваться с предкомпилированными разделяемыми библиотеками, предоставляемыми дистрибьютором или поставщиком.
Мы также ведём список третьих сторон, которые производят бинарные файлы OpenSSL для различных операционных систем (включая Windows), на странице [Binaries] в нашей вики.
Для тестирования и разработки
Хотя тестирование и разработку в теории можно также вести с использованием архивов исходного кода, локальная копия git-репозитория с полной историей проекта даёт гораздо больше информации о кодовой базе.
Основной Git-репозиторий OpenSSL является приватным. Существует его публичное зеркало на GitHub по адресу [github.com/openssl/openssl], которое автоматически обновляется из первого при каждом коммите.
Локальную копию Git-репозитория можно получить, клонировав его из зеркала на GitHub с помощью
git clone https://github.com/openssl/openssl.git
Если вы намерены внести вклад в OpenSSL, будь то исправление ошибок или добавление новых функций, вам нужно сделать форк зеркала на GitHub и клонировать свой публичный форк вместо этого.
git clone https://github.com/yourname/openssl.git
Это необходимо, потому что вся разработка OpenSSL в настоящее время ведётся через pull-запросы на GitHub. Подробнее см. Участие в разработке.
Сборка и установка
После получения исходного кода ознакомьтесь с файлом INSTALL, чтобы получить подробные инструкции по сборке и установке OpenSSL. Для некоторых платформ инструкции по установке дополняются платформенно-специфичным документом.
- Заметки для UNIX-подобных платформ
- Заметки для платформ Android
- Заметки для платформ Windows
- Заметки для платформы DOS с DJGPP
- Заметки для платформы OpenVMS
- Заметки о Perl
- Заметки о Valgrind
Специфические заметки об обновлении до OpenSSL 3.x с предыдущих версий можно найти на странице руководства [ossl-guide-migration(7ossl)].
Документация
Файлы README
В корневом каталоге дистрибутива исходного кода есть несколько файлов README.md, содержащих дополнительную информацию по конкретным темам.
- Информация о реализации протокола OpenSSL QUIC
- Информация об архитектуре провайдеров OpenSSL
- Информация об использовании модуля OpenSSL с валидацией FIPS
Руководство по OpenSSL
В [Руководстве по OpenSSL] есть несколько обучающих и вводных страниц по некоторым важным темам OpenSSL.
Страницы руководства
Страницы руководства для ветки master и всех текущих стабильных выпусков доступны онлайн.
Демонстрации
В подпапке demos есть множество демонстраций исходного кода для использования различных возможностей OpenSSL.
Вики
Существует [GitHub Wiki], которая в настоящее время не очень активна.
Лицензия
OpenSSL распространяется под лицензией Apache License 2.0, что означает, что вы можете свободно получать и использовать её в коммерческих и некоммерческих целях при условии соблюдения её условий.
Подробнее см. файл LICENSE.txt.
Поддержка
Есть различные способы связаться с нами. Правильный канал зависит от ваших потребностей. Подробнее см. файл SUPPORT.
Участие в разработке
Если вам интересно и вы готовы внести вклад в проект OpenSSL, пожалуйста, ознакомьтесь с файлом CONTRIBUTING.