QSslCertificate Class

Documentation des fonctions membres

[explicit] QSslCertificate::QSslCertificate(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Construit un QSslCertificate en lisant les données encodées format à partir de device et en utilisant le premier certificat trouvé. Vous pouvez ensuite appeler isNull() pour savoir si device contient un certificat et si ce certificat a été chargé avec succès.

[explicit] QSslCertificate::QSslCertificate(const QByteArray &data = QByteArray(), QSsl::EncodingFormat format = QSsl::Pem)

Construit un QSslCertificate en analysant le code format encodé data et en utilisant le premier certificat disponible trouvé. Vous pouvez ultérieurement appeler isNull() pour voir si data contient un certificat et si ce certificat a été chargé avec succès.

QSslCertificate::QSslCertificate(const QSslCertificate &other)

Construit une copie identique de other.

[constexpr noexcept, since 6.8] QSslCertificate::QSslCertificate(QSslCertificate &&other)

Move-construit un nouveau QSslCertificate à partir de other.

Cette fonction a été introduite dans Qt 6.8.

[noexcept] QSslCertificate::~QSslCertificate()

Détruit le site QSslCertificate.

void QSslCertificate::clear()

Efface le contenu de ce certificat et en fait un certificat nul.

Voir aussi isNull().

QByteArray QSslCertificate::digest(QCryptographicHash::Algorithm algorithm = QCryptographicHash::Md5) const

Renvoie un condensé cryptographique de ce certificat. Par défaut, un condensé MD5 sera généré, mais vous pouvez également spécifier un condensé personnalisé algorithm.

QDateTime QSslCertificate::effectiveDate() const

Renvoie la date à laquelle le certificat devient valide, ou un QDateTime vide s'il s'agit d'un certificat nul.

Voir aussi expiryDate().

QDateTime QSslCertificate::expiryDate() const

Renvoie la date d'expiration du certificat, ou un QDateTime vide s'il s'agit d'un certificat nul.

Voir aussi effectiveDate().

QList<QSslCertificateExtension> QSslCertificate::extensions() const

Renvoie une liste contenant les extensions X509 de ce certificat.

[static] QList<QSslCertificate> QSslCertificate::fromData(const QByteArray &data, QSsl::EncodingFormat format = QSsl::Pem)

Recherche et analyse tous les certificats dans data qui sont encodés dans le format spécifié et les renvoie dans une liste de certificats.

Voir aussi fromDevice().

[static] QList<QSslCertificate> QSslCertificate::fromDevice(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Recherche et analyse tous les certificats dans device qui sont encodés dans le format spécifié et les renvoie dans une liste de certificats.

Voir aussi fromData().

[static, since 6.10] QList<QSslCertificate> QSslCertificate::fromFile(const QString &filePath, QSsl::EncodingFormat format = QSsl::Pem)

Lit les données du fichier filePath et analyse tous les certificats qui sont encodés dans le fichier format spécifié et renvoie une liste d'objets QSslCertificate.

Si filePath n'est pas un fichier normal, cette méthode renverra une liste vide.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi fromData() et fromPath().

[static] QList<QSslCertificate> QSslCertificate::fromPath(const QString &path, QSsl::EncodingFormat format = QSsl::Pem, QSslCertificate::PatternSyntax syntax = PatternSyntax::FixedString)

Recherche dans tous les fichiers du site path les certificats encodés dans le format spécifié format et les renvoie dans une liste. path doit être un fichier ou un motif correspondant à un ou plusieurs fichiers, comme spécifié par syntax.

Exemple :

const auto certs = QSslCertificate::fromPath("C:/ssl/certificate.*.pem", QSsl::Pem, QSslCertificate::Wildcard) ;for(const QSslCertificate &cert: certs) {    qDebug() << cert.issuerInfo(QSslCertificate::Organization);
}

Voir aussi fromData().

Qt::HANDLE QSslCertificate::handle() const

Renvoie un pointeur sur l'identifiant du certificat natif, s'il y en a un, sinon nullptr.

Vous pouvez utiliser cet identifiant, ainsi que l'API native, pour accéder à des informations étendues sur le certificat.

[static] bool QSslCertificate::importPkcs12(QIODevice *device, QSslKey *key, QSslCertificate *certificate, QList<QSslCertificate> *caCertificates = nullptr, const QByteArray &passPhrase = QByteArray())

Importe un fichier PKCS#12 (pfx) à partir du site device spécifié. Un fichier PKCS#12 est un paquet qui peut contenir un certain nombre de certificats et de clés. Cette méthode lit un seul key, son certificate et tout caCertificates associé à partir du paquet. Si un passPhrase est spécifié, il sera utilisé pour décrypter l'ensemble. Retourne true si le fichier PKCS#12 a été chargé avec succès.

bool QSslCertificate::isBlacklisted() const

Renvoie true si ce certificat est sur liste noire ; sinon, renvoie false.

Voir aussi isNull().

bool QSslCertificate::isNull() const

Renvoie true s'il s'agit d'un certificat nul (c'est-à-dire un certificat sans contenu) ; sinon, il renvoie false.

Par défaut, QSslCertificate construit un certificat nul.

Voir aussi clear().

bool QSslCertificate::isSelfSigned() const

Renvoie true si ce certificat est auto-signé, sinon renvoie false.

Un certificat est considéré comme auto-signé si l'émetteur et le sujet sont identiques.

QString QSslCertificate::issuerDisplayName() const

Renvoie un nom qui décrit l'émetteur. Il renvoie l'adresse QSslCertificate::CommonName si elle est disponible, sinon il revient à la première adresse QSslCertificate::Organization ou à la première adresse QSslCertificate::OrganizationalUnitName.

Voir aussi issuerInfo().

QStringList QSslCertificate::issuerInfo(QSslCertificate::SubjectInfo subject) const

Renvoie les informations relatives à l'émetteur du certificat subject, ou une liste vide si le certificat ne contient aucune information sur subject. Il peut y avoir plus d'une entrée de chaque type.

Voir aussi subjectInfo().

QStringList QSslCertificate::issuerInfo(const QByteArray &attribute) const

Renvoie les informations relatives à l'émetteur du certificat pour attribute, ou une liste vide s'il n'y a pas d'informations pour attribute dans le certificat. Il peut y avoir plus d'une entrée pour un attribut.

Voir aussi subjectInfo().

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

Renvoie une liste des attributs dont les valeurs figurent dans les informations relatives à l'émetteur de ce certificat. Les informations associées à un attribut donné sont accessibles à l'aide de la méthode issuerInfo(). Notez que cette liste peut inclure les OID de tout élément qui n'est pas connu par le backend SSL.

Voir aussi subjectInfo().

QSslKey QSslCertificate::publicKey() const

Renvoie la clé publique du sujet du certificat.

QByteArray QSslCertificate::serialNumber() const

Renvoie la chaîne du numéro de série du certificat au format hexadécimal.

QMultiMap<QSsl::AlternativeNameEntryType, QString> QSslCertificate::subjectAlternativeNames() const

Renvoie la liste des noms de sujets alternatifs pour ce certificat. Les noms alternatifs contiennent généralement des noms d'hôtes, éventuellement avec des caractères génériques, qui sont valides pour ce certificat.

Ces noms sont testés par rapport au nom d'hôte de l'homologue connecté, si les informations sur l'objet de CommonName ne définissent pas un nom d'hôte valide, ou si le nom des informations sur l'objet ne correspond pas au nom d'hôte de l'homologue.

Voir aussi subjectInfo().

QString QSslCertificate::subjectDisplayName() const

Renvoie un nom qui décrit le sujet. Il renvoie l'adresse QSslCertificate::CommonName si elle est disponible, sinon il revient à la première adresse QSslCertificate::Organization ou à la première adresse QSslCertificate::OrganizationalUnitName.

Voir aussi subjectInfo().

QStringList QSslCertificate::subjectInfo(QSslCertificate::SubjectInfo subject) const

Renvoie les informations relatives à subject ou une liste vide si le certificat ne contient pas d'informations relatives à subject. Il peut y avoir plus d'une entrée de chaque type.

Voir aussi issuerInfo().

QStringList QSslCertificate::subjectInfo(const QByteArray &attribute) const

Renvoie les informations relatives à l'objet de attribute ou une liste vide si le certificat ne contient pas d'informations relatives à attribute. Il peut y avoir plus d'une entrée pour un attribut.

Voir aussi issuerInfo().

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

Renvoie une liste des attributs qui ont des valeurs dans les informations relatives à l'objet de ce certificat. Les informations associées à un attribut donné sont accessibles à l'aide de la méthode subjectInfo(). Notez que cette liste peut inclure les OID de tout élément qui n'est pas connu par le backend SSL.

Voir aussi subjectInfo().

[noexcept] void QSslCertificate::swap(QSslCertificate &other)

Remplace cette instance de certificat par other. Cette opération est très rapide et n'échoue jamais.

QByteArray QSslCertificate::toDer() const

Renvoie ce certificat converti en une représentation codée en DER (binaire).

QByteArray QSslCertificate::toPem() const

Renvoie ce certificat converti en une représentation codée en PEM (Base64).

QString QSslCertificate::toText() const

Renvoie ce certificat converti en une représentation textuelle lisible par l'homme.

[static] QList<QSslError> QSslCertificate::verify(const QList<QSslCertificate> &certificateChain, const QString &hostName = QString())

Vérifie une chaîne de certificats. La chaîne à vérifier est transmise dans le paramètre certificateChain. Le premier certificat de la liste doit être le certificat leaf de la chaîne à vérifier. Si hostName est spécifié, le certificat est également vérifié pour voir s'il est valide pour le nom d'hôte spécifié.

Notez que le certificat racine (CA) ne doit pas être inclus dans la liste à vérifier, car il sera recherché automatiquement à l'aide de la liste CA spécifiée dans l'adresse QSslConfiguration par défaut et, en outre, si possible, des certificats CA chargés à la demande sous Unix et Windows.

QByteArray QSslCertificate::version() const

Renvoie la chaîne de caractères de la version du certificat.

bool QSslCertificate::operator!=(const QSslCertificate &other) const

Renvoie true si ce certificat est différent de other; sinon, renvoie false.

QSslCertificate &QSslCertificate::operator=(const QSslCertificate &other)

Copie le contenu de other dans ce certificat, rendant les deux certificats identiques.

bool QSslCertificate::operator==(const QSslCertificate &other) const

Renvoie true si ce certificat est identique à other; sinon, renvoie false.