
Универсальная криптографическая библиотека, реализующая протоколы SSL/TLS, симметричные/асимметричные шифры, дайджесты сообщений и управление сертификатами X.509 для безопасной связи.
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 от 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
Кодирование/декодирование X.509 в/из двоичного ASN1 и PEM,
основанного на ASCII-двоичном кодировании, поддерживающего шифрование с помощью
закрытого ключа. Программа для генерации запросов сертификатов RSA и DSA
и для генерации сертификатов RSA и DSA.
Системы
Обычные подпрограммы цифровых конвертов и кодирование base64.
Доступ более высокого уровня к шифрам и дайджестам по имени. Новые шифры можно
загружать во время выполнения. Система ввода-вывода BIO — простая неблокирующая
абстракция ввода-вывода. Поддерживаемые методы: файловые дескрипторы,
сокеты, accept сокета, connect сокета, буфер в памяти, буферизация, 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". Вы можете сгенерировать его следующим образом: