QWebEngineCertificateError Class
La classe QWebEngineCertificateError fournit des informations sur une erreur de certificat. Plus d'informations...
| En-tête : | #include <QWebEngineCertificateError> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
| En QML : | webEngineCertificateError |
Types publics
| enum | Type { Ok, SslPinnedKeyNotInCertificateChain, CertificateCommonNameInvalid, CertificateDateInvalid, CertificateAuthorityInvalid, …, CertificateSymantecLegacy } |
Propriétés
|
Fonctions publiques
| 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 |
Description détaillée
Fournit des informations sur une erreur de certificat. Cette classe est utilisée comme paramètre de QWebEnginePage::certificateError().
Type de membre Documentation
enum QWebEngineCertificateError::Type
Cette énumération décrit le type d'erreur de certificat rencontré.
Les valeurs de ce type d'enum correspondent aux erreurs SSL fournies par Chromium. Les valeurs de QSslError::SslError ne sont pas utilisées directement, car les catégories d'erreurs de Qt XML ne peuvent pas être mises en correspondance avec les catégories d'erreurs de Chromium.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QWebEngineCertificateError::Ok | 0 | Il n'y a pas eu d'erreur de certificat. |
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain | -150 | Le certificat ne correspond pas aux clés publiques intégrées épinglées pour le nom d'hôte. |
QWebEngineCertificateError::CertificateCommonNameInvalid | -200 | Le nom commun du certificat ne correspond pas au nom d'hôte. |
QWebEngineCertificateError::CertificateDateInvalid | -201 | Le certificat n'est pas valide à la date et à l'heure actuelles. |
QWebEngineCertificateError::CertificateAuthorityInvalid | -202 | Le certificat n'est pas signé par une autorité de confiance. |
QWebEngineCertificateError::CertificateContainsErrors | -203 | Le certificat contient des erreurs. |
QWebEngineCertificateError::CertificateNoRevocationMechanism | -204 | Le certificat ne dispose d'aucun mécanisme permettant de déterminer s'il a été révoqué. |
QWebEngineCertificateError::CertificateUnableToCheckRevocation | -205 | Les informations relatives à la révocation du certificat ne sont pas disponibles. |
QWebEngineCertificateError::CertificateRevoked | -206 | Le certificat a été révoqué. |
QWebEngineCertificateError::CertificateInvalid | -207 | Le certificat n'est pas valide. |
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm | -208 | Le certificat est signé à l'aide d'un algorithme de signature faible. |
QWebEngineCertificateError::CertificateNonUniqueName | -210 | Le nom d'hôte spécifié dans le certificat n'est pas unique. |
QWebEngineCertificateError::CertificateWeakKey | -211 | Le certificat contient une clé faible. |
QWebEngineCertificateError::CertificateNameConstraintViolation | -212 | Le certificat revendique des noms DNS qui ne respectent pas les contraintes de nom. |
QWebEngineCertificateError::CertificateValidityTooLong (since Qt 5.7) | -213 | La période de validité du certificat est trop longue. |
QWebEngineCertificateError::CertificateTransparencyRequired (since Qt 5.8) | -214 | La transparence des certificats était requise pour cette connexion, mais le serveur n'a pas fourni d'informations CT conformes à la politique. |
QWebEngineCertificateError::CertificateKnownInterceptionBlocked (since Qt 5.15) | -217 | Le certificat est connu pour être utilisé à des fins d'interception par une entité autre que le propriétaire du dispositif. |
QWebEngineCertificateError::SslObsoleteVersion (since Qt 6.2, deprecated in Qt 6.4) | -218 | La connexion utilise une version obsolète de SSL/TLS. |
QWebEngineCertificateError::CertificateSymantecLegacy (since Qt 6.2, deprecated in Qt 6.11) | -215 | Le certificat est un ancien certificat Symantec qui n'est plus valide. |
Documentation sur les propriétés
[read-only] description : const QString
Cette propriété contient une brève description localisée et lisible par l'homme de l'erreur.
Fonctions d'accès :
| QString | description() const |
Voir également url() et isOverridable().
[read-only, since 6.8] isMainFrame : const bool
Indique si l'erreur de certificat provient du cadre principal. Si false, l'erreur provient d'une sous-ressource et doit probablement être rejetée sans intervention de l'utilisateur.
Cette propriété a été introduite dans Qt 6.8.
Fonctions d'accès :
| bool | isMainFrame() const |
[read-only] overridable : const bool
Cette propriété indique si cette erreur peut être ignorée et acceptée.
Fonctions d'accès :
| bool | isOverridable() const |
Voir aussi description().
[read-only] type : const Type
Cette propriété contient le type d'erreur.
Fonctions d'accès :
| QWebEngineCertificateError::Type | type() const |
Voir aussi description() et isOverridable().
[read-only] url : const QUrl
Cette propriété contient l'URL qui a déclenché l'erreur.
Fonctions d'accès :
| QUrl | url() const |
Voir aussi description().
Documentation des fonctions membres
[invokable] void QWebEngineCertificateError::acceptCertificate()
Accepte le certificat et poursuit le chargement de l'URL demandée.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QList<QSslCertificate> QWebEngineCertificateError::certificateChain() const
Renvoie la chaîne de certificats numériques de l'homologue.
La chaîne commence par le certificat immédiat de l'homologue et se termine par le certificat de l'autorité de certification.
[invokable] void QWebEngineCertificateError::defer()
Marque l'erreur de certificat pour un traitement différé.
Cette fonction doit être appelée lorsqu'il est nécessaire de reporter la décision d'accepter ou non un certificat, par exemple, en attendant les commentaires de l'utilisateur. Lorsqu'elle est appelée, la fonction met en pause la demande d'URL jusqu'à ce que acceptCertificate() ou rejectCertificate() soit appelé.
Remarque : il n'est possible de différer que les erreurs de certificat qui peuvent être surchargées.
Remarque : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également isOverridable().
[invokable] void QWebEngineCertificateError::rejectCertificate()
Rejette le certificat et interrompt le chargement de l'URL demandée.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
© 2026 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.
