QSslCertificate Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein `QSslCertificate`, indem es die in ` format ` kodierten Daten aus ` device ` liest und das erste gefundene Zertifikat verwendet. Sie können später die Methode ` isNull()` aufrufen, um zu überprüfen, ob ` device ` ein Zertifikat enthielt und ob dieses Zertifikat erfolgreich geladen wurde.

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

Erstellt ein `QSslCertificate`, indem die als ` format ` kodierte Datei ` data ` geparst und das erste verfügbare Zertifikat verwendet wird. Sie können später die Methode ` isNull()` aufrufen, um zu prüfen, ob die Datei ` data ` ein Zertifikat enthielt und ob dieses Zertifikat erfolgreich geladen wurde.

QSslCertificate::QSslCertificate(const QSslCertificate &other)

Erstellt eine identische Kopie von „ other “.

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

Erstellt 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, wodurch es zu einem Nullzertifikat wird.

Siehe auch isNull().

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

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

QDateTime QSslCertificate::effectiveDate() const

Gibt das Datums- und Zeitangabe zurück, zu der das Zertifikat gültig wird, oder ein leeres „ QDateTime “, falls es sich um ein Null-Zertifikat handelt.

Siehe auch expiryDate().

QDateTime QSslCertificate::expiryDate() const

Gibt das Datum und die Uhrzeit zurück, zu denen 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 zurück, die die X.509-Erweiterungen dieses Zertifikats enthält.

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

Sucht alle Zertifikate in „ data “, die im angegebenen Format „ format “ kodiert sind, analysiert sie 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 alle Zertifikate unter device, die im angegebenen Format „ format “ kodiert sind, analysiert sie und gibt sie in einer Liste von Zertifikaten zurück.

Siehe auch fromData().

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

Liest die Daten aus der Datei „ filePath “, analysiert alle Zertifikate, die im angegebenen „ format “ kodiert sind, und gibt eine Liste von „ QSslCertificate “-Objekten zurück.

Wenn „ filePath “ keine reguläre Datei ist, gibt diese Methode eine leere Liste zurück.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch fromData() und fromPath().

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

Durchsucht alle Dateien im Verzeichnis „ path “ nach Zertifikaten, die im angegebenen „ format “ kodiert sind, und gibt diese in einer Liste zurück. „ path “ muss eine Datei oder ein Muster sein, das mit einer oder mehreren Dateien übereinstimmt, wie unter „ 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, sofern vorhanden; andernfalls „ nullptr “.

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

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

Importiert eine PKCS#12-Datei (pfx) aus dem angegebenen „ device “. Eine PKCS#12-Datei ist ein Bündel, das mehrere Zertifikate und Schlüssel enthalten kann. Diese Methode liest ein einzelnes „ key “, dessen „ certificate “ sowie alle zugehörigen „ caCertificates “ aus dem Bündel aus. Wenn ein „ passPhrase “ angegeben wird, wird dieser zum Entschlüsseln 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 Sperrliste 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 erstellt „ QSslCertificate “ ein Null-Zertifikat.

Siehe auch clear().

bool QSslCertificate::isSelfSigned() const

Gibt „ true “ zurück, wenn dieses Zertifikat selbstsigniert ist; andernfalls gibt es „ false “ zurück.

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

QString QSslCertificate::issuerDisplayName() const

Gibt einen Namen zurück, der den Emittenten beschreibt. Es wird die „ QSslCertificate::CommonName “ zurückgegeben, sofern verfügbar; 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 im Zertifikat keine Informationen zu „ subject “ vorhanden sind. Es kann mehr als einen Eintrag pro Typ 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 im Zertifikat keine Informationen für „ attribute “ vorhanden sind. Für ein Attribut kann es mehrere Einträge geben.

Siehe auch subjectInfo().

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

Gibt eine Liste der Attribute zurück, für die in den Ausstellerinformationen dieses Zertifikats Werte vorhanden sind. Auf die mit einem bestimmten Attribut verknüpften Informationen kann mithilfe der Methode „ issuerInfo()“ zugegriffen werden. Beachten Sie, dass diese Liste möglicherweise OIDs für Elemente enthält, 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 Seriennummer des Zertifikats als Zeichenfolge im Hexadezimalformat zurück.

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

Gibt die Liste der alternativen Betreffnamen 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 des verbundenen Gegenübers abgeglichen, wenn entweder in den Subjektinformationen für CommonName kein gültiger Hostname definiert ist oder der Name in den Subjektinformationen nicht mit dem Hostnamen des Gegenübers übereinstimmt.

Siehe auch subjectInfo().

QString QSslCertificate::subjectDisplayName() const

Gibt einen Namen zurück, der das Thema beschreibt. Es wird der „ QSslCertificate::CommonName “ zurückgegeben, sofern verfügbar; andernfalls wird auf den ersten „ QSslCertificate::Organization “ oder den ersten „ QSslCertificate::OrganizationalUnitName “ zurückgegriffen.

Siehe auch subjectInfo().

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

Gibt die Informationen für die „ subject “ zurück oder eine leere Liste, wenn im Zertifikat keine Informationen für „ subject “ vorhanden sind. Es kann mehr als einen Eintrag pro Typ geben.

Siehe auch issuerInfo().

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

Gibt die Informationen zum Subjekt für „ attribute “ zurück oder eine leere Liste, wenn im Zertifikat keine Informationen für „ attribute “ vorhanden sind. Für ein Attribut kann es mehrere Einträge geben.

Siehe auch issuerInfo().

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

Gibt eine Liste der Attribute zurück, für die in den Betreffendeninformationen dieses Zertifikats Werte vorhanden sind. Auf die mit einem bestimmten Attribut verknüpften Informationen kann über die Methode „ subjectInfo()“ zugegriffen werden. Beachten Sie, dass diese Liste möglicherweise OIDs für Elemente enthält, die dem SSL-Backend nicht bekannt sind.

Siehe auch ` subjectInfo()`.

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

Ersetzt diese Zertifikatsinstanz durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QByteArray QSslCertificate::toDer() const

Gibt dieses Zertifikat in einer in DER (binär) kodierten Darstellung zurück.

QByteArray QSslCertificate::toPem() const

Gibt dieses Zertifikat in einer in PEM (Base64) kodierten Darstellung zurück.

QString QSslCertificate::toText() const

Gibt dieses Zertifikat in einer für Menschen lesbaren Textdarstellung 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 über den Parameter „ certificateChain “ übergeben. Das erste Zertifikat in der Liste sollte das Endzertifikat der zu überprüfenden Kette sein. Wenn „ hostName “ angegeben ist, wird zusätzlich geprüft, ob das Zertifikat für den angegebenen Hostnamen gültig ist.

Beachten Sie, dass das Stammzertifikat (CA-Zertifikat) nicht in der zu überprüfenden Liste enthalten sein sollte; dieses wird automatisch anhand der in der Standard- QSslConfiguration angegebenen CA-Liste sowie, sofern möglich, anhand der unter Unix und Windows bei Bedarf geladenen CA-Zertifikate ermittelt.

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, sodass beide Zertifikate identisch sind.

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

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