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 |
- QSsl forma parte de la API de programación de redes.
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 } |
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.
| Constante | Valor | Descripción |
|---|---|---|
QSslSocket::AlertLevel::Warning | 0 | Mensaje de alerta no crítico |
QSslSocket::AlertLevel::Fatal | 1 | Mensaje de alerta grave; el backend subyacente gestionará dicha alerta adecuadamente y cerrará la conexión. |
QSslSocket::AlertLevel::Unknown | 2 | Una 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.
| Constante | Valor | Descripción |
|---|---|---|
QSslSocket::AlertType::CloseNotify | 0 | , |
QSslSocket::AlertType::UnexpectedMessage | 10 | |
QSslSocket::AlertType::BadRecordMac | 20 | |
QSslSocket::AlertType::RecordOverflow | 22 | |
QSslSocket::AlertType::DecompressionFailure | 30 | |
QSslSocket::AlertType::HandshakeFailure | 40 | |
QSslSocket::AlertType::NoCertificate | 41 | |
QSslSocket::AlertType::BadCertificate | 42 | |
QSslSocket::AlertType::UnsupportedCertificate | 43 | |
QSslSocket::AlertType::CertificateRevoked | 44 | |
QSslSocket::AlertType::CertificateExpired | 45 | |
QSslSocket::AlertType::CertificateUnknown | 46 | |
QSslSocket::AlertType::IllegalParameter | 47 | |
QSslSocket::AlertType::UnknownCa | 48 | |
QSslSocket::AlertType::AccessDenied | 49 | |
QSslSocket::AlertType::DecodeError | 50 | |
QSslSocket::AlertType::DecryptError | 51 | |
QSslSocket::AlertType::ExportRestriction | 60 | |
QSslSocket::AlertType::ProtocolVersion | 70 | |
QSslSocket::AlertType::InsufficientSecurity | 71 | |
QSslSocket::AlertType::InternalError | 80 | |
QSslSocket::AlertType::InappropriateFallback | 86 | |
QSslSocket::AlertType::UserCancelled | 90 | |
QSslSocket::AlertType::NoRenegotiation | 100 | |
QSslSocket::AlertType::MissingExtension | 109 | |
QSslSocket::AlertType::UnsupportedExtension | 110 | |
QSslSocket::AlertType::CertificateUnobtainable | 111 | |
QSslSocket::AlertType::UnrecognizedName | 112 | |
QSslSocket::AlertType::BadCertificateStatusResponse | 113 | |
QSslSocket::AlertType::BadCertificateHashValue | 114 | |
QSslSocket::AlertType::UnknownPskIdentity | 115 | |
QSslSocket::AlertType::CertificateRequired | 116 | |
QSslSocket::AlertType::NoApplicationProtocol | 120 | |
QSslSocket::AlertType::UnknownAlertMessage | 255 |
Esta enumeración se introdujo en Qt 6.0.
enum QSsl::AlternativeNameEntryType
Describe los tipos clave para las entradas de nombres alternativos en QSslCertificate.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::EmailEntry | 0 | Una entrada de correo electrónico; la entrada contiene una dirección de correo electrónico para la que es válido el certificado. |
QSsl::DnsEntry | 1 | Una 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::IpAddressEntry | 2 | Una 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.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::Pem | 0 | El formato PEM. |
QSsl::Der | 1 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QSslSocket::ImplementedClass::Key | 0 | Clase QSslKey. |
QSslSocket::ImplementedClass::Certificate | 1 | Clase QSslCertificate. |
QSslSocket::ImplementedClass::Socket | 2 | Clase « QSslSocket ». |
QSslSocket::ImplementedClass::DiffieHellman | 3 | Clase « QSslDiffieHellmanParameters ». |
QSslSocket::ImplementedClass::EllipticCurve | 4 | Clase « QSslEllipticCurve ». |
QSslSocket::ImplementedClass::Dtls | 5 | Clase « QDtls ». |
QSslSocket::ImplementedClass::DtlsCookie | 6 | Clase « QDtlsClientVerifier ». |
Esta enumeración se introdujo en Qt 6.1.
enum QSsl::KeyAlgorithm
Describe los diferentes algoritmos de clave compatibles con QSslKey.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::MlDsa | 5 | El algoritmo ML-DSA. |
QSsl::Rsa | 1 | El algoritmo RSA. |
QSsl::Dsa | 2 | El algoritmo DSA. |
QSsl::Ec | 3 | El algoritmo de curva elíptica. |
QSsl::Dh | 4 | El algoritmo de Diffie-Hellman. |
QSsl::Opaque | 0 | Una 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.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::PrivateKey | 0 | Una clave privada. |
QSsl::PublicKey | 1 | Una 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.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::SslOptionDisableEmptyFragments | 0x01 | Desactiva 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::SslOptionDisableSessionTickets | 0x02 | Desactiva 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::SslOptionDisableCompression | 0x04 | Desactiva 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::SslOptionDisableServerNameIndication | 0x08 | Desactiva 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::SslOptionDisableLegacyRenegotiation | 0x10 | Desactiva 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::SslOptionDisableSessionSharing | 0x20 | Desactiva el uso compartido de sesiones SSL a través del atributo de protocolo de enlace de ID de sesión. |
QSsl::SslOptionDisableSessionPersistence | 0x40 | Desactiva 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::SslOptionDisableServerCipherPreference | 0x80 | Desactiva 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.
| Constante | Valor | Descripción |
|---|---|---|
QSsl::TlsV1_0 | 0 | TLSv1.0 |
QSsl::TlsV1_0OrLater | 5 | TLSv1.0 y versiones posteriores. |
QSsl::TlsV1_1 | 1 | TLSv1.1. |
QSsl::TlsV1_1OrLater | 6 | TLSv1.1 y versiones posteriores. |
QSsl::TlsV1_2 | 2 | TLSv1.2. |
QSsl::TlsV1_2OrLater | 7 | TLSv1.2 y versiones posteriores. |
QSsl::DtlsV1_0 | 8 | DTLSv1.0 |
QSsl::DtlsV1_0OrLater | 9 | DTLSv1.0 y versiones posteriores. |
QSsl::DtlsV1_2 | 10 | DTLSv1.2 |
QSsl::DtlsV1_2OrLater | 11 | DTLSv1.2 y versiones posteriores. |
QSsl::TlsV1_3 (since Qt 5.12) | 12 | TLSv1.3. |
QSsl::TlsV1_3OrLater (since Qt 5.12) | 13 | TLSv1.3 y versiones posteriores. |
QSsl::UnknownProtocol | -1 | No se puede determinar el protocolo del cifrado. |
QSsl::AnyProtocol | 3 | Cualquier protocolo compatible. Este valor solo lo utiliza QSslSocket. |
QSsl::SecureProtocols | 4 | La 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.
| Constante | Valor | Descripción |
|---|---|---|
QSslSocket::SupportedFeature::CertificateVerification | 0 | Indica que el backend implementa ` QSslCertificate::verify()`. |
QSslSocket::SupportedFeature::ClientSideAlpn | 1 | ALPN del lado del cliente (negociación del protocolo de la capa de aplicación). |
QSslSocket::SupportedFeature::ServerSideAlpn | 2 | ALPN del lado del servidor. |
QSslSocket::SupportedFeature::Ocsp | 3 | OCSP Stapling (Protocolo de estado de certificados en línea). |
QSslSocket::SupportedFeature::Psk | 4 | Claves precompartidas. |
QSslSocket::SupportedFeature::SessionTicket | 5 | Tickets de sesión. |
QSslSocket::SupportedFeature::Alerts | 6 | Informació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.