Clases de Secure Sockets Layer (SSL)
Las clases que se indican a continuación ofrecen soporte para la comunicación de red segura mediante el protocolo Secure Sockets Layer (SSL), utilizando un backend TLS nativo, el kit de herramientas OpenSSL o cualquier complemento TLS adecuado para llevar a cabo el cifrado y la gestión del protocolo.
Esta clase proporciona cifrado para sockets UDP | |
Esta clase implementa la generación y verificación de cookies DTLS por parte del servidor | |
Esta clase define los parámetros para el generador de cookies DTLS | |
Esta clase representa la respuesta del Protocolo de estado de certificados en línea (OCSP) | |
Declara enumeraciones comunes a todas las clases SSL en Qt Network | |
API práctica para un certificado X509 | |
API para acceder a las extensiones de un certificado X509 | |
Representa un cifrado criptográfico SSL | |
Almacena la configuración y el estado de una conexión SSL | |
Interfaz para los parámetros de Diffie-Hellman para servidores | |
Representa una curva elíptica para su uso en algoritmos de cifrado de curva elíptica | |
Error de SSL | |
Interfaz para claves privadas y públicas | |
Describe el material de clave exportado derivado de una sesión TLS | |
Datos de autenticación para conjuntos de cifrado con claves precompartidas (PSK) | |
Implementa un servidor TCP cifrado y seguro sobre TLS | |
Socket cifrado mediante SSL tanto para clientes como para servidores | |
Describe el nivel de un mensaje de alerta | |
Enumera los posibles códigos que puede tener un mensaje de alerta | |
Describe el estado actual del protocolo de establecimiento de conexión DTLS | |
Enumera las clases que implementa un backend TLS | |
Describe los errores que pueden detectar QDtls y QDtlsClientVerifier | |
Describe el estado de los certificados en línea | |
Describe el motivo de la revocación | |
Enumera las posibles características que admite un backend TLS |
Para aplicaciones de Android, consulta «Añadir compatibilidad con OpenSSL para Android».
Uso del cifrado en aplicaciones en red
Utilice el cifrado siempre que sea posible al transportar datos por cualquier red. El texto sin cifrar, es decir, los datos sin cifrar que se pueden leer fácilmente, expone información confidencial, como los datos de los usuarios y la información sobre los sistemas de red.
Utilice QSslSocket::connectToHostEncrypted() para conectarse mediante cifrado y compruebe si hay problemas de SSL con QSslSocket::sslHandshakeErrors(). Utilice QSslSocket::ignoreSslErrors() con precaución, ya que puede generar riesgos de seguridad en su aplicación.
Utilice QSslConfiguration para aplicar una configuración de seguridad sólida. Los protocolos compatibles dependen del backend SSL y el nivel de riesgo de un protocolo podría cambiar en el futuro. Puede utilizar un protocolo más nuevo y seguro mediante QSslConfiguration::setProtocol(). Para obtener más información, consulte QSsl::SslProtocol para conocer los protocolos disponibles.
Activación y desactivación de la compatibilidad con SSL al compilar Qt desde el código fuente
Al compilar Qt desde el código fuente, Qt genera complementos para las bibliotecas TLS nativas compatibles con el sistema operativo para el que se está realizando la compilación. En el caso de Windows, se trata de Schannel, mientras que en macOS es Secure Transport.
En todas las plataformas, el sistema de configuración comprueba la presencia del encabezado ` openssl/opensslv.h `, proporcionado por los paquetes fuente o de desarrollador de OpenSSL. Si lo encuentra, habilitará y compilará el backend de OpenSSL para Qt.
Nota: Aunque Qt sigue siendo compatible con la versión anterior de OpenSSL 1.1.1 cuando se compila a partir del código fuente, las compilaciones de Qt en el Qt Online Installer requieren OpenSSL 3 en tiempo de ejecución.
Por defecto, una biblioteca Qt con OpenSSL habilitado carga dinámicamente cualquier biblioteca OpenSSL instalada en tiempo de ejecución. Sin embargo, es posible vincularla en tiempo de compilación configurando Qt con la opción « -openssl-linked ».
Al compilar una versión de Qt enlazada con OpenSSL, el sistema de compilación de Qt utilizará el comando « FindOpenSSL » de CMake para buscar OpenSSL en varias ubicaciones estándar. Puedes establecer la variable de CMake OPENSSL_ROOT_DIR para forzar una ubicación específica.
Por ejemplo:
configure -openssl-linked -- -D OPENSSL_ROOT_DIR=<openssl_dir>Para desactivar la compatibilidad con SSL en una compilación de Qt, configura Qt con la opción « -no-openssl ».
Consideraciones a la hora de empaquetar tu aplicación
Al empaquetar tu aplicación, es posible que utilices una herramienta como windeployqt. Esta herramienta copia todos los complementos de las bibliotecas que utilizas a la carpeta « plugins/ ». Sin embargo, para TLS solo necesitas un backend, por lo que puedes eliminar los demás complementos antes de empaquetar tu aplicación. Por ejemplo, si utilizas Windows y no necesitas ninguna de las funciones adicionales que ofrece el backend de OpenSSL, puedes optar por no incluir el complemento qopensslbackend ni la biblioteca OpenSSL, y limitarte a incluir el complemento qschannelbackend.
Sin embargo, incluir varios backends no supone ningún problema. Qt intentará cargar los backends por orden (empezando por OpenSSL) hasta que uno se cargue correctamente. Los demás backends quedarán entonces sin utilizar.
Seguridad de la capa de transporte de datagramas
La Seguridad de la Capa de Transporte de Datagramas (DTLS) es un protocolo que garantiza la seguridad de las aplicaciones basadas en datagramas, proporcionándoles protección contra el espionaje, la manipulación o la falsificación de mensajes. El protocolo DTLS se basa en el protocolo de seguridad de la capa de transporte (TLS) orientado a flujos. QtNetwork permite el uso de DTLS con el protocolo de datagramas de usuario (UDP), tal y como se define en el RFC 6347.
Restricciones de importación y exportación
Se aplican restricciones de importación y exportación a determinados tipos de software y en algunas partes del mundo. Los desarrolladores que deseen utilizar la comunicación SSL en sus aplicaciones desplegadas deben asegurarse de que sus usuarios tengan instaladas las bibliotecas adecuadas, o bien consultar a un profesional jurídico debidamente cualificado para garantizar que las aplicaciones que utilizan código del proyecto OpenSSL cuenten con la certificación adecuada para su importación y exportación en las regiones pertinentes del mundo.
Consulte «Control de exportaciones del marco y las herramientas de Qt » para obtener más información.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.