En esta página

QSslCertificateExtension Class

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

Encabezado: #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 certificados X509 tienen las siguientes propiedades:

PropiedadDescripción
nombreEl nombre legible para el usuario de la extensión, p. ej., «basicConstraints».
criticidadSe trata de un valor 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 este valor es verdadero, la estructura del valor de la extensión no cambiará entre versiones de Qt.
valorUn objeto ` QVariant ` cuya estructura depende del tipo de extensión.

Aunque esta clase permite acceder a cualquier tipo de extensión, solo se garantiza que algunas se devuelvan en un formato que se mantendrá sin cambios entre versiones. El método ` isSupported()` devuelve ` true ` para las extensiones en las que esto es así.

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

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

Además de las extensiones compatibles mencionadas anteriormente, muchas otras extensiones comunes se devolverán de forma razonablemente estructurada. Las extensiones que el backend SSL no admite en absoluto se devolverán como un ` QByteArray`.

Se puede encontrar más información sobre los tipos de extensiones que pueden contener los certificados en el RFC 5280.

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

Documentación de funciones de miembro

QSslCertificateExtension::QSslCertificateExtension()

Crea un objeto «QSslCertificateExtension».

QSslCertificateExtension::QSslCertificateExtension(const QSslCertificateExtension &other)

Crea una copia de other.

[noexcept] QSslCertificateExtension::~QSslCertificateExtension()

Elimina la extensión.

bool QSslCertificateExtension::isCritical() const

Devuelve el nivel de criticidad de la extensión.

bool QSslCertificateExtension::isSupported() const

Devuelve «true» si esta extensión es compatible. En este caso, «compatible» significa simplemente que la estructura del objeto ` QVariant ` devuelto por el accesor ` value()` permanecerá inalterada entre versiones. Las extensiones no compatibles pueden utilizarse 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)

Sustituye esta instancia de extensión de certificado por 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 dicha 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.