QDnsTlsAssociationRecord Class

QDnsTlsAssociationRecord 类存储有关 DNS TLSA 记录的信息。更多

头文件: #include <QDnsTlsAssociationRecord>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Qt 6.8

公共类型

enum class CertificateUsage { CertificateAuthorityConstrait, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate, PrivateUse, …, PrivCert }
enum class MatchingType { Exact, Sha256, Sha512, PrivateUse, PrivMatch }
enum class Selector { FullCertificate, SubjectPublicKeyInfo, PrivateUse, Cert, SPKI, PrivSel }

公共函数

QDnsTlsAssociationRecord()
QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)
~QDnsTlsAssociationRecord()
QDnsTlsAssociationRecord::MatchingType matchType() const
QString name() const
QDnsTlsAssociationRecord::Selector selector() const
quint32 timeToLive() const
QDnsTlsAssociationRecord::CertificateUsage usage() const
QByteArray value() const
QDnsTlsAssociationRecord &operator=(const QDnsTlsAssociationRecord &other)

详细说明

执行文本查找时,将返回零条或多条记录。每条记录由一个 QDnsTlsAssociationRecord 实例表示。

字段的含义已在RFC 6698 中定义。

另请参阅 QDnsLookup

成员类型文档

enum class QDnsTlsAssociationRecord::CertificateUsage

本枚举包含 TLS 关联查询中证书使用情况字段的有效值。以下列表与RFC 6698第 2.1.1 节和 RFC 7218 第 2.1 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。

常量说明
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait0表示记录包含与特定证书颁发机构的关联,该证书颁发机构必须在 TLS 服务器的证书链中找到,且必须通过 PKIX 验证。
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint1该证书必须与 TLS 服务器提供的终端实体证书相匹配,且必须通过 PKIX 验证。
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion2该证书必须作为最终信任锚来验证 TLS 服务器证书,且必须通过 PKIX 验证。
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate3表示记录包含与证书的关联,该证书必须与 TLS 服务器提供的终端实体证书相匹配。不测试 PKIX 验证。
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse255无标准含义。
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA0别名;公钥基础设施信任锚点的助记符
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE1别名;公钥基础设施终端实体的助记符
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA2别名;基于 DNS 的命名实体认证的助记符 信任锚点
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE3别名;基于 DNS 的具名实体认证的助记符 最终实体
QDnsTlsAssociationRecord::CertificateUsage::PrivCert255别名

其他值目前为保留值,但未来标准可能不再保留。即使没有提供枚举器,也可将此枚举用于这些值。

另请参阅 usage()。

enum class QDnsTlsAssociationRecord::MatchingType

该枚举包含 TLS 关联查询的匹配类型字段的有效值。以下列表与RFC 6698第 2.1.3 节和 RFC 7218 第 2.3 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。

常量说明
QDnsTlsAssociationRecord::MatchingType::Exact0表示证书或 SPKI 数据已逐字存储在此记录中。
QDnsTlsAssociationRecord::MatchingType::Sha2561表示本记录中的证书或 SPKI 数据的 SHA-256 校验和。
QDnsTlsAssociationRecord::MatchingType::Sha5122表示本记录中的证书或 SPKI 数据的 SHA-512 校验和。
QDnsTlsAssociationRecord::MatchingType::PrivateUse255无标准含义。
QDnsTlsAssociationRecord::MatchingType::PrivMatchPrivateUse别名

其他值目前保留,但未来的标准可能不再保留。即使未提供枚举器,该枚举也可用于这些值。

另请参阅 matchType()。

enum class QDnsTlsAssociationRecord::Selector

该枚举包含 TLS 关联查询选择器字段的有效值。以下列表与RFC 6698第 2.1.2 节和 RFC 7218 第 2.2 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。

常量说明
QDnsTlsAssociationRecord::Selector::FullCertificate0表示该记录指向二进制结构形式的完整证书。
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo1表示该记录指 DER 编码二进制结构形式的证书主体和公钥信息。
QDnsTlsAssociationRecord::Selector::PrivateUse255无标准含义。
QDnsTlsAssociationRecord::Selector::CertFullCertificate别名
QDnsTlsAssociationRecord::Selector::SPKISubjectPublicKeyInfo别名
QDnsTlsAssociationRecord::Selector::PrivSelPrivateUse别名

其他值目前为保留值,但未来标准可能不再保留。即使没有提供枚举器,也可将此枚举用于这些值。

另请参阅 selector().

成员函数文档

QDnsTlsAssociationRecord::QDnsTlsAssociationRecord()

构造一条空的 TLS 关联记录。

QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)

构造other 的副本。

[noexcept] QDnsTlsAssociationRecord::~QDnsTlsAssociationRecord()

销毁此 TLS 关联记录对象。

QDnsTlsAssociationRecord::MatchingType QDnsTlsAssociationRecord::matchType() const

返回此记录的匹配类型字段。

QString QDnsTlsAssociationRecord::name() const

返回此记录的名称。

QDnsTlsAssociationRecord::Selector QDnsTlsAssociationRecord::selector() const

返回此记录的选择器字段。

quint32 QDnsTlsAssociationRecord::timeToLive() const

返回该记录的有效期(以秒为单位)。

QDnsTlsAssociationRecord::CertificateUsage QDnsTlsAssociationRecord::usage() const

返回此记录的证书使用字段。

QByteArray QDnsTlsAssociationRecord::value() const

返回此记录的二进制数据字段。二进制数据的解释取决于证书使用()、selector() 和matchType() 提供的三个数字字段。

请注意,即使是校验和,这也是一个二进制字段,类似于 QCyrptographicHash::result() 返回的内容。

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

other 的内容移入此对象。

© 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.