QWebEngineCertificateError Class
Die Klasse QWebEngineCertificateError liefert Informationen über einen Zertifikatsfehler. Mehr...
| Kopfzeile: | #include <QWebEngineCertificateError> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| In QML: | WebEngineCertificateError |
Öffentliche Typen
| enum | Type { SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, CertificateContainsErrors, …, CertificateSymantecLegacy } |
Eigenschaften
(since 6.8)isMainFrame : const bool- overridable : const bool
Öffentliche Funktionen
| void | acceptCertificate() |
| QList<QSslCertificate> | certificateChain() const |
| void | defer() |
| QString | description() const |
| bool | isMainFrame() const |
| bool | isOverridable() const |
| void | rejectCertificate() |
| QWebEngineCertificateError::Type | type() const |
| QUrl | url() const |
Detaillierte Beschreibung
Liefert Informationen über einen Zertifikatsfehler. Diese Klasse wird als Parameter von QWebEnginePage::certificateError() verwendet.
Dokumentation der Mitgliedstypen
enum QWebEngineCertificateError::Type
Diese Aufzählung beschreibt den Typ des aufgetretenen Zertifikatsfehlers.
Die Werte dieses Enum-Typs entsprechen den SSL-Fehlern, die Chromium bereitstellt. QSslError::SslError Werte werden nicht direkt verwendet, da die Qt-Fehlerkategorien nicht auf die Chromium-Fehlerkategorien abgebildet werden können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | Das Zertifikat stimmte nicht mit den eingebauten öffentlichen Schlüsseln überein, die für den Hostnamen angeheftet sind. |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | Der Common Name des Zertifikats stimmt nicht mit dem Hostnamen überein. |
QWebEngineCertificateError::CertificateDateInvalid | -201 | Das Zertifikat ist zum aktuellen Datum und zur aktuellen Uhrzeit nicht gültig. |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | Das Zertifikat ist nicht von einer vertrauenswürdigen Stelle signiert. |
QWebEngineCertificateError::CertificateContainsErrors | -203 | Das Zertifikat enthält Fehler. |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | Das Zertifikat verfügt über keinen Mechanismus, um festzustellen, ob es widerrufen wurde. |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | Es sind keine Widerrufsinformationen für das Zertifikat verfügbar. |
QWebEngineCertificateError::CertificateRevoked | -206 | Das Zertifikat wurde widerrufen. |
QWebEngineCertificateError::CertificateInvalid | -207 | Das Zertifikat ist ungültig. |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | Das Zertifikat wurde mit einem schwachen Signaturalgorithmus signiert. |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | Der im Zertifikat angegebene Hostname ist nicht eindeutig. |
QWebEngineCertificateError::CertificateWeakKey | -211 | Das Zertifikat enthält einen schwachen Schlüssel. |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | Das Zertifikat beansprucht DNS-Namen, die gegen die Namensbeschränkungen verstoßen. |
QWebEngineCertificateError::CertificateValidityTooLong | -213 | Das Zertifikat hat eine zu lange Gültigkeitsdauer. (Hinzugefügt in Qt 5.7) |
QWebEngineCertificateError::CertificateTransparencyRequired | -214 | Zertifikatstransparenz war für diese Verbindung erforderlich, aber der Server lieferte keine CT-Informationen, die der Richtlinie entsprachen. (Hinzugefügt in Qt 5.8) |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked | -217 | Es ist bekannt, dass das Zertifikat von einer anderen Entität als dem Gerätebesitzer zum Abfangen verwendet wird. (Hinzugefügt in 5.15) |
QWebEngineCertificateError::SslObsoleteVersion | -218 | Die Verbindung verwendet eine veraltete Version von SSL/TLS. (Hinzugefügt in Qt 6.2, veraltet in Qt 6.4) |
QWebEngineCertificateError::CertificateSymantecLegacy | -215 | Das Zertifikat ist ein altes Symantec-Zertifikat, das nicht mehr gültig ist. (Hinzugefügt in Qt 6.2) |
Dokumentation der Eigenschaft
[read-only, since 6.8] isMainFrame : const bool
Gibt zurück, ob der Zertifikatsfehler aus dem Hauptrahmen stammt. Falls false, stammt der Fehler von einer Sub-Ressource und muss höchstwahrscheinlich ohne Benutzereingabe zurückgewiesen werden.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
Zugriffsfunktionen:
| bool | isMainFrame() const |
[read-only] overridable : const bool
Diese Eigenschaft gibt an, ob dieser Fehler außer Kraft gesetzt und akzeptiert werden kann.
Zugriffsfunktionen:
| bool | isOverridable() const |
Siehe auch description().
Dokumentation der Mitgliedsfunktionen
[invokable] void QWebEngineCertificateError::acceptCertificate()
Akzeptiert das Zertifikat und setzt das Laden der angeforderten URL fort.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
Gibt die Kette der digitalen Zertifikate der Gegenstelle zurück.
Die Kette beginnt mit dem unmittelbaren Zertifikat der Gegenstelle und endet mit dem Zertifikat der CA.
[invokable] void QWebEngineCertificateError::defer()
Markiert den Zertifikatsfehler für eine verzögerte Behandlung.
Diese Funktion sollte aufgerufen werden, wenn die Entscheidung, ob ein Zertifikat akzeptiert werden soll, aufgeschoben werden muss, z. B. beim Warten auf Benutzereingaben. Wenn die Funktion aufgerufen wird, hält sie die URL-Anfrage an, bis acceptCertificate() oder rejectCertificate() aufgerufen wird.
Hinweis: Es ist nur möglich, überschreibbare Zertifikatsfehler aufzuschieben.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch isOverridable().
QString QWebEngineCertificateError::description() const
Gibt eine kurze, lokalisierte und für Menschen lesbare Beschreibung des Fehlers zurück.
Hinweis: Getter-Funktion für die Eigenschaftsbeschreibung.
Siehe auch url() und isOverridable().
[invokable] void QWebEngineCertificateError::rejectCertificate()
Lehnt das Zertifikat ab und bricht das Laden der angeforderten URL ab.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QWebEngineCertificateError::Type QWebEngineCertificateError::type() const
Gibt den Typ des Fehlers zurück.
Hinweis: Getter-Funktion für die Eigenschaft type.
Siehe auch description() und isOverridable().
QUrl QWebEngineCertificateError::url() const
Gibt die URL zurück, die den Fehler ausgelöst hat.
Hinweis: Getter-Funktion für die Eigenschaft url.
Siehe auch description().
© 2025 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.
