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.

ConstanteValeurDescription de l'erreur
QWebEngineCertificateError::Ok0Il n'y a pas eu d'erreur de certificat.
QWebEngineCertificateError::SslPinnedKeyNotInCertificateChain-150Le certificat ne correspondait pas aux clés publiques intégrées épinglées pour le nom d'hôte.
QWebEngineCertificateError::CertificateCommonNameInvalid-200Le nom commun du certificat ne correspond pas au nom d'hôte.
QWebEngineCertificateError::CertificateDateInvalid-201Le certificat n'est pas valide à la date et à l'heure actuelles.
QWebEngineCertificateError::CertificateAuthorityInvalid-202Le certificat n'est pas signé par une autorité de confiance.
QWebEngineCertificateError::CertificateContainsErrors-203Le certificat contient des erreurs.
QWebEngineCertificateError::CertificateNoRevocationMechanism-204Le certificat ne dispose d'aucun mécanisme permettant de déterminer s'il a été révoqué.
QWebEngineCertificateError::CertificateUnableToCheckRevocation-205Les informations relatives à la révocation du certificat ne sont pas disponibles.
QWebEngineCertificateError::CertificateRevoked-206Le certificat a été révoqué.
QWebEngineCertificateError::CertificateInvalid-207Le certificat n'est pas valide.
QWebEngineCertificateError::CertificateWeakSignatureAlgorithm-208Le certificat est signé à l'aide d'un algorithme de signature faible.
QWebEngineCertificateError::CertificateNonUniqueName-210Le nom d'hôte spécifié dans le certificat n'est pas unique.
QWebEngineCertificateError::CertificateWeakKey-211Le certificat contient une clé faible.
QWebEngineCertificateError::CertificateNameConstraintViolation-212Le certificat revendique des noms DNS qui ne respectent pas les contraintes de nom.
QWebEngineCertificateError::CertificateValidityTooLong-213La période de validité du certificat est trop longue. (Ajouté dans Qt 5.7)
QWebEngineCertificateError::CertificateTransparencyRequired-214La transparence des certificats était requise pour cette connexion, mais le serveur n'a pas fourni d'informations CT conformes à la politique. (Ajouté dans Qt 5.8)
QWebEngineCertificateError::CertificateKnownInterceptionBlocked-217Le certificat est connu pour être utilisé à des fins d'interception par une entité autre que le propriétaire du dispositif. (Ajouté dans 5.15)
QWebEngineCertificateError::SslObsoleteVersion-218La connexion utilise une version obsolète de SSL/TLS. (Ajouté dans Qt 6.2, obsolète dans Qt 6.4)
QWebEngineCertificateError::CertificateSymantecLegacy-215Le certificat est un ancien certificat Symantec qui n'est plus valide. (Ajouté dans Qt 6.2)

Documentation sur les propriétés

[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 également 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().

QString QWebEngineCertificateError::description() const

Renvoie une brève description localisée et lisible par l'homme de l'erreur.

Remarque : fonction Getter pour la description de la propriété.

Voir aussi url() et 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.

QWebEngineCertificateError::Type QWebEngineCertificateError::type() const

Renvoie le type d'erreur.

Remarque : fonction Getter pour le type de propriété.

Voir aussi description() et isOverridable().

QUrl QWebEngineCertificateError::url() const

Renvoie l'URL qui a déclenché l'erreur.

Note : Fonction Getter pour la propriété url.

Voir aussi 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.