En esta página

QSslCertificateExtension Class

La clase QSslCertificateExtension proporciona una API para acceder a las extensiones de un certificado X509. Más...

Cabecera: #include <QSslCertificateExtension>
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.

Funciones Públicas

QSslCertificateExtension()
QSslCertificateExtension(const QSslCertificateExtension &other)
~QSslCertificateExtension()
bool isCritical() const
bool isSupported() const
QString name() const
QString oid() const
void swap(QSslCertificateExtension &other)
QVariant value() const
QSslCertificateExtension &operator=(const QSslCertificateExtension &other)

Descripción Detallada

QSslCertificateExtension proporciona acceso a una extensión almacenada en un certificado X509. La información disponible depende del tipo de extensión a la que se acceda.

Todas las extensiones de certificado X509 tienen las siguientes propiedades:

PropiedadDescripción
nombreNombre legible de la extensión, por ejemplo "basicConstraints".
criticidadValor booleano que indica si la extensión es crítica para interpretar correctamente el certificado.
oidEl identificador de objeto ASN.1 que especifica de qué extensión se trata.
compatibleSi es verdadero, la estructura del valor de la extensión no cambiará entre versiones de Qt.
valorUn QVariant con una estructura dependiente del tipo de extensión.

Aunque esta clase proporciona acceso a cualquier tipo de extensión, sólo se garantiza la devolución de algunas en un formato que no cambiará entre versiones. El método isSupported() devuelve true para las extensiones en las que éste es el caso.

Las extensiones admitidas actualmente y la estructura del valor devuelto son las siguientes:

NombreOIDDetalles
basicConstraints2.5.29.19Se devuelve como QVariantMap. La clave "ca" contiene un valor booleano, la clave opcional "pathLenConstraint" contiene un número entero.
authorityInfoAccess1.3.6.1.5.5.7.1.1Se devuelve como QVariantMap. Hay una clave para cada método de acceso, y el valor es un URI.
subjectKeyIdentifier2.5.29.14Se devuelve como un QVariant que contiene un QString. La cadena es el identificador de la clave.
authorityKeyIdentifier2.5.29.35Se devuelve como QVariantMap. La clave opcional "keyid" contiene el identificador de la clave como cadena hexadecimal almacenada en QByteArray. La clave opcional "serial" contiene el número de serie de la clave de autoridad como qlonglong. Actualmente no hay soporte para el campo de nombres generales de esta extensión.

Además de las extensiones soportadas anteriormente, se devolverán muchas otras extensiones comunes de una forma razonablemente estructurada. Las extensiones para las que el backend SSL no tenga soporte se devolverán como QByteArray.

Encontrará más información sobre los tipos de extensiones que pueden contener los certificados en RFC 5280.

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

Documentación de funciones miembro

QSslCertificateExtension::QSslCertificateExtension()

Construye un QSslCertificateExtension.

QSslCertificateExtension::QSslCertificateExtension(const QSslCertificateExtension &other)

Construye una copia de other.

[noexcept] QSslCertificateExtension::~QSslCertificateExtension()

Destruye la extensión.

bool QSslCertificateExtension::isCritical() const

Devuelve la criticidad de la extensión.

bool QSslCertificateExtension::isSupported() const

Devuelve el verdadero si esta extensión es soportada. En este caso, soportada simplemente significa que la estructura de QVariant devuelta por el accesorio value() permanecerá sin cambios entre versiones. Las extensiones no soportadas pueden usarse libremente, sin embargo no hay garantía de que los datos devueltos tengan la misma estructura entre versiones.

QString QSslCertificateExtension::name() const

Devuelve el nombre de la extensión. Si no se conoce el nombre de la extensión, se devolverá el OID.

QString QSslCertificateExtension::oid() const

Devuelve el OID ASN.1 de esta extensión.

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

Intercambia esta instancia de extensión de certificado con other. Esta operación es muy rápida y nunca falla.

QVariant QSslCertificateExtension::value() const

Devuelve el valor de la extensión. La estructura del valor devuelto depende del tipo de extensión.

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

Asigna other a esta extensión y devuelve una referencia a esta extensió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.