QWebEngineCertificateError Class
La clase QWebEngineCertificateError proporciona información sobre un error de certificado. Más...
| Cabecera: | #include <QWebEngineCertificateError> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| En QML: | webEngineCertificateError |
Tipos públicos
| enum | Type { Ok, SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, …, CertificateSymantecLegacy } |
Propiedades
|
Funciones públicas
| void | acceptCertificate() |
| QList<QSslCertificate> | certificateChain() const |
| void | defer() |
| QString | description() const |
| bool | isMainFrame() const |
| bool | isOverridable() const |
| void | rejectCertificate() |
| QWebEngineCertificateError::Type | type() const |
| QUrl | url() const |
Descripción detallada
Proporciona información sobre un error de certificado. Esta clase se utiliza como parámetro de QWebEnginePage::certificateError().
Documentación de tipos de miembros
enum QWebEngineCertificateError::Type
Este enum describe el tipo de error de certificado encontrado.
Los valores de este tipo de enum coinciden con los errores SSL que proporciona Chromium. Los valores de QSslError::SslError no se utilizan directamente, ya que las categorías de error de Qt no se pueden asignar a las categorías de error de Chromium.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineCertificateError::Ok | 0 | No hubo ningún error de certificado real. |
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | El certificado no coincidía con las claves públicas incorporadas fijadas para el nombre de host. |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | El nombre común del certificado no coincide con el nombre del host. |
QWebEngineCertificateError::CertificateDateInvalid | -201 | El certificado no es válido en la fecha y hora actuales. |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | El certificado no está firmado por una autoridad de confianza. |
QWebEngineCertificateError::CertificateContainsErrors | -203 | El certificado contiene errores. |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | El certificado no tiene ningún mecanismo para determinar si ha sido revocado. |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | La información de revocación del certificado no está disponible. |
QWebEngineCertificateError::CertificateRevoked | -206 | El certificado ha sido revocado. |
QWebEngineCertificateError::CertificateInvalid | -207 | El certificado no es válido. |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | El certificado está firmado con un algoritmo de firma débil. |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | El nombre de host especificado en el certificado no es único. |
QWebEngineCertificateError::CertificateWeakKey | -211 | El certificado contiene una clave débil. |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | El certificado reclama nombres DNS que infringen las restricciones de nombres. |
QWebEngineCertificateError::CertificateValidityTooLong (since Qt 5.7) | -213 | El certificado tiene un periodo de validez demasiado largo. |
QWebEngineCertificateError::CertificateTransparencyRequired (since Qt 5.8) | -214 | Se requería transparencia de certificados para esta conexión, pero el servidor no proporcionó información de TC que cumpliera la política. |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked (since Qt 5.15) | -217 | Se sabe que una entidad distinta del propietario del dispositivo utiliza el certificado para interceptarlo. |
QWebEngineCertificateError::SslObsoleteVersion (since Qt 6.2, deprecated in Qt 6.4) | -218 | La conexión utiliza una versión obsoleta de SSL/TLS. |
QWebEngineCertificateError::CertificateSymantecLegacy (since Qt 6.2, deprecated in Qt 6.11) | -215 | El certificado es uno heredado de Symantec que ya no es válido. |
Documentación de propiedades
[read-only] description : const QString
Esta propiedad contiene una breve descripción localizada y legible por humanos del error.
Funciones de acceso:
| QString | description() const |
Véase también url() y isOverridable().
[read-only, since 6.8] isMainFrame : const bool
Devuelve si el error de certificado procede del marco principal. Si es false, el error proviene de un sub-recurso y lo más probable es que deba ser rechazado sin intervención del usuario.
Esta propiedad se introdujo en Qt 6.8.
Funciones de acceso:
| bool | isMainFrame() const |
[read-only] overridable : const bool
Esta propiedad mantiene si este error puede ser anulado y aceptado.
Funciones de acceso:
| bool | isOverridable() const |
Véase también description().
[read-only] type : const Type
Esta propiedad contiene el tipo de error.
Funciones de acceso:
| QWebEngineCertificateError::Type | type() const |
Véase también description() y isOverridable().
[read-only] url : const QUrl
Esta propiedad contiene la URL que ha provocado el error.
Funciones de acceso:
| QUrl | url() const |
Véase también description().
Documentación de las funciones miembro
[invokable] void QWebEngineCertificateError::acceptCertificate()
Acepta el certificado y continúa la carga de la URL solicitada.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
Devuelve la cadena de certificados digitales del par.
La cadena comienza con el certificado inmediato del par y termina con el certificado de la CA.
[invokable] void QWebEngineCertificateError::defer()
Marca el error de certificado para su gestión diferida.
Esta función debe invocarse cuando sea necesario posponer la decisión de aceptar o no un certificado, por ejemplo, mientras se espera la respuesta del usuario. Cuando se llama, la función pausa la solicitud de URL hasta que se llama a acceptCertificate() o rejectCertificate().
Nota: sólo es posible aplazar los errores de certificado anulables.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también isOverridable().
[invokable] void QWebEngineCertificateError::rejectCertificate()
Rechaza el certificado y aborta la carga de la URL solicitada.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
© 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.
