QDnsTlsAssociationRecord Class
La clase `QDnsTlsAssociationRecord` almacena información sobre un registro TLSA de DNS. Más información...
| Cabecera: | #include <QDnsTlsAssociationRecord> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Desde: | Qt 6.8 |
- Lista de todos los miembros, incluidos los heredados
- QDnsTlsAssociationRecord forma parte de la API de programación de redes y de las clases compartidas implícitamente.
Tipos públicos
| 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 } |
Funciones públicas
| 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) |
Descripción detallada
Al realizar una búsqueda de texto, se devolverán cero o más registros. Cada registro está representado por una instancia de QDnsTlsAssociationRecord.
El significado de los campos se define en el RFC 6698.
Véase también QDnsLookup.
Documentación sobre los tipos de miembros
enum class QDnsTlsAssociationRecord::CertificateUsage
Esta enumeración contiene valores válidos para el campo de uso del certificado de las consultas de asociación TLS. La siguiente lista está actualizada según la sección 2.1.1 del RFC 6698 y la sección 2.1 del RFC 7218. Consulte dichos documentos para obtener instrucciones oficiales sobre cómo interpretar esta enumeración.
| Constante | Valor | Descripción |
|---|---|---|
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait | 0 | Indica que el registro incluye una asociación a una autoridad de certificación específica que debe encontrarse en la cadena de certificados del servidor TLS y que debe superar la validación PKIX. |
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint | 1 | Indica que el registro incluye una asociación con un certificado que debe coincidir con el certificado de entidad final proporcionado por el servidor TLS y debe superar la validación PKIX. |
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion | 2 | Indica que el registro incluye una asociación con un certificado que DEBE utilizarse como ancla de confianza definitiva para validar el certificado del servidor TLS y que debe superar la validación PKIX. |
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate | 3 | Indica que el registro incluye una asociación con un certificado que debe coincidir con el certificado de entidad final proporcionado por el servidor TLS. No se comprueba la validación PKIX. |
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse | 255 | No se aplica ningún significado estándar. |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA | 0 | Alias; mnemotécnico para «Ancla de confianza de la infraestructura de clave pública» |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE | 1 | Alias; mnemotécnico para «entidad final de la infraestructura de clave pública» |
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA | 2 | Alias; mnemotécnico de «Ancla de confianza de la autenticación basada en DNS de entidades con nombre» |
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE | 3 | Alias; mnemotécnico para «Entidad final de la autenticación de entidades con nombre basada en DNS» |
QDnsTlsAssociationRecord::CertificateUsage::PrivCert | 255 | Alias |
Actualmente, los demás valores están reservados, pero podrían dejar de estarlo en futuras normas. Esta enumeración puede utilizarse para dichos valores aunque no se proporcione ningún enumerador.
Véase también usage().
enum class QDnsTlsAssociationRecord::MatchingType
Esta enumeración contiene los valores válidos para el campo «matching type» de las consultas de asociación TLS. La siguiente lista está actualizada según la sección 2.1.3 del RFC 6698 y la sección 2.3 del RFC 7218. Consulte dichos documentos para obtener instrucciones oficiales sobre cómo interpretar esta enumeración.
| Constante | Valor | Descripción |
|---|---|---|
QDnsTlsAssociationRecord::MatchingType::Exact | 0 | Indica que los datos del certificado o del SPKI se almacenan tal cual en este registro. |
QDnsTlsAssociationRecord::MatchingType::Sha256 | 1 | Indica que se trata de una suma de comprobación SHA-256 de los datos del certificado o de SPKI presentes en este registro. |
QDnsTlsAssociationRecord::MatchingType::Sha512 | 2 | Indica que se trata de una suma de comprobación SHA-512 del certificado o de los datos SPKI presentes en este registro. |
QDnsTlsAssociationRecord::MatchingType::PrivateUse | 255 | No se le aplica ningún significado estándar. |
QDnsTlsAssociationRecord::MatchingType::PrivMatch | PrivateUse | Alias |
Otros valores están reservados actualmente, pero podrían dejarse sin reservar en futuras normas. Esta enumeración puede utilizarse para esos valores aunque no se proporcione ningún enumerador.
Véase también matchType().
enum class QDnsTlsAssociationRecord::Selector
Esta enumeración contiene valores válidos para el campo «selector» de las consultas de asociación TLS. La siguiente lista está actualizada según la sección 2.1.2 del RFC 6698 y la sección 2.2 del RFC 7218. Consulte dichos documentos para obtener instrucciones oficiales sobre cómo interpretar esta enumeración.
| Constante | Valor | Descripción |
|---|---|---|
QDnsTlsAssociationRecord::Selector::FullCertificate | 0 | Indica que este registro hace referencia al certificado completo en su formato de estructura binaria. |
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo | 1 | Indica que el registro se refiere a la información del sujeto y de la clave pública del certificado, en forma de estructura binaria codificada en DER. |
QDnsTlsAssociationRecord::Selector::PrivateUse | 255 | No se le aplica ningún significado estándar. |
QDnsTlsAssociationRecord::Selector::Cert | FullCertificate | Alias |
QDnsTlsAssociationRecord::Selector::SPKI | SubjectPublicKeyInfo | Alias |
QDnsTlsAssociationRecord::Selector::PrivSel | PrivateUse | Alias |
Los demás valores están reservados actualmente, pero podrían dejar de estarlo en futuras normas. Esta enumeración puede utilizarse para dichos valores aunque no se especifique ningún enumerador.
Véase también selector().
Documentación de funciones de miembro
QDnsTlsAssociationRecord::QDnsTlsAssociationRecord()
Crea un registro de asociación TLS vacío.
QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)
Crea una copia de other.
[constexpr noexcept default] QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(QDnsTlsAssociationRecord &&other)
Crea una instancia de ` QDnsTlsAssociationRecord` mediante la construcción «move».
[noexcept] QDnsTlsAssociationRecord::~QDnsTlsAssociationRecord()
Elimina este objeto de registro de asociación TLS.
QDnsTlsAssociationRecord::MatchingType QDnsTlsAssociationRecord::matchType() const
Devuelve el campo «tipo de coincidencia» de este registro.
QString QDnsTlsAssociationRecord::name() const
Devuelve el nombre de este registro.
QDnsTlsAssociationRecord::Selector QDnsTlsAssociationRecord::selector() const
Devuelve el campo selector de este registro.
quint32 QDnsTlsAssociationRecord::timeToLive() const
Devuelve la duración, en segundos, durante la cual este registro es válido.
QDnsTlsAssociationRecord::CertificateUsage QDnsTlsAssociationRecord::usage() const
Devuelve el campo de uso del certificado correspondiente a este registro.
QByteArray QDnsTlsAssociationRecord::value() const
Devuelve el campo de datos binarios de este registro. La interpretación de estos datos binarios depende de los tres campos numéricos proporcionados por las funciones `certificateUsage()`, ` selector()` y ` matchType()`.
Ten en cuenta que se trata de un campo binario, incluso en el caso de las sumas de comprobación, de forma similar a lo que devuelve QCyrptographicHash::result().
QDnsTlsAssociationRecord &QDnsTlsAssociationRecord::operator=(const QDnsTlsAssociationRecord &other)
Traslada el contenido de « other » a este objeto.
© 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.