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 |
- 所有成员的列表,包括继承成员
- QDnsTlsAssociationRecord 属于网络编程 API和隐式共享类。
公共类型
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) |
另请参阅 QDnsLookup 。
成员类型文档
enum class QDnsTlsAssociationRecord::CertificateUsage
本枚举包含 TLS 关联查询中证书使用情况字段的有效值。以下列表与RFC 6698第 2.1.1 节和 RFC 7218 第 2.1 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。
常量 | 值 | 说明 |
---|---|---|
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait | 0 | 表示记录包含与特定证书颁发机构的关联,该证书颁发机构必须在 TLS 服务器的证书链中找到,且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint | 1 | 该证书必须与 TLS 服务器提供的终端实体证书相匹配,且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion | 2 | 该证书必须作为最终信任锚来验证 TLS 服务器证书,且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate | 3 | 表示记录包含与证书的关联,该证书必须与 TLS 服务器提供的终端实体证书相匹配。不测试 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA | 0 | 别名;公钥基础设施信任锚点的助记符 |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE | 1 | 别名;公钥基础设施终端实体的助记符 |
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA | 2 | 别名;基于 DNS 的命名实体认证的助记符 信任锚点 |
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE | 3 | 别名;基于 DNS 的具名实体认证的助记符 最终实体 |
QDnsTlsAssociationRecord::CertificateUsage::PrivCert | 255 | 别名 |
其他值目前为保留值,但未来标准可能不再保留。即使没有提供枚举器,也可将此枚举用于这些值。
另请参阅 usage()。
enum class QDnsTlsAssociationRecord::MatchingType
该枚举包含 TLS 关联查询的匹配类型字段的有效值。以下列表与RFC 6698第 2.1.3 节和 RFC 7218 第 2.3 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。
常量 | 值 | 说明 |
---|---|---|
QDnsTlsAssociationRecord::MatchingType::Exact | 0 | 表示证书或 SPKI 数据已逐字存储在此记录中。 |
QDnsTlsAssociationRecord::MatchingType::Sha256 | 1 | 表示本记录中的证书或 SPKI 数据的 SHA-256 校验和。 |
QDnsTlsAssociationRecord::MatchingType::Sha512 | 2 | 表示本记录中的证书或 SPKI 数据的 SHA-512 校验和。 |
QDnsTlsAssociationRecord::MatchingType::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::MatchingType::PrivMatch | PrivateUse | 别名 |
其他值目前保留,但未来的标准可能不再保留。即使未提供枚举器,该枚举也可用于这些值。
另请参阅 matchType()。
enum class QDnsTlsAssociationRecord::Selector
该枚举包含 TLS 关联查询选择器字段的有效值。以下列表与RFC 6698第 2.1.2 节和 RFC 7218 第 2.2 节保持一致。有关解释本枚举的权威说明,请参阅这些文件。
常量 | 值 | 说明 |
---|---|---|
QDnsTlsAssociationRecord::Selector::FullCertificate | 0 | 表示该记录指向二进制结构形式的完整证书。 |
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo | 1 | 表示该记录指 DER 编码二进制结构形式的证书主体和公钥信息。 |
QDnsTlsAssociationRecord::Selector::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::Selector::Cert | FullCertificate | 别名 |
QDnsTlsAssociationRecord::Selector::SPKI | SubjectPublicKeyInfo | 别名 |
QDnsTlsAssociationRecord::Selector::PrivSel | PrivateUse | 别名 |
其他值目前为保留值,但未来标准可能不再保留。即使没有提供枚举器,也可将此枚举用于这些值。
另请参阅 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.