
Инструментарий с открытым исходным кодом, реализующий протоколы SSL/TLS и полноценную криптографическую библиотеку с шифрованием, дешифрованием, управлением сертификатами и хеш-функциями.
OpenSSL 1.0.1g 7 Apr 2014
Copyright (c) 1998-2011 The OpenSSL Project Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson Все права защищены.
Проект OpenSSL — это совместная работа по созданию надёжного, коммерческого уровня, полнофункционального инструментария с открытым исходным кодом, реализующего протоколы Secure Sockets Layer (SSL v2/v3) и Transport Layer Security (TLS v1), а также полноценную криптографическую библиотеку общего назначения. Проект управляется всемирным сообществом добровольцев, которые используют Интернет для общения, планирования и разработки инструментария OpenSSL и его соответствующей документации.
OpenSSL основан на превосходной библиотеке SSLeay, разработанной Эриком А. Янгом и Тимом Дж. Хадсоном. Инструментарий OpenSSL распространяется по двойной лицензии (лицензия OpenSSL плюс лицензия SSLeay), что по сути означает, что вы можете свободно получать и использовать его в коммерческих и некоммерческих целях при условии выполнения требований обеих лицензий.
Инструментарий OpenSSL включает:
libssl.a: Реализация SSLv2, SSLv3, TLSv1 и необходимый код для поддержки SSLv2, SSLv3 и TLSv1 одновременно в одном сервере и клиенте.
libcrypto.a: Общие функции шифрования и X.509 v1/v3, необходимые для SSL/TLS, но не являющиеся логической его частью. Он включает подпрограммы для следующего:
Шифры
libdes — пакет DES-шифрования libdes от EAY, который некоторое время
распространялся по сети в течение нескольких лет, а затем был перелицензирован
им в составе SSLeay. Он включает 15 «режимов/вариаций»
DES (версии с 1, 2 и 3 ключами для ecb, cbc, cfb и ofb;
pcbc и более общая форма cfb и ofb), включая desx
в режиме cbc, быстрый crypt(3) и подпрограммы для чтения
паролей с клавиатуры.
RC4-шифрование,
RC2-шифрование - 4 различных режима: ecb, cbc, cfb и ofb.
Blowfish-шифрование - 4 различных режима: ecb, cbc, cfb и ofb.
IDEA-шифрование - 4 различных режима: ecb, cbc, cfb и ofb.
Дайджесты
Алгоритмы дайджеста сообщений MD5 и MD2, быстрые реализации,
алгоритмы дайджеста сообщений SHA (SHA-0) и SHA-1,
дайджест сообщений MDC2. Хеш на основе DES, популярный на смарт-картах.
Открытый ключ
RSA: шифрование/дешифрование/генерация.
Количество бит не ограничено.
DSA: шифрование/дешифрование/генерация.
Количество бит не ограничено.
Diffie-Hellman: обмен ключами/генерация ключей.
Количество бит не ограничено.
Сертификаты X.509v3
Кодирование/декодирование X509 в/из двоичного ASN1 и PEM-
кодирования на основе ASCII-двоичного формата, которое поддерживает шифрование с помощью
закрытого ключа. Программа для генерации запросов на сертификаты RSA и DSA
и для генерации сертификатов RSA и DSA.
Системы
Обычные подпрограммы цифровых конвертов и кодирование base64. Доступ
более высокого уровня к шифрам и дайджестам по имени. Новые шифры могут
загружаться во время выполнения. Система ввода-вывода BIO, представляющая собой простую неблокирующую
абстракцию ввода-вывода. Поддерживаемые методы: файловые дескрипторы,
сокеты, принятие сокетов, подключение сокетов, буфер в памяти, буферизация, SSL
клиент/сервер, файловый указатель, шифрование, дайджест, тестирование без блокировки
и null.
Структуры данных
Динамически расширяемая хеш-система
Простой стек.
Загрузчик конфигурации, использующий формат, похожий на файлы MS .ini.
openssl: Инструмент командной строки, который можно использовать для: Создания параметров ключей RSA, DH и DSA Создания сертификатов X.509, CSR и CRL Вычисления дайджестов сообщений Шифрования и дешифрования с помощью шифров Тестирования SSL/TLS клиента и сервера Обработки подписанной или зашифрованной почты S/MIME
Различные компании владеют различными патентами на различные алгоритмы в различных странах мира. ВЫ несёте ответственность за то, чтобы ваше использование любых алгоритмов было законным, проверив наличие патентов в вашей стране. В этом файле перечислены некоторые патенты, о которых мы знаем или которые, по слухам, существуют. Это не исчерпывающий список.
RSA Security владеет патентами на программное обеспечение для алгоритма RC5. Если вы намерены использовать этот шифр, вы должны связаться с RSA Security для получения условий лицензирования. Их веб-страница: http://www.rsasecurity.com/.
RC4 является товарным знаком RSA Security, поэтому использование этого обозначения, возможно, допустимо только с разрешения RSA Security.
Алгоритм IDEA запатентован компанией Ascom в Австрии, Франции, Германии, Италии, Японии, Нидерландах, Испании, Швеции, Швейцарии, Великобритании и США. С ними следует связаться, если этот алгоритм будет использоваться; их веб-страница: http://www.ascom.ch/.
NTT и Mitsubishi имеют патенты и находящиеся на рассмотрении патентные заявки на алгоритм Camellia, но разрешают использование бесплатно без необходимости явного лицензионного соглашения: http://info.isl.ntt.co.jp/crypt/eng/info/chiteki.html
Чтобы установить этот пакет в Unix-подобной системе, прочтите файл INSTALL. Для платформы Win32 прочтите файл INSTALL.W32. Для систем OpenVMS прочтите INSTALL.VMS.
Прочтите документацию в каталоге doc/. Она довольно грубая, но в ней перечислены функции; вероятно, вам придётся посмотреть в код, чтобы разобраться, как их использовать. Посмотрите на примеры программ.
Для некоторых платформ существуют известные проблемы, которые могут затронуть пользователя или разработчика приложений. Мы стараемся собирать их в doc/PROBLEMS с текущими соображениями о том, как их следует решить в будущем OpenSSL.
См. на веб-сайте OpenSSL www.openssl.org сведения о том, как получить коммерческую техническую поддержку.
Если у вас возникли проблемы с OpenSSL, выполните следующие действия сначала:
- Загрузите текущий снимок с ftp://ftp.openssl.org/snapshot/
чтобы проверить, не решена ли уже эта проблема
- Удалите ASM-версии библиотек
- Уберите флаги оптимизации компилятора
Если вы хотите сообщить об ошибке, включите следующую информацию в любой отчёт об ошибке:
- В системах Unix:
Отчёт самопроверки, созданный командой 'make report'
- В других системах:
Версия OpenSSL: вывод команды 'openssl version -a'
Название ОС, версия, аппаратная платформа
Сведения о компиляторе (название, версия)
- Сведения о приложении (название, версия)
- Описание проблемы (шаги, воспроизводящие проблему, если известны)
- Трассировка стека (если приложение создаёт дамп ядра)
Сообщите об ошибке проекту OpenSSL через Request Tracker (http://www.openssl.org/support/rt.html) по электронной почте:
Обратите внимание, что request tracker НЕ следует использовать для общей помощи или вопросов поддержки. То, что что-то работает не так, как вы ожидаете, не обязательно означает, что это ошибка в OpenSSL.
Обратите внимание, что письма на [email protected] записываются в общедоступную базу данных request tracker и пересылаются в публичный список рассылки. Конфиденциальные письма можно отправлять на [email protected] (ключ PGP доступен на серверах ключей).
Разработка координируется в списке рассылки openssl-dev (см. http://www.openssl.org для получения информации о подписке). Если вы хотите отправить патч, отправьте его на [email protected] с строкой "[PATCH]" в теме письма. Пожалуйста, обязательно включите текстовое объяснение того, что делает ваш патч.
Если вы не уверены, будет ли функция полезна для всего сообщества OpenSSL, сначала обсудите её в списке рассылки openssl-dev. Возможно, кто-то уже работает над тем же, или есть веская причина, по которой эта функция не реализована.
Патчи должны быть как можно более свежими, желательно относительно текущего Git или последнего снимка. Они должны соответствовать стилю кодирования OpenSSL и компилироваться без предупреждений. Некоторые цели разработчиков основной команды можно использовать для тестирования (debug-steve64, debug-geoff и т.д.). OpenSSL компилируется на многих различных платформах: постарайтесь использовать только переносимые возможности.
Примечание: По юридическим причинам вклад из США может быть принят только если уведомление TSU и копия патча отправлены на [email protected] (ранее BXA) с копией координатору запросов на шифрование ENC; пожалуйста, уделите время просмотру http://www.bis.doc.gov/Encryption/PubAvailEncSourceCodeNofify.html [sic] и http://w3.access.gpo.gov/bis/ear/pdf/740.pdf (EAR Section 740.13(e)) для получения подробностей. Если «ваш исходный код шифрования слишком велик, чтобы служить вложением в электронное письмо», они рады получить его по факсу; надеемся, у вас дешёвый тариф на междугороднюю связь.
Наш предпочтительный формат для изменений — вывод "diff -u". Вы можете сгенерировать его так: