Классы Secure Sockets Layer (SSL)

Нижеприведенные классы обеспечивают поддержку защищенного сетевого взаимодействия с использованием протокола Secure Sockets Layer (SSL), используя родной бэкенд TLS, OpenSSL Toolkit, или любой соответствующий плагин TLS для выполнения шифрования и обработки протоколов.

Начиная с версии Qt 5.15, официально поддерживаемая версия OpenSSL — 1.1.1 или более поздняя.

Включение и отключение поддержки SSL

При построении Qt из исходного кода Qt создает плагины для родных библиотек TLS, которые поддерживаются для операционной системы, для которой вы строите. Для Windows это означает https://docs.microsoft.com/en-us/windows/win32/com/schannel, а для macOS это https://developer.apple.com/documentation/security/secure_transport.

На всех платформах система конфигурации проверяет наличие заголовка openssl/opensslv.h, предоставленного исходными или пакетами разработчиков OpenSSL. Если он найден, будет включен и построен бэкенд OpenSSL для Qt.

По умолчанию OpenSSL-совместимая библиотека Qt динамически загружает любую установленную библиотеку OpenSSL во время выполнения. Однако можно связать библиотеку на этапе компиляции, настроив Qt с помощью опции -openssl-linked.

При построении версии Qt, связанной с OpenSSL, система сборки Qt будет использовать команду FindOpenSSL CMake для поиска OpenSSL в нескольких стандартных расположениях. Вы можете установить переменную CMake OPENSSL_ROOT_DIR, чтобы принудительно указать конкретное расположение.

Например:

configure -openssl-linked -- -D OPENSSL_ROOT_DIR=<openssl_dir>

Чтобы отключить поддержку SSL в сборке Qt, настройте Qt с помощью опции -no-openssl.

Соображения при пакетировании вашего приложения

При пакетировании приложения вы можете запустить инструмент, такой как windeployqt. Он копирует все плагины для используемых библиотек в папку plugins/. Однако для TLS вам нужен только один бэкенд, и вы можете удалить другие плагины перед пакетированием вашего приложения. Например, если вы работаете в Windows и вам не нужны дополнительные возможности бэкенда OpenSSL, вы можете отказаться от отправки плагина qopensslbackend а также библиотеки OpenSSL и просто отправить плагин qschannelbackend.

Однако отправка нескольких бэкендов не является проблемой. Qt будет пытаться загрузить бэкенды в порядке (сначала OpenSSL), пока один не загрузится успешно. Другие бэкенды затем не используются.

Защита транспортного уровня для датаграмм

Защита транспортного уровня для датаграмм (DTLS) — это протокол, который обеспечивает безопасность для приложений, основанных на датаграммах, обеспечивая защиту от перехвата, подмены или подделки сообщений. Протокол DTLS основан на протоколе защиты транспортного уровня (TLS) для потоков. QtNetwork позволяет использовать DTLS с протоколом пользовательских датаграмм (UDP), как определено в RFC 6347.

Ограничения импорта и экспорта

Бинарные установщики Qt включают библиотеки OpenSSL, используемые модулем QtNetwork. Однако они не автоматически развертываются с приложениями, созданными с помощью Qt. Ограничения импорта и экспорта применяются к некоторым типам программного обеспечения и в некоторых регионах мира. Разработчики, желающие использовать SSL-связь в своих развернутых приложениях, должны либо убедиться, что у их пользователей установлены соответствующие библиотеки, либо обратиться к квалифицированному юристу, чтобы убедиться, что приложения, использующие код из проекта OpenSSL, должным образом сертифицированы для импорта и экспорта в соответствующих регионах мира.