En esta página

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.

QDtls

Esta clase proporciona cifrado para sockets UDP

QDtlsClientVerifier

Esta clase implementa la generación y verificación de cookies DTLS por parte del servidor

QDtlsClientVerifier::GeneratorParameters

Esta clase define los parámetros para el generador de cookies DTLS

QOcspResponse

Esta clase representa la respuesta del Protocolo de estado de certificados en línea (OCSP)

QSsl

Declara enumeraciones comunes a todas las clases SSL en Qt Network

QSslCertificate

API práctica para un certificado X509

QSslCertificateExtension

API para acceder a las extensiones de un certificado X509

QSslCipher

Representa un cifrado criptográfico SSL

QSslConfiguration

Almacena la configuración y el estado de una conexión SSL

QSslDiffieHellmanParameters

Interfaz para los parámetros de Diffie-Hellman para servidores

QSslEllipticCurve

Representa una curva elíptica para su uso en algoritmos de cifrado de curva elíptica

QSslError

Error de SSL

QSslKey

Interfaz para claves privadas y públicas

QSslKeyingMaterial

Describe el material de clave exportado derivado de una sesión TLS

QSslPreSharedKeyAuthenticator

Datos de autenticación para conjuntos de cifrado con claves precompartidas (PSK)

QSslServer

Implementa un servidor TCP cifrado y seguro sobre TLS

QSslSocket

Socket cifrado mediante SSL tanto para clientes como para servidores

QSslSocket::AlertLevel

Describe el nivel de un mensaje de alerta

QSslSocket::AlertType

Enumera los posibles códigos que puede tener un mensaje de alerta

QDtls::HandshakeState

Describe el estado actual del protocolo de establecimiento de conexión DTLS

QSslSocket::ImplementedClass

Enumera las clases que implementa un backend TLS

QDtls::QDtlsError

Describe los errores que pueden detectar QDtls y QDtlsClientVerifier

QOcspResponse::QOcspCertificateStatus

Describe el estado de los certificados en línea

QOcspResponse::QOcspRevocationReason

Describe el motivo de la revocación

QSslSocket::SupportedFeature

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.