Synopsis¶

Properties¶

descriptionᅟ
isMainFrameᅟ
overridableᅟ - Whether this error can be overridden and accepted
typeᅟ
urlᅟ

Methods¶

def __init__()
def acceptCertificate()
def certificateChain()
def defer()
def description()
def isMainFrame()
def isOverridable()
def rejectCertificate()
def type()
def url()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description¶

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

class 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

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)

QWebEngineCertificateError.SslObsoleteVersion

The connection uses an obsolete version of SSL/TLS. (Added in Qt 6.2, deprecated in Qt 6.4)

QWebEngineCertificateError.CertificateSymantecLegacy

The certificate is a legacy Symantec one that’s no longer valid. (Added in Qt 6.2)

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)
QWebEngineCertificateError.SslObsoleteVersion	The connection uses an obsolete version of SSL/TLS. (Added in Qt 6.2, deprecated in Qt 6.4)
QWebEngineCertificateError.CertificateSymantecLegacy	The certificate is a legacy Symantec one that’s no longer valid. (Added in Qt 6.2)

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property descriptionᅟ: str¶

Access functions:

description()

property isMainFrameᅟ: bool¶

Returns whether the certificate error comes from the main frame. If false, the error comes from a sub-resource and most likely needs to be rejected without user input.

Access functions:

isMainFrame()

property overridableᅟ: bool¶

This property holds Whether this error can be overridden and accepted..

See also

description()

Access functions:

isOverridable()

property typeᅟ: QWebEngineCertificateError.Type¶

Access functions:

type()

property urlᅟ: QUrl¶

Access functions:

url()

__init__(other)¶

Parameters:: other – QWebEngineCertificateError

acceptCertificate()¶

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

certificateChain()¶

Return type:: .list of QSslCertificate

Returns the peer’s chain of digital certificates.

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

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

It is only possible to defer overridable certificate errors.