QWebEngineCertificateError

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

Synopsis

Functions

• def answered ()

• def certificateChain ()

• def defer ()

• def deferred ()

• def error ()

• def errorDescription ()

• def ignoreCertificateError ()

• def isOverridable ()

• def rejectCertificate ()

• def url ()

Detailed Description

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

class PySide2.QtWebEngineWidgets.QWebEngineCertificateError(other)

PySide2.QtWebEngineWidgets.QWebEngineCertificateError(error, url, overridable, errorDescription)

Parameters:

• url – PySide2.QtCore.QUrl

• errorDescription – str

• other – PySide2.QtWebEngineWidgets.QWebEngineCertificateError

• error – int

• overridable – bool

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.Error

This enum describes the type of certificate error encountered.

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

Constant	Description
QWebEngineCertificateError.SslPinnedKeyNotInCertificateChain	The certificate did not match the built-in public keys pinned for the host name.
QWebEngineCertificateError.CertificateCommonNameInvalid	The certificate’s common name did not match the host name.
QWebEngineCertificateError.CertificateDateInvalid	The certificate is not valid at the current date and time.
QWebEngineCertificateError.CertificateAuthorityInvalid	The certificate is not signed by a trusted authority.
QWebEngineCertificateError.CertificateContainsErrors	The certificate contains errors.
QWebEngineCertificateError.CertificateNoRevocationMechanism	The certificate has no mechanism for determining if it has been revoked.
QWebEngineCertificateError.CertificateUnableToCheckRevocation	Revocation information for the certificate is not available.
QWebEngineCertificateError.CertificateRevoked	The certificate has been revoked.
QWebEngineCertificateError.CertificateInvalid	The certificate is invalid.
QWebEngineCertificateError.CertificateWeakSignatureAlgorithm	The certificate is signed using a weak signature algorithm.
QWebEngineCertificateError.CertificateNonUniqueName	The host name specified in the certificate is not unique.
QWebEngineCertificateError.CertificateWeakKey	The certificate contains a weak key.
QWebEngineCertificateError.CertificateNameConstraintViolation	The certificate claimed DNS names that are in violation of name constraints.
QWebEngineCertificateError.CertificateValidityTooLong	The certificate has a validity period that is too long. (Added in Qt 5.7)
QWebEngineCertificateError.CertificateTransparencyRequired	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	The certificate is known to be used for interception by an entity other the device owner. (Added in 5.15)

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.answered()

Return type:

bool

Returns true if the error was explicitly rejected or ignored.

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.certificateChain()

Return type:

Returns the peer’s chain of digital certificates.

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

PySide2.QtWebEngineWidgets.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 ignore a certificate error, for example, while waiting for user input. When called, the function pauses the URL request until ignoreCertificateError() or rejectCertificate() is called.

Note

It is only possible to defer overridable certificate errors.

See also

isOverridable() deferred()

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.deferred()

Return type:

bool

Returns whether the decision for error handling was delayed and the URL load was halted.

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.error()

Return type:

Error

Returns the type of the error.

See also

errorDescription() isOverridable()

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.errorDescription()

Return type:

str

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

See also

error() url() isOverridable()

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.ignoreCertificateError()

Ignores the certificate error and continues the loading of the requested URL.

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.isOverridable()

Return type:

bool

Returns whether this error can be overridden and accepted.

See also

error() errorDescription()

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.rejectCertificate()

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

PySide2.QtWebEngineWidgets.QWebEngineCertificateError.url()

Return type:

PySide2.QtCore.QUrl

Returns the URL that triggered the error.

See also

error() errorDescription()