QDnsTlsAssociationRecord Class

The QDnsTlsAssociationRecord class stores information about a DNS TLSA record. 更多...

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

公共类型

枚举类 CertificateUsage { CertificateAuthorityConstrait, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate, PrivateUse, …, PrivCert }
枚举类 MatchingType { Exact, Sha256, Sha512, PrivateUse, PrivMatch }
枚举类 选择器 { FullCertificate, SubjectPublicKeyInfo, PrivateUse, Cert, SPKI, PrivSel }

公共函数

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

详细描述

When performing a text lookup, zero or more records will be returned. Each record is represented by a QDnsTlsAssociationRecord instance.

字段含义的定义在 RFC 6698 .

另请参阅 QDnsLookup .

成员类型文档编制

enum class QDnsTlsAssociationRecord:: CertificateUsage

This enumeration contains valid values for the certificate usage field of TLS Association queries. The following list is up-to-date with RFC 6698 section 2.1.1 and RFC 7218 section 2.1. Please refer to those documents for authoritative instructions on interpreting this enumeration.

常量 描述
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait 0 Indicates the record includes an association to a specific Certificate Authority that must be found in the TLS server's certificate chain and must pass PKIX validation.
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint 1 Indicates the record includes an association to a certificate that must match the end entity certificate provided by the TLS server and must pass PKIX validation.
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion 2 Indicates the record includes an association to a certificate that MUST be used as the ultimate trust anchor to validate the TLS server's certificate and must pass PKIX validation.
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate 3 Indicates the record includes an association to a certificate that must match the end entity certificate provided by the TLS server. PKIX validation is not tested.
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse 255 No standard meaning applied.
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA 0 Alias; mnemonic for Public Key Infrastructure Trust Anchor
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE 1 Alias; mnemonic for Public Key Infrastructure End Entity
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA 2 Alias; mnemonic for DNS-based Authentication of Named Entities Trust Anchor
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE 3 Alias; mnemonic for DNS-based Authentication of Named Entities End Entity
QDnsTlsAssociationRecord::CertificateUsage::PrivCert 255 Alias

Other values are currently reserved, but may be unreserved by future standards. This enumeration can be used for those values even if no enumerator is provided.

另请参阅 usage ().

enum class QDnsTlsAssociationRecord:: MatchingType

This enumeration contains valid values for the matching type field of TLS Association queries. The following list is up-to-date with RFC 6698 section 2.1.3 and RFC 7218 section 2.3. Please refer to those documents for authoritative instructions on interpreting this enumeration.

常量 描述
QDnsTlsAssociationRecord::MatchingType::Exact 0 Indicates this the certificate or SPKI data is stored verbatim in this record.
QDnsTlsAssociationRecord::MatchingType::Sha256 1 Indicates this a SHA-256 checksum of the the certificate or SPKI data present in this record.
QDnsTlsAssociationRecord::MatchingType::Sha512 2 Indicates this a SHA-512 checksum of the the certificate or SPKI data present in this record.
QDnsTlsAssociationRecord::MatchingType::PrivateUse 255 No standard meaning applied.
QDnsTlsAssociationRecord::MatchingType::PrivMatch PrivateUse Alias

Other values are currently reserved, but may be unreserved by future standards. This enumeration can be used for those values even if no enumerator is provided.

另请参阅 matchType ().

enum class QDnsTlsAssociationRecord:: 选择器

This enumeration contains valid values for the selector field of TLS Association queries. The following list is up-to-date with RFC 6698 section 2.1.2 and RFC 7218 section 2.2. Please refer to those documents for authoritative instructions on interpreting this enumeration.

常量 描述
QDnsTlsAssociationRecord::Selector::FullCertificate 0 Indicates this record refers to the full certificate in its binary structure form.
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo 1 Indicates the record refers to the certificate's subject and public key information, in DER-encoded binary structure form.
QDnsTlsAssociationRecord::Selector::PrivateUse 255 No standard meaning applied.
QDnsTlsAssociationRecord::Selector::Cert FullCertificate Alias
QDnsTlsAssociationRecord::Selector::SPKI SubjectPublicKeyInfo Alias
QDnsTlsAssociationRecord::Selector::PrivSel PrivateUse Alias

Other values are currently reserved, but may be unreserved by future standards. This enumeration can be used for those values even if no enumerator is provided.

另请参阅 选择器 ().

成员函数文档编制

QDnsTlsAssociationRecord:: QDnsTlsAssociationRecord ()

Constructs an empty TLS Association record.

QDnsTlsAssociationRecord:: QDnsTlsAssociationRecord (const QDnsTlsAssociationRecord & other )

构造副本为 other .

[noexcept] QDnsTlsAssociationRecord:: ~QDnsTlsAssociationRecord ()

Destroys this TLS Association record object.

QDnsTlsAssociationRecord::MatchingType QDnsTlsAssociationRecord:: matchType () const

Returns the match type field for this record.

QString QDnsTlsAssociationRecord:: name () const

Returns the name of this record.

QDnsTlsAssociationRecord::Selector QDnsTlsAssociationRecord:: 选择器 () const

Returns the selector field for this record.

quint32 QDnsTlsAssociationRecord:: timeToLive () const

返回此记录有效的持续时间 (以秒为单位)。

QDnsTlsAssociationRecord::CertificateUsage QDnsTlsAssociationRecord:: usage () const

Returns the certificate usage field for this record.

QByteArray QDnsTlsAssociationRecord:: value () const

Returns the binary data field for this record. The interpretation of this binary data depends on the three numeric fields provided by certificateUsage(), 选择器 (),和 matchType ().

Do note this is a binary field, even for the checksums, similar to what QCyrptographicHash::result() returns.

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

Moves the content of other 到此对象。