En esta página

webEngineCertificateError QML Value Type

Un tipo de utilidad para ignorar errores de certificado o rechazar certificados erróneos. Más...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.1
In C++: QWebEngineCertificateError

Propiedades

Métodos

Descripción detallada

Este tipo QML contiene información sobre un error de certificado que se ha producido. La propiedad type contiene el motivo por el que se ha producido el error y la propiedad description contiene una breve descripción localizada del error. La propiedad url contiene la URL que ha provocado el error.

El certificado puede ser rechazado llamando a rejectCertificate(), que detendrá la carga de la petición del motor web. Por defecto, un certificado inválido será rechazado automáticamente.

El error de certificado puede ignorarse llamando a acceptCertificate(), que reanudará la carga de la solicitud.

Es posible aplazar la decisión de rechazar un certificado llamando a defer(), lo que resulta útil cuando se espera la entrada del usuario.

Véase también WebEngineView::certificateError.

Documentación de propiedades

description : string [read-only]

Una breve descripción localizada y legible por humanos del error.

overridable : bool [read-only]

Un booleano que indica si el error de certificado puede ser anulado e ignorado.

type : enumeration [read-only]

Tipo de error.

ConstanteDescripción
WebEngineCertificateError.SslPinnedKeyNotInCertificateChainEl certificado no coincide con las claves públicas incorporadas fijadas para el nombre de host.
WebEngineCertificateError.CertificateCommonNameInvalidEl nombre común del certificado no coincide con el nombre del host.
WebEngineCertificateError.CertificateDateInvalidEl certificado no es válido en la fecha y hora actuales.
WebEngineCertificateError.CertificateAuthorityInvalidEl certificado no está firmado por una autoridad de confianza.
WebEngineCertificateError.CertificateContainsErrorsEl certificado contiene errores.
WebEngineCertificateError.CertificateNoRevocationMechanismEl certificado no tiene ningún mecanismo para determinar si ha sido revocado.
WebEngineCertificateError.CertificateUnableToCheckRevocationLa información de revocación del certificado no está disponible.
WebEngineCertificateError.CertificateRevokedEl certificado ha sido revocado.
WebEngineCertificateError.CertificateInvalidEl certificado no es válido.
WebEngineCertificateError.CertificateWeakSignatureAlgorithmEl certificado está firmado con un algoritmo de firma débil.
WebEngineCertificateError.CertificateNonUniqueNameEl nombre de host especificado en el certificado no es único.
WebEngineCertificateError.CertificateWeakKeyEl certificado contiene una clave débil.
WebEngineCertificateError.CertificateNameConstraintViolationEl certificado reclama nombres DNS que infringen las restricciones de nombres.
WebEngineCertificateError.CertificateValidityTooLongEl certificado tiene un periodo de validez demasiado largo. (Añadido en 5.7)
WebEngineCertificateError.CertificateTransparencyRequiredSe requería transparencia de certificados para esta conexión, pero el servidor no proporcionó información de TC que cumpliera la política. (Añadido en 5.8)
WebEngineCertificateError.CertificateKnownInterceptionBlockedSe sabe que una entidad distinta del propietario del dispositivo utiliza el certificado para interceptarlo. (Añadido en 5.15)

url : url [read-only]

La URL que provocó el error.

Documentación del método

void acceptCertificate()

El error de certificado se ignora y la vista del motor web continúa cargando la URL solicitada.

void defer()

Esta función debe invocarse cuando sea necesario posponer la decisión de ignorar o no un error de certificado, por ejemplo, mientras se espera la entrada del usuario. Cuando se llama, la función pausa la solicitud de URL hasta que se llama a acceptCertificate() o rejectCertificate().

void rejectCertificate()

El certificado es rechazado, y la vista del motor web deja de cargar la URL solicitada.

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