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

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

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

QDtls	Этот класс обеспечивает шифрование для сокетов UDP
QDtlsClientVerifier	Этот класс реализует генерацию и проверку куки DTLS на стороне сервера
QDtlsClientVerifier::GeneratorParameters	Этот класс определяет параметры генератора куки DTLS
QOcspResponse	Этот класс представляет собой ответ протокола Online Certificate Status Protocol
QSsl	Объявляет перечисления, общие для всех классов SSL в Qt Network
QSslCertificate	Удобный API для сертификата X509
QSslCertificateExtension	API для доступа к расширениям сертификата X509
QSslCipher	Представляет собой криптографический шифр SSL
QSslConfiguration	Содержит конфигурацию и состояние соединения SSL
QSslDiffieHellmanParameters	Интерфейс для параметров Diffie-Hellman для серверов
QSslEllipticCurve	Представляет эллиптическую кривую для использования алгоритмами шифрования с эллиптической кривой
QSslError	Ошибка SSL
QSslKey	Интерфейс для закрытых и открытых ключей
QSslPreSharedKeyAuthenticator	Данные аутентификации для шифров с предварительно объявленными ключами (PSK)
QSslSocket	SSL-шифрованный сокет для клиентов и серверов
QSslSocket::AlertLevel	Описание уровня сообщения об ошибке
QSslSocket::AlertType	Перечисление возможных кодов, которые может иметь сообщение об ошибке
QDtls::HandshakeState	Описание текущего состояния рукопожатия DTLS
QSslSocket::ImplementedClass	Перечисление классов, которые реализует бэкенд TLS
QDtls::QDtlsError	Описание ошибок, которые могут быть обнаружены QDtls и QDtlsClientVerifier
QOcspResponse::QOcspCertificateStatus	Описание состояния сертификата Online Certificate Status
QOcspResponse::QOcspRevocationReason	Описание причины аннулирования
QSslSocket::SupportedFeature	Перечисление возможных функций, которые поддерживает бэкенд TLS

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

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

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

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

Например:

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

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

Безопасность транспортного уровня для датаграмм

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

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

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