QWebEngineCertificateError Class

The QWebEngineCertificateError class provides information about a certificate error. More...

Header:	#include <QWebEngineCertificateError>
CMake:	find_package(Qt6 COMPONENTS WebEngineCore REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake:	QT += webenginecore
Since:	Qt 5.4
Instantiated By:	WebEngineCertificateError

• List of all members, including inherited members

Public Types

enum	Type { SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, CertificateContainsErrors, …, CertificateSymantecLegacy }

Properties

• overridable : const bool

Public Functions

void	acceptCertificate()
QList<QSslCertificate>	certificateChain() const
void	defer()
QString	description() const
bool	isOverridable() const
void	rejectCertificate()
QWebEngineCertificateError::Type	type() const
QUrl	url() const

Detailed Description

Provides information about a certificate error. This class is used as a parameter of QWebEnginePage::certificateError().

Member Type Documentation

enum QWebEngineCertificateError::Type

This enum describes the type of certificate error encountered.

The values of this enum type match the SSL errors Chromium provides. QSslError::SslError values are not used directly, because the Qt error categories cannot be mapped to the Chromium error categories.

Constant	Value	Description
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain	-150	The certificate did not match the built-in public keys pinned for the host name.
QWebEngineCertificateError::CertificateCommonNameInvalid	-200	The certificate's common name did not match the host name.
QWebEngineCertificateError::CertificateDateInvalid	-201	The certificate is not valid at the current date and time.
QWebEngineCertificateError::CertificateAuthorityInvalid	-202	The certificate is not signed by a trusted authority.
QWebEngineCertificateError::CertificateContainsErrors	-203	The certificate contains errors.
QWebEngineCertificateError::CertificateNoRevocationMechanism	-204	The certificate has no mechanism for determining if it has been revoked.
QWebEngineCertificateError::CertificateUnableToCheckRevocation	-205	Revocation information for the certificate is not available.
QWebEngineCertificateError::CertificateRevoked	-206	The certificate has been revoked.
QWebEngineCertificateError::CertificateInvalid	-207	The certificate is invalid.
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm	-208	The certificate is signed using a weak signature algorithm.
QWebEngineCertificateError::CertificateNonUniqueName	-210	The host name specified in the certificate is not unique.
QWebEngineCertificateError::CertificateWeakKey	-211	The certificate contains a weak key.
QWebEngineCertificateError::CertificateNameConstraintViolation	-212	The certificate claimed DNS names that are in violation of name constraints.
QWebEngineCertificateError::CertificateValidityTooLong	-213	The certificate has a validity period that is too long. (Added in Qt 5.7)
QWebEngineCertificateError::CertificateTransparencyRequired	-214	Certificate Transparency was required for this connection, but the server did not provide CT information that complied with the policy. (Added in Qt 5.8)
QWebEngineCertificateError::CertificateKnownInterceptionBlocked	-217	The certificate is known to be used for interception by an entity other the device owner. (Added in 5.15)
QWebEngineCertificateError::SslObsoleteVersion	-218	The connection uses an obsolete version of SSL/TLS. (Added in Qt 6.0)
QWebEngineCertificateError::CertificateSymantecLegacy	-215	The certificate is a legacy Symantec one that's no longer valid. (Added in Qt 6.0)

Member Function Documentation

[invokable, since 5.14] void QWebEngineCertificateError::acceptCertificate()

Accepts the certificate and continues the loading of the requested URL.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.14.

[since 5.14] QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const

Returns the peer's chain of digital certificates.

Chain starts with the peer's immediate certificate and ending with the CA's certificate.

This function was introduced in Qt 5.14.

[invokable, since 5.14] void QWebEngineCertificateError::defer()

Marks the certificate error for delayed handling.

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

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.14.

See also isOverridable().

QString QWebEngineCertificateError::description() const

Returns a short localized human-readable description of the error.

Note: Getter function for property description.

See also url() and isOverridable().

[invokable, since 5.14] void QWebEngineCertificateError::rejectCertificate()

Rejects the certificate and aborts the loading of the requested URL.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.14.

QWebEngineCertificateError::Type QWebEngineCertificateError::type() const

Returns the type of the error.

Note: Getter function for property type.

See also description() and isOverridable().

QUrl QWebEngineCertificateError::url() const

Returns the URL that triggered the error.

Note: Getter function for property url.

See also description().