QDtlsClientVerifier Class
Esta clase implementa la generación y verificación de cookies DTLS del lado del servidor. Más información...
| Encabezado: | #include <QDtlsClientVerifier> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Heredan: | QObject |
- Lista de todos los miembros, incluidos los heredados
- QDtlsClientVerifier forma parte de la API de programación de redes.
Tipos públicos
| struct | GeneratorParameters |
Funciones públicas
| QDtlsClientVerifier(QObject *parent = nullptr) | |
| virtual | ~QDtlsClientVerifier() |
| QDtlsClientVerifier::GeneratorParameters | cookieGeneratorParameters() const |
| QDtlsError | dtlsError() const |
| QString | dtlsErrorString() const |
| bool | setCookieGeneratorParameters(const QDtlsClientVerifier::GeneratorParameters ¶ms) |
| QByteArray | verifiedHello() const |
| bool | verifyClient(QUdpSocket *socket, const QByteArray &dgram, const QHostAddress &address, quint16 port) |
Descripción detallada
La clase QDtlsClientVerifier implementa la generación y verificación de cookies DTLS del lado del servidor. Los protocolos de seguridad de datagramas son muy susceptibles a diversos tipos de ataques de denegación de servicio. Según la RFC 6347, sección 4.2.1, estos son dos de los tipos de ataque más comunes:
- Un atacante transmite una serie de solicitudes de inicio de handshake, lo que provoca que el servidor asigne recursos excesivos y, potencialmente, realice operaciones criptográficas costosas.
- Un atacante transmite una serie de solicitudes de inicio de handshake con una fuente falsificada de la víctima, lo que hace que el servidor actúe como amplificador. Normalmente, el servidor respondería a la máquina de la víctima con un mensaje de certificado, que puede ser bastante grande, inundando así la máquina de la víctima con datagramas.
Como contramedida frente a estos ataques, la sección 4.2.1 del RFC 6347 propone una técnica de «cookie» sin estado que un servidor puede implementar:
- En respuesta al mensaje «ClientHello» inicial, el servidor envía un «HelloVerifyRequest», que contiene una «cookie». Esta «cookie» es un hash criptográfico y se genera utilizando la dirección del cliente, el número de puerto y el secreto del servidor (que es una secuencia de bytes pseudoaleatoria criptográficamente sólida).
- Se espera que un cliente DTLS accesible responda con un nuevo mensaje ClientHello que contenga esta cookie.
- Cuando el servidor recibe el mensaje ClientHello con una cookie, genera una nueva cookie tal y como se ha descrito anteriormente. Esta nueva cookie se compara con la que figura en el mensaje ClientHello.
- Si las cookies coinciden, se considera que el cliente es auténtico y el servidor puede continuar con el procedimiento de establecimiento de conexión TLS.
Nota: No es obligatorio queun servidor DTLS utilice cookies DTLS.
QDtlsClientVerifier está diseñado para funcionar en combinación con QUdpSocket, tal y como se muestra en el siguiente fragmento de código:
class DtlsServer : public QObject
{
public:
bool listen(const QHostAddress &address, quint16 port);
// ...
private:
void readyRead();
// ...
QUdpSocket serverSocket;
QDtlsClientVerifier verifier;
// ...
};
bool DtlsServer::listen(const QHostAddress &serverAddress, quint16 serverPort)
{
if (serverSocket.bind(serverAddress, serverPort))
connect(&serverSocket, &QUdpSocket::readyRead, this, &DtlsServer::readyRead);
return serverSocket.state() == QAbstractSocket::BoundState;
}
void DtlsServer::readyRead()
{
QByteArray dgram(serverSocket.pendingDatagramSize(), Qt::Uninitialized);
QHostAddress address;
quint16 port = {};
serverSocket.readDatagram(dgram.data(), dgram.size(), &address, &port);
if (verifiedClients.contains({address, port}) {
// This client was verified previously, we either continue the
// handshake or decrypt the incoming message.
} else if (verifier.verifyClient(&serverSocket, dgram, address, port)) {
// Apparently we have a real DTLS client who wants to send us
// encrypted datagrams. Remember this client as verified
// and proceed with a handshake.
} else {
// No matching cookie was found in the incoming datagram,
// verifyClient() has sent a ClientVerify message.
// We'll hear from the client again soon, if they're real.
}
}QDtlsClientVerifier no impone ninguna restricción sobre cómo la aplicación utiliza QUdpSocket. Por ejemplo, es posible tener un servidor con un único QUdpSocket en el estado QAbstractSocket::BoundState, que gestione varios clientes DTLS simultáneamente:
- Comprobar si los nuevos clientes son auténticos clientes compatibles con DTLS.
- Realizar el protocolo de enlace TLS con los clientes verificados (véase QDtls).
- Descifrar los datagramas procedentes de los clientes conectados (véase QDtls).
- Envío de datagramas cifrados a los clientes conectados (véase QDtls).
Esto implica que `QDtlsClientVerifier` no lee directamente desde un socket, sino que espera que la aplicación lea un datagrama entrante, extraiga la dirección y el puerto del remitente y, a continuación, pase estos datos a ` verifyClient()` para enviar un mensaje `HelloVerifyRequest`, ` verifyClient()` puede escribir en ` QUdpSocket`.
Nota: QDtlsClientVerifier no asume la propiedad del objeto QUdpSocket.
Por defecto, QDtlsClientVerifier obtiene su secreto de un generador de números pseudoaleatorios criptográficamente seguro.
Nota: El secreto predeterminado es compartido por todos los objetos de las clases QDtlsClientVerifier y QDtls. Dado que esto puede suponer riesgos de seguridad, la RFC 6347 recomienda cambiar el secreto del servidor con frecuencia. Consulte la sección 4.2.1 del RFC 6347 para obtener indicaciones sobre posibles implementaciones de servidor. Los parámetros del generador de cookies se pueden configurar mediante las clases ` QDtlsClientVerifier::GeneratorParameters ` y ` setCookieGeneratorParameters()`:
void DtlsServer::updateServerSecret()
{
const QByteArray newSecret(generateCryptoStrongSecret());
if (newSecret.size()) {
usedCookies.append(newSecret);
verifier.setCookieGeneratorParameters({QCryptographicHash::Sha1, newSecret});
}
}El ejemplo del servidor DTLS ilustra cómo utilizar QDtlsClientVerifier en una aplicación de servidor.
Véase también QUdpSocket, QAbstractSocket::BoundState, QDtls, verifyClient(), GeneratorParameters, setCookieGeneratorParameters(), cookieGeneratorParameters(), QDtls::setCookieGeneratorParameters(), QDtls::cookieGeneratorParameters(), QCryptographicHash::Algorithm, QDtlsError, dtlsError() y dtlsErrorString().
Documentación de funciones de miembro
[explicit] QDtlsClientVerifier::QDtlsClientVerifier(QObject *parent = nullptr)
Crea un objeto `QDtlsClientVerifier`; se pasa ` parent ` al constructor de ` QObject`.
[virtual noexcept] QDtlsClientVerifier::~QDtlsClientVerifier()
Elimina el objeto « QDtlsClientVerifier ».
QDtlsClientVerifier::GeneratorParameters QDtlsClientVerifier::cookieGeneratorParameters() const
Devuelve el secreto y el algoritmo de hash actuales utilizados para generar cookies. El algoritmo de hash predeterminado es QCryptographicHash::Sha256 si Qt se ha configurado para admitirlo; en caso contrario, es QCryptographicHash::Sha1. El secreto predeterminado se obtiene del generador de números pseudoaleatorios criptográficamente seguro específico del backend.
Véase también QCryptographicHash::Algorithm, QDtlsClientVerifier::GeneratorParameters y setCookieGeneratorParameters().
QDtlsError QDtlsClientVerifier::dtlsError() const
Devuelve el último error que se ha producido o QDtlsError::NoError.
Véase también QDtlsError y dtlsErrorString().
QString QDtlsClientVerifier::dtlsErrorString() const
Devuelve una descripción textual del último error o una cadena vacía.
Véase también dtlsError().
bool QDtlsClientVerifier::setCookieGeneratorParameters(const QDtlsClientVerifier::GeneratorParameters ¶ms)
Establece el secreto y el algoritmo de hash criptográfico a partir de params. Este QDtlsClientVerifier utilizará estos datos para generar cookies. Si el nuevo secreto tiene tamaño cero, esta función devuelve false y no modifica los parámetros del generador de cookies.
Nota: Se supone queel secreto es una secuencia de bytes criptográficamente segura.
Véanse también QDtlsClientVerifier::GeneratorParameters, cookieGeneratorParameters() y QCryptographicHash::Algorithm.
QByteArray QDtlsClientVerifier::verifiedHello() const
Función de conveniencia. Devuelve el último mensaje «ClientHello» que se haya verificado correctamente, o un objeto « QByteArray » vacío si no se ha completado ninguna verificación.
Véase también verifyClient().
bool QDtlsClientVerifier::verifyClient(QUdpSocket *socket, const QByteArray &dgram, const QHostAddress &address, quint16 port)
socket debe ser un puntero válido; dgram debe ser un datagrama no vacío; address no puede ser nulo, de difusión ni de multidifusión. port es el puerto del par remoto. Esta función devuelve true si dgram contiene un mensaje ClientHello con una cookie válida. Si no se encuentra ninguna cookie que coincida, verifyClient() enviará un mensaje HelloVerifyRequest utilizando socket y devolverá false.
El siguiente fragmento de código muestra cómo una aplicación de servidor puede comprobar si hay errores:
if (!verifier.verifyClient(&socket, message, address, port)) {
switch (verifyClient.dtlsError()) {
case QDtlsError::NoError:
// Not verified yet, but no errors found and we have to wait for the next
// message from this client.
return;
case QDtlsError::TlsInitializationError:
// This error is fatal, nothing we can do about it.
// Probably, quit the server after reporting the error.
return;
case QDtlsError::UnderlyingSocketError:
// There is some problem in QUdpSocket, handle it (see QUdpSocket::error())
return;
case QDtlsError::InvalidInputParameters:
default:
Q_UNREACHABLE();
}
}Véase también QHostAddress::isNull(), QHostAddress::isBroadcast(), QHostAddress::isMulticast(), setCookieGeneratorParameters() y cookieGeneratorParameters().
© 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.