Применимо к
Информация | ||
---|---|---|
| ||
Информация | ||
---|---|---|
| ||
|
Введение
OpenSSL — это инструмент защиты данных. Инструмент доступен в Astra Linux по умолчанию. В Astra Linux Special Edition 1.8 используется OpenSSL поколения 3 (версия 3.2). В более ранних обновлениях используется поколение 1.1 (версия 1.1). Узнать знать установленную версию OpenSSL можно командой:
Command |
---|
openssl version |
Информация |
---|
Поддержка OpenSSL 1.1 прекращена в сентябре 2023 года. |
Основные различия поколений OpenSSL 1.1 и OpenSSL 3
Исключение интерактивного режима
В OpenSSL поколение 3 исключен интерактивный режим (режим командной строки). Для выполнения функций, ранее реализуемых в интерактивном режиме, следует использовать опции командной строки.
Новая концепция модульности
В OpenSSL поколение 3
.0.0Информация |
---|
Поддержка OpenSSL 1.1.1 прекращена в сентябре 2023 года. Между версиями отсутствует прямая совместимость. |
OpenSSL 3.0.0 включает в себя множество изменений и улучшений по сравнению с предыдущей версией 1.1.1. Вот несколько различий между ними:
- В состав OpenSSL 3.0.0 включен модуль FIPS, реализующий криптографические алгоритмы, соответствующие стандарту безопасности FIPS 140-2. Нумерация 2.х применяется только к FIPS-модулю в составе OpenSSL, поэтому после 1.1.1 идет версия 3.0.0;
- В библиотеке libcrypto вместо концепции движков (ENGINE API) теперь применяться концепция подключаемых провайдеров (Providers), что обеспечивает большую модульность и гибкость. Подключаемые провайдеры дают возможность подключения библиотек с алгоритмами шифрования,при этом для разных приложений можно указать разные применяемые алгоритмы;
- OpenSSL 3.0.0 имеет новые механизмы безопасности, такие как поддержка стандарта TLS 1.3, усиленные криптографические алгоритмы, обновленные протоколы шифрования и многое другое
- Появилась поддержка протокола управления сертификатами CMP, который позволяет запрашивать сертификаты у сервера удостоверяющего центра. С утилитой openssl-cmp появляется возможность передавать запросы через HTTP/HTTPS.
- Для протоколов HTTP и HTTPS реализован полноценный клиент, поддерживающий методы GET и POST, перенаправление запросов, работу через прокси, кодирование ASN.1 и обработку таймаутов.
Информация о поддержке отечественных алгоритмов шифрования ГОСТ в OpenSSL 3.0.0
Поддержка серии алгоритмов шифрования ГОСТ реализована при помощи внедренной концепции подключаемых провайдеров. Функции для работы с библиотеками алгоритмов ГОСТ по умолчанию доступны в Astra Linux Special Edition.
используется новая концепция подключаемых модулей — провайдеры (providers). Новая концепция является альтернативой интерфейсу для работы с динамически подключаемым модулями (ENGINE API), при этом провайдеры предоставляют более высокоуровневые методы работы (средства сериализации, примитивы, контексты и т.д.). Динамически подгружаемые модули (engine) признаны устаревшими, а их дальнейшая поддержка не гарантируется.
Список провайдеров для OpenSSL поколения 3 доступен по команде:
Command |
---|
openssl list -providers |
Поддержка устаревших встроенных алгоритмов
По умолчанию, алгоритмы инструмента OpenSSL, отмеченные как устаревшие, исключены из состава встроенных алгоритмов и вынесены в отдельный провайдер legacy
. Этот провайдер по умолчанию отключен.
Раскрыть | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Для разового использования устаревшего алгоритма достаточно добавить опцию
Чтобы полностью задействовать устаревшие алгоритмы необходимо подключить провайдер
Проверка работы провайдераПроверить, включена ли поддержка Или выполнив без опции
Где |
Основной перечень функциональных различий между версиями OpenSSL 1.1.1 и 3.0.0
- Добавлены:
- новые опции для
openssl list
(список доступен по командеopenssl list -commands
); - руководство по переходу к новой версии в раздел
man(7)
документации разработчиков OpenSSL; - функция
OPENSSL_info()
и команда openssl info для получения встроенной справки; - поддержка подключаемых групп протокола
TLSv1.3;
- поддержка Kernel TLS (KTLS) - обработки данных для протокола TLS на уровне ядра;
- функции для генерации асимметричных пар ключей;
OSSL_LIB_CTX
, контекст библиотеки libcrypto для менеджеров контекстов;- новые функции для поддержки структур
OSSL_LIB_CTX в OpenSSL API;
- алгоритмы X25519, X448, Ed25519, Ed448, SHAKE128 и SHAKE256 включены в состав FIPS-провайдеров;
- полноценный HTTP/HTTPS-клиент, поддерживающий:
- методы
GET и POST;
- произвольные типы содержимого запросов и ответов
- TLS;
- соединения через HTTP-прокси;
- соединения и обмен данными через пользовательский BIOs (разрешающий неявные соединения) и обработку таймаутов.
- методы
- инструмент
util/check-format.pl
для проверки соблюдения правил безопасности при разработке приложений; - методы
OSSL_ENCODER
иOSSL_DECODER
для операций по защите данных и работающие через API; - структура
OSSL_PARAM_BLD
, облегчающая работу сAPI OSSL_PARAM;
- макросы
ERR_raise() и ERR_raise_data()
для работы с ошибками; - функция
OSSL_PROVIDER_available()
для проверки доступности провайдера; - команда
openssl mac
, использующая API EVP_MAC; - команда
openssl kdf
, которая использует API EVP_KDF; - поддержка инструментов для трассировки и вывода данных отладки;
- интерфейс хэш-функций
EVP_MAC
. Поддерживаются следующие функции: BLAKE2, CMAC, GMAC, HMAC, KMAC, POLY1305 и SIPHASH; - интерфейс формирования ключей
EVP_KDF
. Поддерживаются следующие функции формирования ключа: HKDF, KBKDF, KRB5 KDF, PBKDF2, PKCS12 KDF, SCRYPT, SSH KDF, SSKDF, TLS1 PRF, X9.42 KDF и X9.63 KDF; - поддержка протокола управления сертификатами CMP, позволяющая запрашивать сертификаты у удостоверяющего центра через HTTP/HTTPS (инструмент
openssl-cmp);
- новые опции для
- Для TLS по умолчанию установлен уровень безопасности 1, при этом запрещено использование сертификатов X509, подписанных с использованием SHA1 (такие сертификаты не проходят проверку подлинности);
- Включены инструменты отладки
enable-crypto-debug
иenable-crypto-debug-backtrace
, применяется очистка адресов и обнаружение утечек; - Удалены:
- интерактивный режим утилиты
openssl;
- интерфейс
RAND_DRBG API;
- интерактивный режим утилиты
- Отмечены как устаревшие:
- Типы и функции:
OCSP_REQ_CTX;
EC_KEY
иEC_KEY_METHOD;
RSA
иRSA_METHOD, DSA
иDSA_METHOD;
DH
иDH_METHOD, ERR_load;
ERR_put_error();
ERR_get_error_line();
ERR_get_error_line_data();
ERR_peek_error_line_data();
ERR_peek_last_error_line_data() и ERR_func_error_string()
;- все низкоуровневые хэш-функции алгоритмов MD2, MD4, MD5, MDC2, RIPEMD 160, SHA1, SHA224, SHA256, SHA384, SHA512 и Whirlpool;
- все низкоуровневые функции защитного преобразования для алгоритмов AES, Blowfish, Camellia, CAST, DES, IDEA, RC2, RC4, RC5 и SEED;
- хэш-функции EVP: MD2, MD4, MDC2, WHIRLPOOL и RIPEMD-160;
- все низкоуровневые функции генерации открытого ключа для алгоритмов DH, DSA, ECDH, ECDSA и RSA . Протоколы SSL 3, TLS 1.0, TLS 1.1 и DTLS 1.0 работают только на уровне безопасности 0, за исключением случаев, когда используется обмен ключами RSA без SHA1;
интерфейс ENGINE API (EVP — высокоуровневый API для работы с алгоритмами защитного преобразования данных, работающий без привязки к их конкретным реализациям);
Информация EVP — высокоуровневый API для работы с алгоритмами защитного преобразования данных, работающий без привязки к их конкретным реализациям
- все варианты EVP-защитного преобразования алгоритмов CAST5, BF, IDEA, SEED, RC2, RC4, RC5 и DES.
- Типы и функции:
- Лицензия Apache обновлена до v2.0;
Различия версий 3.0.0 и 3.1.0
- Добавлены:
- параметр конфигурации провайдера FIPS для принудительной проверки EMS во время выполнения KDF TLS1_PRF. Для проверки к команде
openssl fipsinstall необходимо добавить параметр -ems-check;
- поддержка алгоритма KMAC (KECCAK Message Authentication Code) в функцию
KBKDF
(Key Based Key Derivation Function);
- параметр конфигурации провайдера FIPS для принудительной проверки EMS во время выполнения KDF TLS1_PRF. Для проверки к команде
- провайдер FIPS включает в себя алгоритмы 3DES в режиме ECB, CBC и Adds для обеспечения обратной совместимости с прошлыми версиями OpenSSL. Использование алгоритмов в операциях указывается опцией
fips=yes;
- поддержка провайдерами инструкции RNDR и регистров RNDRRS для ARM-архитектуры (aarch64) при генерации случайных чисел;
команды s_client
иs_server
теперь сообщают, когда версия TLS не включает механизм повторного согласования, что позволяет избежать ошибок при работе с TLS и повторном согласовании в начале сеанса связи;- поддержка AES-GCM с помощью инструкций AVX 512 vAES и vPCLMULQDQ;
- параллельное двухпроцессорное 1536/2048-разрядное модульное возведение в степень для процессоров с поддержкой AVX512_IFMA;
- начиная с версии OpenSSL 3.1 отмечены как устаревшие начиная и могут быть отключены путем определения макроса
OPENSSL_NO_DEPRECATED_3_1 следующие функции
:OPENSSL_LH_stats;
OPENSSL_LH_node_stats;
OPENSSL_LH_node_usage_stats;
OPENSSL_LH_stats_bio;
OPENSSL_LH_node_stats_bio;
OPENSSL_LH_node_usage_stats_bio;
- Макрос
DEFINE_LHASH_OF
заменен наDEFINE_LHASH_OF_EX;
Для подписей PKCS#1 RSASSA-PSS длина значения параметра
salt
может изменяться до максимальной, чтобы соответствовать FIPS 186-4. Чтобы использовать максимальную длину нужно присвоить значениеOSSL_PKEY_RSA_PSS_SALT_LEN_AUTO_DIGEST_MAX
для параметраrsa_pss_saltlen
Информация Параметр salt определяет длину входной строки, передающейся вместе с преобразуемыми данными в хэш-функцию
Различия версий 3.1.0 и 3.2.0
- Добавлены:
- поддержка настраиваемой длины выходных данных путем установки параметра
size в алгоритм хеширования BLAKE2b;
- возможность удаления объектов из хранилища с помощью метода
OUR-LOCAL_STORE_delete()
и соответствующей функции API провайдера-хранилищаmgmt OSSL_FUNC_store_delete()
; - функция
OSSL_FUNC_store_open_ex() в API провайдера-хранилища mgmt
для передачи обратного вызова ключевой фразы при открытии хранилища; - поддержка на стороне клиента для QUICK;
- дополнительная опция
saltlen
, позволяющая изменить значение параметраsalt
не должно быть задано по умолчанию в утилитеopenssl
для параметровpkcs8
иenc;
- поддержка алгоритма SHA256/192;
- поддержка безопасного получения обновления сертификата корневого центра сертификации в CMP;
- функция
SSL_get 0_group_name()
для предоставления доступа к имени группы, используемой для обмена ключами TLS; - конфигурационные опции
no-http
для принудительного отключения поддержки HTTP,no-apps
иno-docs,
чтобы отключить использование приложений командной строки для утилиты openssl и вывод документации; - конфигурационная опция
no-necks
, которая отключает поддержку кривых X25519, X448 и EdDSA; - функции провайдера
OSSL_FUNC_key mgmt_im/export_types_ex()
, которые получают контекст провайдера в качестве параметра; - функцияв библиотеке
ssl_lib
SSL_get_handshake_rtt,
позволяющая вычислять время доставки пакетов для протокола TLS; - расширенный командный режим для команды s_client (параметр “-adv”);
- опция
-quic
в командеs_client
разрешающая подключение к серверам QUIC (требуется использование расширения ALPN протокола TLS с помощью опции-alpn);
- поддержка необработанного открытого ключа (RFC7250);
- функция
EC_GROUP_to_params()
, которая создает массивSSL_PARAM
из заданнойEC_GROUP;
- добавлена функция
OSSL_sleep()
, не зависящая от платформы; - поддержка подключаемых (на основе провайдера) алгоритмов подписи TLS, что позволяет выполнять операции аутентификации по протоколу TLS 1.3 с использованием алгоритмов, по умолчанию не включенных в OpenSSL;
- поддержка подключаемых (на основе провайдера) алгоритмов подписи CMS, что позволяет CMS подписывать и проверять операции с помощью алгоритмов, которые по умолчанию не включены в OpenSSL;
- поддержка гибридного защитного преобразования с открытым ключом (HPKE);
- поддержка сжатия сертификатов (RFC8879), включая библиотеки для сжатия Brotli и Zstandard;
- возможность указывать пользовательские атрибуты к файлам стандарта PKCS#12;
- API метод
PKCS12_create_ex2
, идентичный существующемуPKCS12_create_ex
, но допускающий заданный пользователем обратных вызовов; KCS12_SAFEBAG_set_0_attr
, позволяющий добавлять новые значения переменнойattr
к существующему стекуSTACK_OF attrs;
- опция определения длины параметра
salt
для стандарта PKCS#12; - дополнительные профили защиты SRTP из RFC8723 и RFC8269;
- поддержка механизма TCP Fast Open для (RFC7413), что позволяет передавать данные в пакетах SYN и SYN-ACK;
- наборы для защитного преобразования на основе DHE_PSK (RFC 4279) и ECDHE_PSK (RFC 5489);
- новые API-интерфейсы SSL для работы с отпечатками TLS/SSL;
- поддержка Bignum-значений в API OSSL_PARAM;
- проверка ключей для X.509 при подписании разрабатываемого кода в соответствии с требованиями добровольной сертификации CA/Browser Forum;
- новые методы
BIO_sendmmsg()
иBIO_recvmmsg()
для работы с защищенными потоками BIO, которые позволяют отправлять и получать несколько сообщений за один вызов. (подробности доступны вBIO_sendmmsg(3)
); - функции BIO_s_dgram_pair() и BIO_s_dgram_mem() для поддержки работы c памятью в защищенных потоках BIO и корректной работы методов BIO_sendmmsg() и BIO_recvmmsg();
- поддержка кривых Brainpool в TLS-1.3;
- поддержка функций формирования ключа по алгоритмам Argon2d, Argon2i, Argon2id KDFs, а также базовая реализация пула потоков для некоторых платформ;
- возможность использования готовых наборов чисел в процессе защитного преобразования в функциях CMS API и с помощью параметра -digest для утилиты openssl;
- реализация эллиптической кривой secp384r1 с использованием редукции для повышения скорости работы некоторых алгоритмов (параметр сборки
enable-ec_nistp_64_gcc_128);
- поддержка всех пяти экземпляров схем цифровой подписи EdDSA из RFC8032: Ed25519, Ed25519 ctx, Ed25519ph, Ed448 и Ed448ph (потоковая передача пока не поддерживается для вариантов HashEdDSA (Ed25519ph и Ed448ph));
- поддержка процессорных инструкций
SM4-XTS;
- поддержка детерминированных подписей ECDSA (RFC6979);
- поддержка алгоритма AES-GCM-SIV (RFC8452);
- поддержка HPKE DHKEM у провайдеров, используемых точкой доступа HPKE (RFC9180);
- новая опция настройки
no-sm2-precomp
для отключения предварительно вычисленной таблицы для оптимизации алгоритма SM2 вaarch64;
- поддержка файлов PKCS12 без MAC в функции
PKCS12_parse()
;
- поддержка настраиваемой длины выходных данных путем установки параметра
- изменена длина параметра
salt
по умолчанию, используемая файлами PBES2 KDF (PBKDF2 и scrypt), с 8 байт до 16 байт:- в стандарте PKCS#5 (RFC 8018):
- для PBE используется длина записи в 64 байта;
- для PBES2 рекомендуется использовать минимум 64 бита;
- для соответствия требованиям FIPS в PBKDF2 требуется длина записи в 128 бит, что влияет на параметры утилиты
openssl
, такие какgenrsa и pkcs8
, так же на методы API, такие какPM_write_bio_Private Key()
, зависящие от значения по умолчанию;
- в стандарте PKCS#5 (RFC 8018):
- изменено значение параметра конфигурации ess_cert_id_alg по умолчанию, которое используется для вычисления идентификатора сертификата открытого ключа TSA. Алгоритм по умолчанию обновлен до SHA256 вместо SHA1;
- при использовании команды
openssl x509
для проверки атрибутов сертификата когда проверка завершается неудачей возвращается код завершения с описанием ошибки; - уровень безопасности SSL/TLS по умолчанию был изменен с 1 на 2. Ключи RSA, DSA и DH менее 2048 бит, а также ключи ECC менее 224 бит больше не применимы;
- функции семейства
SSL_CTX_set_cipher_list
определяют защитное преобразование, используя имена стандарта IANA; - функция получения ключа
PVK
была перенесена из b2i_PVK_bio_ex() в отдельный криптографический провайдер в качестве EVP_KDF. Приложения, которым требуется этот KDF, должны будут загружать устаревший криптографический провайдер; - наборы алгоритмов защитного преобразования с режимом CCM 8 в TLS были понижены до нулевого уровня безопасности;
- имена в X.509 теперь по умолчанию отображаются в виде строк UTF-8;
- приложения
x509, ca и req
теперь выдают сертификаты X.509 v3. Опция-x509v1
вreq
поддерживает генерацию сертификатов X.509 v1; - функции
X509_sign()
иX509_sign_ctx()
, проверяют, имеет ли сертификат X.509 версию 3, если информация о сертификате содержит упоминания X.509; - API CMS расширен методами
CMS_SignedData
иCMS_EnvelopedData
для обработки данных; - функции
CMS_add0_cert()
иCMS_add1_cert()
не выдают ошибку, если добавляемый сертификат уже присутствует; - функции
CMS_sign_ex()
иCMS_sign()
игнорируют любые повторяющиеся сертификаты в аргументахcerts;
- для протокола TLS 1.3 в режиме CCM включена поддержка KTLS (kernel TLS) - защитного преобразования на уровне ядра. Актуально для релизов ядра Linux 5.4.164, 5.10.84, 5.15.7 и любых последующих версий новее 5.16;
- для команд
s_server
иs_client
доступна опция-ktls
, которая включает поддержку технологии KTLS; - поддержка функции
KTLS sendfile()
для технологии Linux Zero-Copy; - вызовы
OBJ_
теперь потокобезопасны и используют глобальную блокировку; - функция OPENSSL_malloc() и другие функции распределения теперь генерируют ошибки при сбоях;
- в качестве защитных мер от уязвимости CVE-2020-25659 при использовании алгоритма RSA стандарта PKCS#1 версии 1.5 в случае ошибки в процессе обратного защитного преобразования не будет выводиться сообщение об ошибке с подробностями о производимой операции.
Поддержка отечественных алгоритмов защитного преобразования ГОСТ
OpenSSL 1.1
Поддержка серии алгоритмов защитного преобразования ГОСТ реализована при помощи пакета libgost-astra, предоставляющего модуль (engine) поддержки алгоритмов ГОСТ.
При установленном пакете libgost-astra перечень поддерживаемых алгоритмов ГОСТ доступен по команде:
Command |
---|
openssl engine gost -c |
OpenSSL 3
Поддержка серии алгоритмов защитного преобразования ГОСТ реализована при помощи пакета libgost-astra, адаптированного для работы с OpenSSL поколение 3 и предоставляющего модуль (engine) и провайдер (provider) поддержки алгоритмов ГОСТ.
При установленном пакете libgost-astra перечень Перечень поддерживаемых алгоритмов ГОСТ доступен по команде:
Command |
---|
openssl engine engine gost -c |
Сроки поддержки версий OpenSSL разработчиками OpenSSL
Версия OpenSSL | Совместимость OpenSSL с прошлыми версиями | Дата релиза версии OpenSSL | Дата окончания поддержки OpenSSL разработчиками инструмента |
---|---|---|---|
1.1.1 | совместима | 11 сентября 2018 | 11 сентября 2023 |
3.0.0 | частично | 7 сентября 2021 | 7 сентября 2026 |
3.1.0 | совместима | 14 марта 2023 | 14 марта 2025 |
3.2.0 |
Информация о поддержке версий
совместима | 23 ноября 2023 | 23 ноября 2025 |