Classes Secure Sockets Layer (SSL)

Les classes ci-dessous fournissent un support pour la communication réseau sécurisée en utilisant le protocole Secure Sockets Layer (SSL), en utilisant un backend TLS natif, le Toolkit OpenSSL, ou n'importe quel plugin TLS approprié pour effectuer le cryptage et le traitement du protocole.

Pour les applications Android, voir Adding OpenSSL Support for Android.

Utilisation du chiffrement dans les applications en réseau

Dans la mesure du possible, utilisez le chiffrement lors du transport de données sur un réseau. Le texte brut, c'est-à-dire les données non chiffrées facilement lisibles, expose des données sensibles telles que des informations sur les utilisateurs et sur les systèmes du réseau.

Utilisez QSslSocket::connectToHostEncrypted() pour vous connecter en utilisant le cryptage et vérifiez les problèmes liés à SSL en utilisant QSslSocket::sslHandshakeErrors(). Utilisez QSslSocket::ignoreSslErrors() avec précaution, car il crée des risques de sécurité dans votre application.

Utilisez QSslConfiguration pour renforcer les paramètres de sécurité. Les protocoles pris en charge dépendent du backend SSL et le niveau de risque d'un protocole pourrait changer à l'avenir. Vous pouvez utiliser un protocole plus récent et plus sûr en utilisant QSslConfiguration::setProtocol(). Pour plus d'informations, consultez le site QSsl::SslProtocol pour connaître les protocoles disponibles.

Activation et désactivation de la prise en charge de SSL lors de la construction de Qt à partir des sources

Lors de la construction de Qt à partir des sources, Qt construit des plugins pour les bibliothèques TLS natives qui sont prises en charge par le système d'exploitation pour lequel vous construisez. Pour Windows, il s'agit de Schannel, tandis que pour macOS, il s'agit de Secure Transport.

Sur toutes les plateformes, le système de configuration vérifie la présence de l'en-tête openssl/opensslv.h fourni par les paquets source ou développeur d'OpenSSL. S'il le trouve, il activera et construira le backend OpenSSL pour Qt.

Par défaut, une bibliothèque Qt compatible avec OpenSSL charge dynamiquement toute bibliothèque OpenSSL installée au moment de l'exécution. Toutefois, il est possible d'établir un lien avec la bibliothèque au moment de la compilation en configurant Qt avec l'option -openssl-linked.

Lors de la construction d'une version de Qt liée à OpenSSL, le système de construction de Qt utilisera la commande FindOpenSSL de CMake pour trouver OpenSSL dans plusieurs emplacements standard. Vous pouvez définir la variable CMake OPENSSL_ROOT_DIR pour forcer un emplacement spécifique.

Par exemple :

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

Pour désactiver la prise en charge de SSL dans une version de Qt, configurez Qt avec l'option -no-openssl.

Considérations à prendre en compte lors de l'empaquetage de votre application

Lorsque vous emballez votre application, vous pouvez utiliser un outil comme windeployqt, qui copie tous les plugins des bibliothèques que vous utilisez dans le dossier plugins/. Cependant, pour TLS, vous n'avez besoin que d'un seul backend, et vous pouvez supprimer les autres plugins avant d'empaqueter votre application. Par exemple, si vous êtes sous Windows et que vous n'avez besoin d'aucune des fonctionnalités supplémentaires offertes par le backend OpenSSL, vous pouvez choisir de ne pas expédier le plugin qopensslbackend ainsi que la bibliothèque OpenSSL, et d'expédier simplement le plugin qschannelbackend.

Cependant, l'envoi de plusieurs backends n'est pas un problème. Qt tentera de charger les backends dans l'ordre (avec OpenSSL en premier) jusqu'à ce que l'un d'entre eux soit chargé avec succès. Les autres backends sont alors inutilisés.

Sécurité de la couche de transport du datagramme

Datagram Transport Layer Security (DTLS) est un protocole qui permet de sécuriser les applications basées sur les datagrammes, en les protégeant contre l'écoute, la falsification ou la contrefaçon de messages. Le protocole DTLS est basé sur le protocole TLS (Transport Layer Security) orienté flux. QtNetwork permet l'utilisation de DTLS avec le protocole UDP (User Datagram Protocol), tel que défini par la RFC 6347.

Restrictions à l'importation et à l'exportation

Des restrictions à l'importation et à l'exportation s'appliquent à certains types de logiciels et à certaines régions du monde. Les développeurs qui souhaitent utiliser la communication SSL dans les applications qu'ils déploient doivent s'assurer que leurs utilisateurs disposent des bibliothèques appropriées ou consulter un juriste qualifié pour s'assurer que les applications utilisant le code du projet OpenSSL sont correctement certifiées pour l'importation et l'exportation dans les régions du monde concernées.

Pour plus d'informations, reportez-vous à la section Contrôle de l'exportation du cadre et des outils Qt.