Sur cette page

QDnsTlsAssociationRecord Class

La classe `QDnsTlsAssociationRecord` stocke des informations relatives à un enregistrement TLSA DNS. En savoir plus…

En-tête : #include <QDnsTlsAssociationRecord>
CMake : find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake : QT += network
Depuis : Qt 6.8

Types publics

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 }

Fonctions publiques

QDnsTlsAssociationRecord()
QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)
QDnsTlsAssociationRecord(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)

Description détaillée

Lors d'une recherche textuelle, zéro ou plusieurs enregistrements sont renvoyés. Chaque enregistrement est représenté par une instance de QDnsTlsAssociationRecord.

La signification des champs est définie dans la spécification RFC 6698.

Voir également QDnsLookup.

Documentation sur les types de membres

enum class QDnsTlsAssociationRecord::CertificateUsage

Cette énumération contient les valeurs valides pour le champ « usage » du certificat dans les requêtes d’association TLS. La liste suivante est conforme à la section 2.1.1 de la RFC 6698 et à la section 2.1 de la RFC 7218. Veuillez vous reporter à ces documents pour obtenir des instructions faisant autorité sur l’interprétation de cette énumération.

ConstanteValeurDescription
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait0Indique que l'enregistrement comprend une association à une autorité de certification spécifique qui doit figurer dans la chaîne de certificats du serveur TLS et doit passer la validation PKIX.
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint1Indique que l’enregistrement comprend une association à un certificat qui doit correspondre au certificat d’entité finale fourni par le serveur TLS et qui doit passer la validation PKIX.
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion2Indique que l'enregistrement comprend une association à un certificat qui DOIT être utilisé comme ancrage de confiance ultime pour valider le certificat du serveur TLS et qui doit passer la validation PKIX.
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate3Indique que l'enregistrement comprend une association à un certificat qui doit correspondre au certificat d'entité finale fourni par le serveur TLS. La validation PKIX n'est pas testée.
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse255Aucune signification standard n’est appliquée.
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA0Alias ; mnémonique pour « ancrage de confiance de l’infrastructure à clé publique »
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE1Alias ; mnémonique pour « entité finale de l’infrastructure à clé publique »
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA2Alias ; mnémonique pour « Ancrage de confiance de l’authentification des entités nommées basée sur le DNS »
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE3Alias ; mnémonique pour « Entité finale de l’authentification DNS des entités nommées »
QDnsTlsAssociationRecord::CertificateUsage::PrivCert255Alias

Les autres valeurs sont actuellement réservées, mais pourraient être libérées par de futures normes. Cette énumération peut être utilisée pour ces valeurs même si aucun énumérateur n’est fourni.

Voir également usage().

enum class QDnsTlsAssociationRecord::MatchingType

Cette énumération contient les valeurs valides pour le champ de type de correspondance des requêtes d’association TLS. La liste suivante est conforme à la section 2.1.3 de la RFC 6698 et à la section 2.3 de la RFC 7218. Veuillez vous reporter à ces documents pour obtenir des instructions faisant autorité sur l’interprétation de cette énumération.

ConstanteValeurDescription
QDnsTlsAssociationRecord::MatchingType::Exact0Indique que les données du certificat ou du SPKI sont stockées telles quelles dans cet enregistrement.
QDnsTlsAssociationRecord::MatchingType::Sha2561Indique qu'il s'agit d'une somme de contrôle SHA-256 des données du certificat ou SPKI présentes dans cet enregistrement.
QDnsTlsAssociationRecord::MatchingType::Sha5122Indique qu'il s'agit d'une somme de contrôle SHA-512 du certificat ou des données SPKI présents dans cet enregistrement.
QDnsTlsAssociationRecord::MatchingType::PrivateUse255Aucune signification standard n'est appliquée.
QDnsTlsAssociationRecord::MatchingType::PrivMatchPrivateUseAlias

Les autres valeurs sont actuellement réservées, mais pourraient être libérées par de futures normes. Cette énumération peut être utilisée pour ces valeurs même si aucun énumérateur n'est fourni.

Voir également matchType().

enum class QDnsTlsAssociationRecord::Selector

Cette énumération contient les valeurs valides pour le champ « selector » des requêtes d’association TLS. La liste suivante est conforme à la section 2.1.2 de la RFC 6698 et à la section 2.2 de la RFC 7218. Veuillez vous reporter à ces documents pour obtenir des instructions faisant autorité concernant l’interprétation de cette énumération.

ConstanteValeurDescription
QDnsTlsAssociationRecord::Selector::FullCertificate0Indique que cet enregistrement fait référence au certificat complet sous sa forme binaire.
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo1Indique que l'enregistrement fait référence aux informations relatives au sujet et à la clé publique du certificat, sous la forme d'une structure binaire codée en DER.
QDnsTlsAssociationRecord::Selector::PrivateUse255Aucune signification standard n'est appliquée.
QDnsTlsAssociationRecord::Selector::CertFullCertificateAlias
QDnsTlsAssociationRecord::Selector::SPKISubjectPublicKeyInfoAlias
QDnsTlsAssociationRecord::Selector::PrivSelPrivateUseAlias

Les autres valeurs sont actuellement réservées, mais pourraient être libérées par de futures normes. Cette énumération peut être utilisée pour ces valeurs même si aucun énumérateur n’est fourni.

Voir également la fonction ` selector()`.

Documentation des fonctions membres

QDnsTlsAssociationRecord::QDnsTlsAssociationRecord()

Crée un enregistrement d'association TLS vide.

QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)

Crée une copie de other.

[constexpr noexcept default] QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(QDnsTlsAssociationRecord &&other)

Crée par « move » une instance de ` QDnsTlsAssociationRecord`.

[noexcept] QDnsTlsAssociationRecord::~QDnsTlsAssociationRecord()

Supprime cet objet d'enregistrement d'association TLS.

QDnsTlsAssociationRecord::MatchingType QDnsTlsAssociationRecord::matchType() const

Renvoie le champ « type de correspondance » associé à cet enregistrement.

QString QDnsTlsAssociationRecord::name() const

Renvoie le nom de cet enregistrement.

QDnsTlsAssociationRecord::Selector QDnsTlsAssociationRecord::selector() const

Renvoie le champ de sélection associé à cet enregistrement.

quint32 QDnsTlsAssociationRecord::timeToLive() const

Renvoie la durée, en secondes, pendant laquelle cet enregistrement est valide.

QDnsTlsAssociationRecord::CertificateUsage QDnsTlsAssociationRecord::usage() const

Renvoie le champ « Utilisation du certificat » associé à cet enregistrement.

QByteArray QDnsTlsAssociationRecord::value() const

Renvoie le champ de données binaires correspondant à cet enregistrement. L'interprétation de ces données binaires dépend des trois champs numériques fournis par les fonctions `certificateUsage()`, ` selector()` et ` matchType()`.

Notez qu'il s'agit d'un champ binaire, même pour les sommes de contrôle, à l'instar de ce que renvoie QCyrptographicHash::result().

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

Déplace le contenu de ` other ` vers cet objet.

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