En esta página

QSsl Namespace

El espacio de nombres QSsl declara las enumeraciones comunes a todas las clases SSL en Qt Network. Más información...

Cabecera: #include <QSsl>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

Tipos

(since 6.0) enum class AlertLevel { Warning, Fatal, Unknown }
(since 6.0) enum class AlertType { CloseNotify, UnexpectedMessage, BadRecordMac, RecordOverflow, DecompressionFailure, …, UnknownAlertMessage }
enum AlternativeNameEntryType { EmailEntry, DnsEntry, IpAddressEntry }
enum EncodingFormat { Pem, Der }
(since 6.1) enum class ImplementedClass { Key, Certificate, Socket, DiffieHellman, EllipticCurve, …, DtlsCookie }
enum KeyAlgorithm { MlDsa, Rsa, Dsa, Ec, Dh, Opaque }
enum KeyType { PrivateKey, PublicKey }
enum SslOption { SslOptionDisableEmptyFragments, SslOptionDisableSessionTickets, SslOptionDisableCompression, SslOptionDisableServerNameIndication, SslOptionDisableLegacyRenegotiation, …, SslOptionDisableServerCipherPreference }
flags SslOptions
enum SslProtocol { TlsV1_0, TlsV1_0OrLater, TlsV1_1, TlsV1_1OrLater, TlsV1_2, …, SecureProtocols }
(since 6.1) enum class SupportedFeature { CertificateVerification, ClientSideAlpn, ServerSideAlpn, Ocsp, Psk, …, Alerts }

Descripción detallada

Documentación del tipo

[since 6.0] enum class AlertLevel

Describe el nivel de un mensaje de alerta

Esta enumeración describe el nivel de un mensaje de alerta que se ha enviado o recibido.

ConstanteValorDescripción
QSslSocket::AlertLevel::Warning0Mensaje de alerta no crítico
QSslSocket::AlertLevel::Fatal1Mensaje de alerta grave; el backend subyacente gestionará dicha alerta adecuadamente y cerrará la conexión.
QSslSocket::AlertLevel::Unknown2Una alerta de gravedad desconocida.

Esta enumeración se introdujo en Qt 6.0.

[since 6.0] enum class AlertType

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

Consulte la sección 6 del RFC 8446 para conocer los posibles valores y su significado.

ConstanteValorDescripción
QSslSocket::AlertType::CloseNotify0,
QSslSocket::AlertType::UnexpectedMessage10 
QSslSocket::AlertType::BadRecordMac20 
QSslSocket::AlertType::RecordOverflow22 
QSslSocket::AlertType::DecompressionFailure30 
QSslSocket::AlertType::HandshakeFailure40 
QSslSocket::AlertType::NoCertificate41 
QSslSocket::AlertType::BadCertificate42 
QSslSocket::AlertType::UnsupportedCertificate43 
QSslSocket::AlertType::CertificateRevoked44 
QSslSocket::AlertType::CertificateExpired45 
QSslSocket::AlertType::CertificateUnknown46 
QSslSocket::AlertType::IllegalParameter47 
QSslSocket::AlertType::UnknownCa48 
QSslSocket::AlertType::AccessDenied49 
QSslSocket::AlertType::DecodeError50 
QSslSocket::AlertType::DecryptError51 
QSslSocket::AlertType::ExportRestriction60 
QSslSocket::AlertType::ProtocolVersion70 
QSslSocket::AlertType::InsufficientSecurity71 
QSslSocket::AlertType::InternalError80 
QSslSocket::AlertType::InappropriateFallback86 
QSslSocket::AlertType::UserCancelled90 
QSslSocket::AlertType::NoRenegotiation100 
QSslSocket::AlertType::MissingExtension109 
QSslSocket::AlertType::UnsupportedExtension110 
QSslSocket::AlertType::CertificateUnobtainable111 
QSslSocket::AlertType::UnrecognizedName112 
QSslSocket::AlertType::BadCertificateStatusResponse113 
QSslSocket::AlertType::BadCertificateHashValue114 
QSslSocket::AlertType::UnknownPskIdentity115 
QSslSocket::AlertType::CertificateRequired116 
QSslSocket::AlertType::NoApplicationProtocol120 
QSslSocket::AlertType::UnknownAlertMessage255 

Esta enumeración se introdujo en Qt 6.0.

enum QSsl::AlternativeNameEntryType

Describe los tipos clave para las entradas de nombres alternativos en QSslCertificate.

ConstanteValorDescripción
QSsl::EmailEntry0Una entrada de correo electrónico; la entrada contiene una dirección de correo electrónico para la que es válido el certificado.
QSsl::DnsEntry1Una entrada de nombre de host DNS; la entrada contiene un nombre de host para el que es válido el certificado. La entrada puede contener comodines.
QSsl::IpAddressEntry2Una entrada de dirección IP; la entrada contiene una dirección IP para la que es válido el certificado, introducida en Qt 5.13.

Véase también QSslCertificate::subjectAlternativeNames().

enum QSsl::EncodingFormat

Describe los formatos de codificación compatibles con los certificados y las claves.

ConstanteValorDescripción
QSsl::Pem0El formato PEM.
QSsl::Der1El formato DER.

[since 6.1] enum class ImplementedClass

Enumera las clases que implementa un backend de TLS

En QtNetwork, algunas clases tienen una implementación específica del backend y, por lo tanto, pueden dejarse sin implementar. Los elementos de esta enumeración indican qué clases cuentan con una implementación funcional en el backend.

ConstanteValorDescripción
QSslSocket::ImplementedClass::Key0Clase QSslKey.
QSslSocket::ImplementedClass::Certificate1Clase QSslCertificate.
QSslSocket::ImplementedClass::Socket2Clase « QSslSocket ».
QSslSocket::ImplementedClass::DiffieHellman3Clase « QSslDiffieHellmanParameters ».
QSslSocket::ImplementedClass::EllipticCurve4Clase « QSslEllipticCurve ».
QSslSocket::ImplementedClass::Dtls5Clase « QDtls ».
QSslSocket::ImplementedClass::DtlsCookie6Clase « QDtlsClientVerifier ».

Esta enumeración se introdujo en Qt 6.1.

enum QSsl::KeyAlgorithm

Describe los diferentes algoritmos de clave compatibles con QSslKey.

ConstanteValorDescripción
QSsl::MlDsa5El algoritmo ML-DSA.
QSsl::Rsa1El algoritmo RSA.
QSsl::Dsa2El algoritmo DSA.
QSsl::Ec3El algoritmo de curva elíptica.
QSsl::Dh4El algoritmo de Diffie-Hellman.
QSsl::Opaque0Una clave que debe ser tratada como una «caja negra» por QSslKey.

La función de clave opaca permite a las aplicaciones añadir compatibilidad con funciones como PKCS#11 que Qt no ofrece actualmente de forma nativa.

enum QSsl::KeyType

Describe los dos tipos de claves que admite QSslKey.

ConstanteValorDescripción
QSsl::PrivateKey0Una clave privada.
QSsl::PublicKey1Una clave pública.

enum QSsl::SslOption
flags QSsl::SslOptions

Describe las opciones que se pueden utilizar para controlar los detalles del comportamiento de SSL. Estas opciones se suelen utilizar para desactivar ciertas funciones con el fin de sortear los problemas de servidores defectuosos.

ConstanteValorDescripción
QSsl::SslOptionDisableEmptyFragments0x01Desactiva la inserción de fragmentos vacíos en los datos cuando se utilizan cifrados por bloques. Cuando está activada, esta opción previene algunos ataques (como el ataque BEAST); sin embargo, es incompatible con algunos servidores.
QSsl::SslOptionDisableSessionTickets0x02Desactiva la extensión de ticket de sesión SSL. Esto puede ralentizar el establecimiento de la conexión; sin embargo, algunos servidores no son compatibles con esta extensión.
QSsl::SslOptionDisableCompression0x04Desactiva la extensión de compresión SSL. Cuando está activada, permite comprimir los datos que se transmiten a través de SSL; sin embargo, algunos servidores no son compatibles con esta extensión.
QSsl::SslOptionDisableServerNameIndication0x08Desactiva la extensión de indicación del nombre del servidor SSL. Cuando está activada, indica al servidor el host virtual al que se está accediendo, lo que le permite responder con el certificado correcto.
QSsl::SslOptionDisableLegacyRenegotiation0x10Desactiva el antiguo mecanismo inseguro para renegociar los parámetros de conexión. Cuando está activada, esta opción puede permitir conexiones con servidores heredados, pero introduce la posibilidad de que un atacante pueda inyectar texto sin cifrar en la sesión SSL.
QSsl::SslOptionDisableSessionSharing0x20Desactiva el uso compartido de sesiones SSL a través del atributo de protocolo de enlace de ID de sesión.
QSsl::SslOptionDisableSessionPersistence0x40Desactiva el almacenamiento de la sesión SSL en formato ASN.1 tal y como lo devuelve QSslConfiguration::sessionTicket(). Al habilitar esta función, se añade una sobrecarga de memoria de aproximadamente 1K por cada ticket de sesión utilizado.
QSsl::SslOptionDisableServerCipherPreference0x80Desactiva la selección del cifrado en función de las preferencias del servidor, en lugar del orden en que el cliente envió los cifrados. Esta opción solo es relevante para los sockets de servidor y solo la admite el backend de OpenSSL.

Por defecto, SslOptionDisableEmptyFragments está activada, ya que su desactivación provoca problemas con un gran número de servidores. SslOptionDisableLegacyRenegotiation también está activada, ya que supone un riesgo de seguridad. SslOptionDisableCompression está activada para prevenir el ataque dado a conocer por CRIME. SslOptionDisableSessionPersistence está activada para optimizar el uso de la memoria. Las demás opciones están desactivadas.

Nota: La disponibilidad de las opciones anteriores depende de la versión del backend SSL que se utilice.

El tipo SslOptions es un typedef para QFlags<SslOption>. Almacena una combinación OR de valores de SslOption.

enum QSsl::SslProtocol

Describe el protocolo del cifrado.

ConstanteValorDescripción
QSsl::TlsV1_00TLSv1.0
QSsl::TlsV1_0OrLater5TLSv1.0 y versiones posteriores.
QSsl::TlsV1_11TLSv1.1.
QSsl::TlsV1_1OrLater6TLSv1.1 y versiones posteriores.
QSsl::TlsV1_22TLSv1.2.
QSsl::TlsV1_2OrLater7TLSv1.2 y versiones posteriores.
QSsl::DtlsV1_08DTLSv1.0
QSsl::DtlsV1_0OrLater9DTLSv1.0 y versiones posteriores.
QSsl::DtlsV1_210DTLSv1.2
QSsl::DtlsV1_2OrLater11DTLSv1.2 y versiones posteriores.
QSsl::TlsV1_3 (since Qt 5.12)12TLSv1.3.
QSsl::TlsV1_3OrLater (since Qt 5.12)13TLSv1.3 y versiones posteriores.
QSsl::UnknownProtocol-1No se puede determinar el protocolo del cifrado.
QSsl::AnyProtocol3Cualquier protocolo compatible. Este valor solo lo utiliza QSslSocket.
QSsl::SecureProtocols4La opción predeterminada, que utiliza protocolos que se sabe que son seguros.

[since 6.1] enum class SupportedFeature

Enumera las posibles funciones que admite un backend TLS

En QtNetwork, las clases relacionadas con TLS tienen una API pública que puede no estar implementada por algunos backends; por ejemplo, nuestro backend SecureTransport no admite ALPN del lado del servidor. Los elementos de la enumeración SupportedFeature indican que una característica concreta está admitida.

ConstanteValorDescripción
QSslSocket::SupportedFeature::CertificateVerification0Indica que el backend implementa ` QSslCertificate::verify()`.
QSslSocket::SupportedFeature::ClientSideAlpn1ALPN del lado del cliente (negociación del protocolo de la capa de aplicación).
QSslSocket::SupportedFeature::ServerSideAlpn2ALPN del lado del servidor.
QSslSocket::SupportedFeature::Ocsp3OCSP Stapling (Protocolo de estado de certificados en línea).
QSslSocket::SupportedFeature::Psk4Claves precompartidas.
QSslSocket::SupportedFeature::SessionTicket5Tickets de sesión.
QSslSocket::SupportedFeature::Alerts6Información sobre los mensajes de alerta enviados y recibidos.

Esta enumeración se introdujo en Qt 6.1.

© 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.