En esta página

QSslCertificate Class

La clase `QSslCertificate` ofrece una API práctica para un certificado X509. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

enum class PatternSyntax { RegularExpression, Wildcard, FixedString }
enum SubjectInfo { Organization, CommonName, LocalityName, OrganizationalUnitName, CountryName, …, EmailAddress }

Funciones públicas

QSslCertificate(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)
QSslCertificate(const QByteArray &data = QByteArray(), QSsl::EncodingFormat format = QSsl::Pem)
QSslCertificate(const QSslCertificate &other)
(since 6.8) QSslCertificate(QSslCertificate &&other)
~QSslCertificate()
void clear()
QByteArray digest(QCryptographicHash::Algorithm algorithm = QCryptographicHash::Md5) const
QDateTime effectiveDate() const
QDateTime expiryDate() const
QList<QSslCertificateExtension> extensions() const
Qt::HANDLE handle() const
bool isBlacklisted() const
bool isNull() const
bool isSelfSigned() const
QString issuerDisplayName() const
QStringList issuerInfo(QSslCertificate::SubjectInfo subject) const
QStringList issuerInfo(const QByteArray &attribute) const
QList<QByteArray> issuerInfoAttributes() const
QSslKey publicKey() const
QByteArray serialNumber() const
QMultiMap<QSsl::AlternativeNameEntryType, QString> subjectAlternativeNames() const
QString subjectDisplayName() const
QStringList subjectInfo(QSslCertificate::SubjectInfo subject) const
QStringList subjectInfo(const QByteArray &attribute) const
QList<QByteArray> subjectInfoAttributes() const
void swap(QSslCertificate &other)
QByteArray toDer() const
QByteArray toPem() const
QString toText() const
QByteArray version() const
bool operator!=(const QSslCertificate &other) const
QSslCertificate &operator=(const QSslCertificate &other)
bool operator==(const QSslCertificate &other) const

Miembros públicos estáticos

QList<QSslCertificate> fromData(const QByteArray &data, QSsl::EncodingFormat format = QSsl::Pem)
QList<QSslCertificate> fromDevice(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)
(since 6.10) QList<QSslCertificate> fromFile(const QString &filePath, QSsl::EncodingFormat format = QSsl::Pem)
QList<QSslCertificate> fromPath(const QString &path, QSsl::EncodingFormat format = QSsl::Pem, QSslCertificate::PatternSyntax syntax = PatternSyntax::FixedString)
bool importPkcs12(QIODevice *device, QSslKey *key, QSslCertificate *certificate, QList<QSslCertificate> *caCertificates = nullptr, const QByteArray &passPhrase = QByteArray())
QList<QSslError> verify(const QList<QSslCertificate> &certificateChain, const QString &hostName = QString())

Descripción detallada

QSslCertificate almacena un certificado X509 y se utiliza habitualmente para verificar la identidad y almacenar información sobre el host local, un par conectado de forma remota o una autoridad de certificación de confianza.

Hay muchas formas de crear un QSslCertificate. La forma más habitual es llamar a ` QSslSocket::peerCertificate()` —que devuelve un objeto QSslCertificate— o a ` QSslSocket::peerCertificateChain()` —que devuelve una lista de ellos—. También puedes cargar certificados desde un paquete codificado en formato DER (binario) o PEM (Base64), que suelen almacenarse como uno o varios archivos locales, o en un recurso de Qt.

Puedes llamar a ` isNull()` para comprobar si tu certificado es nulo. Por defecto, `QSslCertificate` crea un certificado nulo. Un certificado nulo no es válido, pero un certificado no válido no tiene por qué ser nulo. Si deseas restablecer todo el contenido de un certificado, llama a ` clear()`.

Tras cargar un certificado, puede obtener información sobre el certificado, su sujeto y su emisor llamando a una de las numerosas funciones de acceso, entre las que se incluyen version(), serialNumber(), issuerInfo() y subjectInfo(). Puede llamar a effectiveDate() y expiryDate() para comprobar cuándo entra en vigor el certificado y cuándo caduca. La función publicKey() devuelve la clave pública del sujeto del certificado como un objeto QSslKey. Se pueden llamar a las funciones issuerInfo() o subjectInfo() para obtener información detallada sobre el emisor del certificado y su sujeto.

Internamente, QSslCertificate se almacena como una estructura X509. Se puede acceder a este identificador llamando a ` handle()`, pero es probable que los resultados no sean portables.

Véase también QSslSocket, QSslKey, QSslCipher y QSslError.

Documentación sobre tipos de miembros

enum class QSslCertificate::PatternSyntax

La sintaxis utilizada para interpretar el significado del patrón.

ConstanteValorDescripción
QSslCertificate::PatternSyntax::RegularExpression0Una sintaxis de coincidencia de patrones muy completa, similar a la de Perl.
QSslCertificate::PatternSyntax::Wildcard1Esto proporciona una sintaxis sencilla de coincidencia de patrones similar a la utilizada por los shells (interpretadores de comandos) para la «expansión de archivos». Véase QRegularExpression::fromWildcard().
QSslCertificate::PatternSyntax::FixedString2El patrón es una cadena fija. Esto equivale a utilizar el patrón RegularExpression en una cadena en la que todos los metacaracteres se escapan mediante escape(). Este es el valor predeterminado.

enum QSslCertificate::SubjectInfo

Describe las claves que se pueden pasar a ` QSslCertificate::issuerInfo()` o ` QSslCertificate::subjectInfo()` para obtener información sobre el emisor o el sujeto del certificado.

ConstanteValorDescripción
QSslCertificate::Organization0«O» El nombre de la organización.
QSslCertificate::CommonName1«CN» El nombre común; normalmente se utiliza para almacenar el nombre de host.
QSslCertificate::LocalityName2«L»: la localidad.
QSslCertificate::OrganizationalUnitName3«OU»: el nombre de la unidad organizativa.
QSslCertificate::CountryName4«C»: el país.
QSslCertificate::StateOrProvinceName5«ST»: el estado o provincia.
QSslCertificate::DistinguishedNameQualifier6El calificador del nombre distinguido
QSslCertificate::SerialNumber7El número de serie del certificado
QSslCertificate::EmailAddress8La dirección de correo electrónico asociada al certificado

Documentación de las funciones de miembro

[explicit] QSslCertificate::QSslCertificate(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Crea un objeto `QSslCertificate` leyendo los datos codificados en formato « format » procedentes de device y utilizando el primer certificado que encuentre. Posteriormente, puedes llamar a isNull() para comprobar si device contenía un certificado y si dicho certificado se ha cargado correctamente.

[explicit] QSslCertificate::QSslCertificate(const QByteArray &data = QByteArray(), QSsl::EncodingFormat format = QSsl::Pem)

Crea un objeto `QSslCertificate` analizando el archivo ` format ` codificado en ` data ` y utilizando el primer certificado disponible que se encuentre. Posteriormente, puedes llamar a ` isNull()` para comprobar si ` data ` contenía un certificado y si dicho certificado se ha cargado correctamente.

QSslCertificate::QSslCertificate(const QSslCertificate &other)

Crea una copia idéntica de other.

[constexpr noexcept default, since 6.8] QSslCertificate::QSslCertificate(QSslCertificate &&other)

Crea un nuevo objeto `QSslCertificate` a partir de ` other`.

Nota: El objeto del que se ha realizado el movimiento, ` other `, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.8.

[noexcept] QSslCertificate::~QSslCertificate()

Destruye el « QSslCertificate ».

void QSslCertificate::clear()

Borra el contenido de este certificado, convirtiéndolo en un certificado nulo.

Véase también isNull().

QByteArray QSslCertificate::digest(QCryptographicHash::Algorithm algorithm = QCryptographicHash::Md5) const

Devuelve un resumen criptográfico de este certificado. De forma predeterminada, se generará un resumen MD5, pero también puedes especificar un resumen personalizado algorithm.

QDateTime QSslCertificate::effectiveDate() const

Devuelve la fecha y hora en que el certificado entra en vigor, o un objeto ` QDateTime ` vacío si se trata de un certificado nulo.

Véase también expiryDate().

QDateTime QSslCertificate::expiryDate() const

Devuelve la fecha y hora de caducidad del certificado, o un objeto ` QDateTime ` vacío si se trata de un certificado nulo.

Véase también effectiveDate().

QList<QSslCertificateExtension> QSslCertificate::extensions() const

Devuelve una lista que contiene las extensiones X.509 de este certificado.

[static] QList<QSslCertificate> QSslCertificate::fromData(const QByteArray &data, QSsl::EncodingFormat format = QSsl::Pem)

Busca y analiza todos los certificados de data que estén codificados en el formato format especificado, y los devuelve en una lista de certificados.

Véase también fromDevice().

[static] QList<QSslCertificate> QSslCertificate::fromDevice(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Busca y analiza todos los certificados de device que estén codificados en el formato format especificado, y los devuelve en una lista de certificados.

Véase también fromData().

[static, since 6.10] QList<QSslCertificate> QSslCertificate::fromFile(const QString &filePath, QSsl::EncodingFormat format = QSsl::Pem)

Lee los datos del archivo filePath, analiza todos los certificados codificados en el formato especificado format y devuelve una lista de objetos QSslCertificate.

Si filePath no es un archivo normal, este método devolverá una lista vacía.

Esta función se introdujo en Qt 6.10.

Véase también fromData() y fromPath().

[static] QList<QSslCertificate> QSslCertificate::fromPath(const QString &path, QSsl::EncodingFormat format = QSsl::Pem, QSslCertificate::PatternSyntax syntax = PatternSyntax::FixedString)

Busca en todos los archivos de la ruta « path » los certificados codificados en el formato especificado en « format » y los devuelve en una lista. « path » debe ser un archivo o un patrón que coincida con uno o varios archivos, tal y como se especifica en « syntax ».

Ejemplo:

const auto certs = QSslCertificate::fromPath("C:/ssl/certificate.*.pem",
                                             QSsl::Pem, QSslCertificate::Wildcard);
for (const QSslCertificate&cert: certs) {
    qDebug() << cert.issuerInfo(QSslCertificate::Organization);
}

Véase también fromData().

Qt::HANDLE QSslCertificate::handle() const

Devuelve un puntero al identificador nativo del certificado, si existe; en caso contrario, devuelve ` nullptr`.

Se puede utilizar este identificador, junto con la API nativa, para acceder a información ampliada sobre el certificado.

Advertencia: El uso de esta función tiene una alta probabilidad de no ser portable, y su valor de retorno puede variar de una plataforma a otra o cambiar de una versión menor a otra.

[static] bool QSslCertificate::importPkcs12(QIODevice *device, QSslKey *key, QSslCertificate *certificate, QList<QSslCertificate> *caCertificates = nullptr, const QByteArray &passPhrase = QByteArray())

Importa un archivo PKCS#12 (pfx) desde la ubicación especificada device. Un archivo PKCS#12 es un paquete que puede contener varios certificados y claves. Este método lee un único key, su certificate y cualquier caCertificates asociado del paquete. Si se especifica un passPhrase, este se utilizará para descifrar el paquete. Devuelve ` true ` si el archivo PKCS#12 se ha cargado correctamente.

Nota: El archivo « device » debe estar abierto y listo para ser leído.

bool QSslCertificate::isBlacklisted() const

Devuelve « true » si este certificado figura en la lista negra; en caso contrario, devuelve « false ».

Véase también isNull().

bool QSslCertificate::isNull() const

Devuelve ` true ` si se trata de un certificado nulo (es decir, un certificado sin contenido); en caso contrario, devuelve ` false`.

Por defecto, ` QSslCertificate ` crea un certificado nulo.

Véase también clear().

bool QSslCertificate::isSelfSigned() const

Devuelve « true » si este certificado es autofirmado; en caso contrario, devuelve « false ».

Se considera que un certificado es autofirmado cuando su emisor y su sujeto son idénticos.

QString QSslCertificate::issuerDisplayName() const

Devuelve un nombre que describe al emisor. Devuelve el QSslCertificate::CommonName si está disponible; de lo contrario, recurre al primer QSslCertificate::Organization o al primer QSslCertificate::OrganizationalUnitName.

Véase también issuerInfo().

QStringList QSslCertificate::issuerInfo(QSslCertificate::SubjectInfo subject) const

Devuelve la información del emisor correspondiente a « subject » (Emisor del certificado) a partir del certificado, o una lista vacía si no hay información sobre « subject » en el certificado. Puede haber más de una entrada de cada tipo.

Véase también subjectInfo().

QStringList QSslCertificate::issuerInfo(const QByteArray &attribute) const

Devuelve la información del emisor correspondiente a attribute a partir del certificado, o una lista vacía si no hay información sobre attribute en el certificado. Puede haber más de una entrada para un mismo atributo.

Véase también subjectInfo().

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

Devuelve una lista de los atributos que tienen valores en la información del emisor de este certificado. Se puede acceder a la información asociada a un atributo determinado mediante el método issuerInfo(). Ten en cuenta que esta lista puede incluir los OID de cualquier elemento que el backend SSL no reconozca.

Véase también subjectInfo().

QSslKey QSslCertificate::publicKey() const

Devuelve la clave pública del titular del certificado.

QByteArray QSslCertificate::serialNumber() const

Devuelve la cadena del número de serie del certificado en formato hexadecimal.

QMultiMap<QSsl::AlternativeNameEntryType, QString> QSslCertificate::subjectAlternativeNames() const

Devuelve la lista de nombres de sujeto alternativos para este certificado. Los nombres alternativos suelen contener nombres de host, opcionalmente con comodines, que son válidos para este certificado.

Estos nombres se comparan con el nombre de host del par conectado, si la información del sujeto de CommonName no define un nombre de host válido o si el nombre de la información del sujeto no coincide con el nombre de host del par.

Véase también subjectInfo().

QString QSslCertificate::subjectDisplayName() const

Devuelve un nombre que describe el tema. Devuelve el QSslCertificate::CommonName si está disponible; de lo contrario, recurre al primer QSslCertificate::Organization o al primer QSslCertificate::OrganizationalUnitName.

Véase también subjectInfo().

QStringList QSslCertificate::subjectInfo(QSslCertificate::SubjectInfo subject) const

Devuelve la información correspondiente a subject, o una lista vacía si no hay información sobre subject en el certificado. Puede haber más de una entrada de cada tipo.

Véase también issuerInfo().

QStringList QSslCertificate::subjectInfo(const QByteArray &attribute) const

Devuelve la información del sujeto correspondiente a « attribute », o una lista vacía si no hay información sobre « attribute » en el certificado. Puede haber más de una entrada para un mismo atributo.

Véase también issuerInfo().

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

Devuelve una lista de los atributos que tienen valores en la información del sujeto de este certificado. Se puede acceder a la información asociada a un atributo determinado mediante el método subjectInfo(). Ten en cuenta que esta lista puede incluir los OID de cualquier elemento que el backend SSL no reconozca.

Véase también subjectInfo().

[noexcept] void QSslCertificate::swap(QSslCertificate &other)

Sustituye esta instancia de certificado por other. Esta operación es muy rápida y nunca falla.

QByteArray QSslCertificate::toDer() const

Devuelve este certificado convertido a una representación codificada en formato DER (binario).

QByteArray QSslCertificate::toPem() const

Devuelve este certificado convertido a una representación codificada en formato PEM (Base64).

QString QSslCertificate::toText() const

Devuelve este certificado convertido a una representación de texto legible para el usuario.

[static] QList<QSslError> QSslCertificate::verify(const QList<QSslCertificate> &certificateChain, const QString &hostName = QString())

Verifica una cadena de certificados. La cadena que se va a verificar se pasa a través del parámetro « certificateChain ». El primer certificado de la lista debe ser el certificado final de la cadena que se va a verificar. Si se especifica « hostName », también se comprueba si el certificado es válido para el nombre de host indicado.

Ten en cuenta que el certificado raíz (CA) no debe incluirse en la lista que se va a verificar, ya que se buscará automáticamente utilizando la lista de CA especificada en el valor predeterminado de QSslConfiguration y, además, si es posible, los certificados de CA cargados bajo demanda en Unix y Windows.

QByteArray QSslCertificate::version() const

Devuelve la cadena de versión del certificado.

bool QSslCertificate::operator!=(const QSslCertificate &other) const

Devuelve « true » si este certificado no coincide con « other »; en caso contrario, devuelve « false ».

QSslCertificate &QSslCertificate::operator=(const QSslCertificate &other)

Copia el contenido de other en este certificado, de modo que ambos certificados quedan idénticos.

bool QSslCertificate::operator==(const QSslCertificate &other) const

Devuelve « true » si este certificado es el mismo que « other »; en caso contrario, devuelve « false ».

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