QSslCertificate Class

Dokumentation der Mitgliederfunktionen

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

Konstruiert ein QSslCertificate, indem es format kodierte Daten von device liest und das erste gefundene Zertifikat verwendet. Sie können später isNull() aufrufen, um festzustellen, ob device ein Zertifikat enthält und ob dieses Zertifikat erfolgreich geladen wurde.

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

Konstruiert ein QSslCertificate, indem es die format kodierte data analysiert und das erste gefundene Zertifikat verwendet. Sie können später isNull() aufrufen, um zu sehen, ob data ein Zertifikat enthält und ob dieses Zertifikat erfolgreich geladen wurde.

QSslCertificate::QSslCertificate(const QSslCertificate &other)

Konstruiert eine identische Kopie von other.

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

Move-konstruiert ein neues QSslCertificate aus other.

Diese Funktion wurde in Qt 6.8 eingeführt.

[noexcept] QSslCertificate::~QSslCertificate()

Zerstört die QSslCertificate.

void QSslCertificate::clear()

Löscht den Inhalt dieses Zertifikats und macht es zu einem Null-Zertifikat.

Siehe auch isNull().

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

Gibt einen kryptografischen Digest dieses Zertifikats zurück. Standardmäßig wird ein MD5-Digest generiert, Sie können aber auch einen benutzerdefinierten algorithm angeben.

QDateTime QSslCertificate::effectiveDate() const

Gibt den Zeitpunkt zurück, an dem das Zertifikat gültig wird, oder ein leeres QDateTime, wenn es sich um ein Null-Zertifikat handelt.

Siehe auch expiryDate().

QDateTime QSslCertificate::expiryDate() const

Gibt den Zeitpunkt zurück, an dem das Zertifikat abläuft, oder ein leeres QDateTime, wenn es sich um ein Null-Zertifikat handelt.

Siehe auch effectiveDate().

QList<QSslCertificateExtension> QSslCertificate::extensions() const

Gibt eine Liste mit den X509-Erweiterungen dieses Zertifikats zurück.

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

Sucht und parst alle Zertifikate in data, die in der angegebenen format kodiert sind, und gibt sie in einer Liste von Zertifikaten zurück.

Siehe auch fromDevice().

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

Sucht und parst alle Zertifikate in device, die in der angegebenen format kodiert sind, und gibt sie in einer Liste von Zertifikaten zurück.

Siehe auch fromData().

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

Durchsucht alle Dateien in path nach Zertifikaten, die im angegebenen format kodiert sind, und gibt sie in einer Liste zurück. path muss eine Datei oder ein Muster sein, das mit einer oder mehreren Dateien übereinstimmt, wie durch syntax angegeben.

Beispiel:

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

Siehe auch fromData().

Qt::HANDLE QSslCertificate::handle() const

Gibt einen Zeiger auf das native Zertifikats-Handle zurück, falls eines vorhanden ist, andernfalls nullptr.

Sie können dieses Handle zusammen mit der nativen API verwenden, um auf erweiterte Informationen über das Zertifikat zuzugreifen.

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

Importiert eine PKCS#12 (pfx)-Datei von der angegebenen device. Eine PKCS#12-Datei ist ein Bundle, das eine Reihe von Zertifikaten und Schlüsseln enthalten kann. Diese Methode liest ein einzelnes key, dessen certificate und alle zugehörigen caCertificates aus dem Bündel. Wenn ein passPhrase angegeben ist, wird dieses zur Entschlüsselung des Bündels verwendet. Gibt true zurück, wenn die PKCS#12-Datei erfolgreich geladen wurde.

bool QSslCertificate::isBlacklisted() const

Gibt true zurück, wenn dieses Zertifikat auf der schwarzen Liste steht; andernfalls wird false zurückgegeben.

Siehe auch isNull().

bool QSslCertificate::isNull() const

Gibt true zurück, wenn es sich um ein Null-Zertifikat handelt (d. h. ein Zertifikat ohne Inhalt); andernfalls wird false zurückgegeben.

Standardmäßig konstruiert QSslCertificate ein Null-Zertifikat.

Siehe auch clear().

bool QSslCertificate::isSelfSigned() const

Gibt true zurück, wenn dieses Zertifikat selbstsigniert ist; andernfalls wird false zurückgegeben.

Ein Zertifikat gilt als selbstsigniert, wenn Aussteller und Betreff identisch sind.

QString QSslCertificate::issuerDisplayName() const

Gibt einen Namen zurück, der den Emittenten beschreibt. Falls vorhanden, wird QSslCertificate::CommonName zurückgegeben, andernfalls wird auf die erste QSslCertificate::Organization oder die erste QSslCertificate::OrganizationalUnitName zurückgegriffen.

Siehe auch issuerInfo().

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

Gibt die Ausstellerinformationen für subject aus dem Zertifikat zurück, oder eine leere Liste, wenn das Zertifikat keine Informationen für subject enthält. Für jeden Typ kann es mehr als einen Eintrag geben.

Siehe auch subjectInfo().

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

Gibt die Ausstellerinformationen für attribute aus dem Zertifikat zurück, oder eine leere Liste, wenn das Zertifikat keine Informationen für attribute enthält. Es kann mehr als einen Eintrag für ein Attribut geben.

Siehe auch subjectInfo().

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

Gibt eine Liste der Attribute zurück, die Werte in den Ausstellerinformationen dieses Zertifikats haben. Auf die mit einem bestimmten Attribut verbundenen Informationen kann mit der Methode issuerInfo() zugegriffen werden. Beachten Sie, dass diese Liste die OIDs für alle Elemente enthalten kann, die dem SSL-Backend nicht bekannt sind.

Siehe auch subjectInfo().

QSslKey QSslCertificate::publicKey() const

Gibt den öffentlichen Schlüssel des Zertifikatsinhabers zurück.

QByteArray QSslCertificate::serialNumber() const

Gibt die Zeichenfolge der Seriennummer des Zertifikats im Hexadezimalformat zurück.

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

Gibt die Liste der alternativen Subject-Namen für dieses Zertifikat zurück. Die alternativen Namen enthalten in der Regel Hostnamen, optional mit Platzhaltern, die für dieses Zertifikat gültig sind.

Diese Namen werden mit dem Hostnamen der verbundenen Gegenstelle verglichen, wenn entweder die Subject-Informationen für CommonName keinen gültigen Hostnamen definieren oder der Name der Subject-Info nicht mit dem Hostnamen der Gegenstelle übereinstimmt.

Siehe auch subjectInfo().

QString QSslCertificate::subjectDisplayName() const

Gibt einen Namen zurück, der das Thema beschreibt. Falls vorhanden, wird QSslCertificate::CommonName zurückgegeben, andernfalls wird auf die erste QSslCertificate::Organization oder die erste QSslCertificate::OrganizationalUnitName zurückgegriffen.

Siehe auch subjectInfo().

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

Gibt die Informationen für subject zurück, oder eine leere Liste, wenn das Zertifikat keine Informationen für subject enthält. Für jeden Typ kann es mehr als einen Eintrag geben.

Siehe auch issuerInfo().

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

Gibt die Betreff-Informationen für attribute zurück, oder eine leere Liste, wenn das Zertifikat keine Informationen für attribute enthält. Es kann mehr als einen Eintrag für ein Attribut geben.

Siehe auch issuerInfo().

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

Gibt eine Liste der Attribute zurück, die Werte in den Betreffinformationen dieses Zertifikats haben. Auf die mit einem bestimmten Attribut verbundenen Informationen kann mit der Methode subjectInfo() zugegriffen werden. Beachten Sie, dass diese Liste die OIDs für alle Elemente enthalten kann, die dem SSL-Backend nicht bekannt sind.

Siehe auch subjectInfo().

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

Tauscht diese Zertifikatsinstanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QByteArray QSslCertificate::toDer() const

Gibt dieses Zertifikat in eine DER (binär)-kodierte Darstellung zurück.

QByteArray QSslCertificate::toPem() const

Gibt dieses Zertifikat konvertiert in eine PEM (Base64)-kodierte Darstellung zurück.

QString QSslCertificate::toText() const

Gibt dieses Zertifikat in eine für den Menschen lesbare Textdarstellung umgewandelt zurück.

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

Überprüft eine Zertifikatskette. Die zu überprüfende Kette wird mit dem Parameter certificateChain übergeben. Das erste Zertifikat in der Liste sollte das Blattzertifikat der zu überprüfenden Kette sein. Wenn hostName angegeben ist, wird das Zertifikat auch daraufhin überprüft, ob es für den angegebenen Hostnamen gültig ist.

Beachten Sie, dass das Root-Zertifikat (CA-Zertifikat) nicht in die zu überprüfende Liste aufgenommen werden sollte; es wird automatisch anhand der CA-Liste gesucht, die in der Standardeinstellung QSslConfiguration angegeben ist, und zusätzlich, wenn möglich, CA-Zertifikate, die bei Bedarf unter Unix und Windows geladen werden.

QByteArray QSslCertificate::version() const

Gibt die Versionszeichenfolge des Zertifikats zurück.

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

Gibt true zurück, wenn dieses Zertifikat nicht mit other übereinstimmt; andernfalls wird false zurückgegeben.

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

Kopiert den Inhalt von other in dieses Zertifikat, wodurch die beiden Zertifikate identisch werden.

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

Gibt true zurück, wenn dieses Zertifikat mit other identisch ist; andernfalls wird false zurückgegeben.