QSslCertificate Class

成员函数文档

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

通过从device 读取format 编码的数据，并使用找到的第一个证书，来构建一个QSslCertificate对象。之后，您可以调用isNull()来检查device 中是否包含证书，以及该证书是否已成功加载。

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

通过解析采用format 编码的data ，并使用第一个可用的证书来构建一个QSslCertificate。您稍后可以调用isNull()来检查data 中是否包含证书，以及该证书是否已成功加载。

QSslCertificate::QSslCertificate(const QSslCertificate &other)

创建other 的完全相同的副本。

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

从 `other` 通过 `move` 构造一个新的 `QSslCertificate`。

该函数在 Qt 6.8 中引入。

[noexcept] QSslCertificate::~QSslCertificate()

销毁QSslCertificate 。

void QSslCertificate::clear()

清除该证书的内容，使其成为空证书。

另请参阅 isNull()。

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

返回该证书的加密摘要。默认情况下，将生成 MD5 摘要，但您也可以指定自定义的algorithm 。

QDateTime QSslCertificate::effectiveDate() const

返回证书生效的日期和时间；如果该证书为空，则返回一个空的QDateTime 。

另请参阅 expiryDate()。

QDateTime QSslCertificate::expiryDate() const

返回证书的到期日期和时间；如果该证书为空，则返回一个空的QDateTime 。

另请参阅 effectiveDate()。

QList<QSslCertificateExtension> QSslCertificate::extensions() const

返回一个包含该证书的 X.509 扩展的列表。

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

查找并解析位于data 中、采用指定format 编码的所有证书，并将它们作为证书列表返回。

另请参阅 fromDevice()。

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

查找并解析位于device 中、采用指定format 编码的所有证书，并将它们作为证书列表返回。

另请参阅 fromData()。

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

从文件filePath 中读取数据，解析所有采用指定format 编码的证书，并返回一个QSslCertificate 对象的列表。

如果filePath 不是普通文件，则该方法将返回一个空列表。

该函数在 Qt 6.10 中引入。

另请参阅 fromData() 和fromPath()。

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

搜索path 目录下的所有文件，查找使用指定format 编码的证书，并将结果以列表形式返回。path 必须是一个文件，或者是一个符合syntax 中指定条件、可匹配一个或多个文件的模式。

示例：

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

另请参阅 fromData()。

Qt::HANDLE QSslCertificate::handle() const

如果存在本机证书句柄，则返回该句柄的指针；否则返回nullptr 。

您可以使用此句柄，配合原生 API，访问证书的扩展信息。

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

从指定的device 导入一个PKCS#12（pfx）文件。PKCS#12文件是一个打包文件，其中可能包含多个证书和密钥。该方法会从打包文件中读取单个key 、其certificate 以及任何相关的caCertificates 。如果指定了passPhrase ，则将使用该密钥对打包文件进行解密。 如果成功加载了 PKCS#12 文件，则返回true 。

bool QSslCertificate::isBlacklisted() const

如果该证书被列入黑名单，则返回true ；否则返回false 。

另请参阅 isNull()。

bool QSslCertificate::isNull() const

如果这是一个空证书（即内容为空的证书），则返回true ；否则返回false 。

默认情况下，QSslCertificate 会生成一个空证书。

另请参阅 clear()。

bool QSslCertificate::isSelfSigned() const

如果该证书为自签名证书，则返回true ；否则返回false 。

当证书的签发者和主体完全一致时，该证书被视为自签名证书。

QString QSslCertificate::issuerDisplayName() const

返回一个描述发行者的名称。如果可用，则返回“QSslCertificate::CommonName ”；否则，将回退到第一个“QSslCertificate::Organization ”或第一个“QSslCertificate::OrganizationalUnitName ”。

另请参阅 issuerInfo()。

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

返回证书中关于“subject ”的签发者信息；如果证书中没有关于“subject ”的信息，则返回一个空列表。每种类型的条目可能有多个。

另请参阅 subjectInfo()。

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

从证书中返回attribute 的签发者信息；如果证书中没有attribute 的相关信息，则返回一个空列表。一个属性可能包含多个条目。

另请参阅 subjectInfo()。

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

返回一个列表，其中包含该证书的签发者信息中具有值的属性。可通过调用issuerInfo() 方法访问给定属性关联的信息。请注意，该列表可能包含 SSL 后端无法识别的任何元素的 OID。

另请参阅 subjectInfo()。

QSslKey QSslCertificate::publicKey() const

返回证书主体的公钥。

QByteArray QSslCertificate::serialNumber() const

返回证书序列号的十六进制字符串。

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

返回该证书的替代主题名称列表。这些替代名称通常包含对该证书有效的主机名，可选地包含通配符。

如果CommonName 的主体信息中未定义有效的主机名，或者主体信息中的名称与对等方的主机名不匹配，则会将这些名称与连接的对等方的主机名进行比对。

另请参阅 subjectInfo()。

QString QSslCertificate::subjectDisplayName() const

返回一个描述该主题的名称。如果QSslCertificate::CommonName 可用，则返回该名称；否则，将回退到第一个QSslCertificate::Organization 或第一个QSslCertificate::OrganizationalUnitName 。

另请参阅 subjectInfo()。

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

返回subject 的相关信息；如果证书中没有subject 的相关信息，则返回一个空列表。每种类型的条目可能有多个。

另请参阅 issuerInfo()。

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

返回attribute 的主体信息；如果证书中没有attribute 的信息，则返回一个空列表。一个属性可能包含多个条目。

另请参阅 issuerInfo()。

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

返回一个列表，其中包含该证书的主题信息中具有值的属性。可通过调用subjectInfo() 方法访问特定属性的相关信息。请注意，该列表可能包含 SSL 后端无法识别的元素的 OID。

另请参阅 subjectInfo()。

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

将此证书实例与other 进行交换。此操作速度非常快，且绝不会失败。

QByteArray QSslCertificate::toDer() const

返回该证书转换为 DER（二进制）编码形式的表示。

QByteArray QSslCertificate::toPem() const

返回该证书转换为 PEM（Base64）编码格式的结果。

QString QSslCertificate::toText() const

返回该证书转换为人类可读文本形式的表示。

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

验证证书链。待验证的证书链通过certificateChain 参数传入。列表中的第一个证书应为待验证证书链的叶证书。如果指定了hostName ，则还会检查该证书是否对指定主机名有效。

请注意，根（CA）证书不应包含在待验证的列表中，系统将自动通过默认QSslConfiguration 中指定的CA列表进行查询，此外，在Unix和Windows系统上，若条件允许，还会加载按需加载的CA证书。

QByteArray QSslCertificate::version() const

返回证书的版本字符串。

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

如果该证书与other 不一致，则返回true ；否则返回false 。

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

将other 中的内容复制到该证书中，使这两个证书内容完全一致。

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

如果该证书与other 相同，则返回true ；否则返回false 。