WebEngineCertificateError QML Type

A utility type for ignoring certificate errors or rejecting erroneous certificates. More...

Import Statement: import QtWebEngine 1.10
Since: QtWebEngine 1.1

Properties

Methods

Detailed Description

This QML type contains information about a certificate error that occurred. The error property holds the reason that the error occurred and the description property holds a short localized description of the error. The url property holds the URL that triggered the error.

The certificate can be rejected by calling rejectCertificate, which will stop loading the web engine request. By default, an invalid certificate will be automatically rejected.

The certificate error can be ignored by calling ignoreCertificateError, which will resume loading the request.

It is possible to defer the decision of rejecting a certificate by calling defer, which is useful when waiting for user input.

See also WebEngineView::certificateError.

Property Documentation

[read-only] description : string

A short localized human-readable description of the error.


[read-only] error : enumeration

The type of the error.

ConstantDescription
WebEngineCertificateError.SslPinnedKeyNotInCertificateChainThe certificate did not match the built-in public keys pinned for the host name.
WebEngineCertificateError.CertificateCommonNameInvalidThe certificate's common name did not match the host name.
WebEngineCertificateError.CertificateDateInvalidThe certificate is not valid at the current date and time.
WebEngineCertificateError.CertificateAuthorityInvalidThe certificate is not signed by a trusted authority.
WebEngineCertificateError.CertificateContainsErrorsThe certificate contains errors.
WebEngineCertificateError.CertificateNoRevocationMechanismThe certificate has no mechanism for determining if it has been revoked.
WebEngineCertificateError.CertificateUnableToCheckRevocationRevocation information for the certificate is not available.
WebEngineCertificateError.CertificateRevokedThe certificate has been revoked.
WebEngineCertificateError.CertificateInvalidThe certificate is invalid.
WebEngineCertificateError.CertificateWeakSignatureAlgorithmThe certificate is signed using a weak signature algorithm.
WebEngineCertificateError.CertificateNonUniqueNameThe host name specified in the certificate is not unique.
WebEngineCertificateError.CertificateWeakKeyThe certificate contains a weak key.
WebEngineCertificateError.CertificateNameConstraintViolationThe certificate claimed DNS names that are in violation of name constraints.
WebEngineCertificateError.CertificateValidityTooLongThe certificate has a validity period that is too long. (Added in 5.7)
WebEngineCertificateError.CertificateTransparencyRequiredCertificate Transparency was required for this connection, but the server did not provide CT information that complied with the policy. (Added in 5.8)
WebEngineCertificateError.CertificateKnownInterceptionBlockedThe certificate is known to be used for interception by an entity other the device owner. (Added in 5.15)

[read-only] overridable : bool

A boolean that indicates whether the certificate error can be overridden and ignored.


[read-only] url : url

The URL that triggered the error.


Method Documentation

void defer()

This function should be called when there is a need to postpone the decision whether to ignore a certificate error, for example, while waiting for user input. When called, the function pauses the URL request until WebEngineCertificateError::ignoreCertificateError() or WebEngineCertificateError::rejectCertificate() is called.


void ignoreCertificateError()

The certificate error is ignored, and the web engine view continues to load the requested URL.


void rejectCertificate()

The certificate is rejected, and the web engine view stops loading the requested URL.


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