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 |
- Lista de todos los miembros, incluyendo los heredados
- QSslCertificateExtension es parte de la API de Programación de Redes y Clases Implícitamente Compartidas.
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:
| Propiedad | Descripción |
|---|---|
| nombre | Nombre legible de la extensión, por ejemplo "basicConstraints". |
| criticidad | Valor booleano que indica si la extensión es crítica para interpretar correctamente el certificado. |
| oid | El identificador de objeto ASN.1 que especifica de qué extensión se trata. |
| compatible | Si es verdadero, la estructura del valor de la extensión no cambiará entre versiones de Qt. |
| valor | Un 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:
| Nombre | OID | Detalles |
|---|---|---|
| basicConstraints | 2.5.29.19 | Se devuelve como QVariantMap. La clave "ca" contiene un valor booleano, la clave opcional "pathLenConstraint" contiene un número entero. |
| authorityInfoAccess | 1.3.6.1.5.5.7.1.1 | Se devuelve como QVariantMap. Hay una clave para cada método de acceso, y el valor es un URI. |
| subjectKeyIdentifier | 2.5.29.14 | Se devuelve como un QVariant que contiene un QString. La cadena es el identificador de la clave. |
| authorityKeyIdentifier | 2.5.29.35 | Se 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.