En esta página

QSslServer Class

Implementa un servidor TCP cifrado y seguro a través de TLS. Más información...

Encabezado: #include <QSslServer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Desde: Qt 6.4
Heredado de: QTcpServer

Funciones públicas

QSslServer(QObject *parent = nullptr)
virtual ~QSslServer() override
int handshakeTimeout() const
void setHandshakeTimeout(int timeout)
void setSslConfiguration(const QSslConfiguration &sslConfiguration)
QSslConfiguration sslConfiguration() const

Señales

void alertReceived(QSslSocket *socket, QSsl::AlertLevel level, QSsl::AlertType type, const QString &description)
void alertSent(QSslSocket *socket, QSsl::AlertLevel level, QSsl::AlertType type, const QString &description)
void errorOccurred(QSslSocket *socket, QAbstractSocket::SocketError socketError)
void handshakeInterruptedOnError(QSslSocket *socket, const QSslError &error)
void peerVerifyError(QSslSocket *socket, const QSslError &error)
void preSharedKeyAuthenticationRequired(QSslSocket *socket, QSslPreSharedKeyAuthenticator *authenticator)
void sslErrors(QSslSocket *socket, const QList<QSslError> &errors)
void startedEncryptionHandshake(QSslSocket *socket)

Funciones protegidas reimplementadas

virtual void incomingConnection(qintptr socket) override

Descripción detallada

Clase que se utiliza en lugar de ` QTcpServer ` para implementar un servidor TCP mediante Transport Layer Security (TLS).

Para configurar los parámetros del protocolo de enlace seguro, utiliza las funciones de configuración correspondientes en un objeto ` QSslConfiguration ` y, a continuación, utilízalo como argumento de la función ` setSslConfiguration()`. Todas las conexiones entrantes que se gestionen a partir de ese momento utilizarán estos parámetros.

Para comenzar a escuchar las conexiones entrantes, utiliza la función listen() heredada de QTcpServer. Se pueden configurar otros parámetros utilizando las funciones de ajuste heredadas de la clase QTcpServer.

Conéctate a las señales de esta clase para responder a los intentos de conexión entrantes. Son las mismas que las señales de ` QSslSocket`, pero además pasan un puntero al socket en cuestión.

Al responder a la señal pendingConnectionAvailable(), utiliza la función nextPendingConnection() para recuperar la siguiente conexión entrante y sacarla de la cola de conexiones pendientes. El objeto QSslSocket es un hijo de QSslServer y se eliminará cuando se elimine el QSslServer. No obstante, es recomendable destruir el objeto explícitamente cuando ya no lo necesites, para evitar el desperdicio de memoria.

Véase también « QTcpServer », « QSslConfiguration » y « QSslSocket ».

Documentación de las funciones de miembro

[explicit] QSslServer::QSslServer(QObject *parent = nullptr)

Crea un nuevo objeto `QSslServer` con el ` parent` indicado.

[override virtual noexcept] QSslServer::~QSslServer()

Elimina el objeto ` QSslServer`.

Se cierran todas las conexiones abiertas.

[signal] void QSslServer::alertReceived(QSslSocket *socket, QSsl::AlertLevel level, QSsl::AlertType type, const QString &description)

QSslServer Emite esta señal si el socket ha recibido un mensaje de alerta de un par. « level » indica si la alerta fue grave o si se trataba de una advertencia. « type » es el código que explica por qué se envió la alerta. Cuando hay disponible una descripción textual del mensaje de alerta, se proporciona en « description ».

Nota: La señal tiene principalmente fines informativos y de depuración, y no requiere ningún tipo de gestión por parte de la aplicación. Si la alerta fue grave, el backend subyacente se encargará de gestionarla y cerrará la conexión.

Nota: No todos los backends admiten esta funcionalidad.

Véase también alertSent(), QSsl::AlertLevel y QSsl::AlertType.

[signal] void QSslServer::alertSent(QSslSocket *socket, QSsl::AlertLevel level, QSsl::AlertType type, const QString &description)

QSslServer Emite esta señal si se ha enviado un mensaje de alerta desde socket a un par. level indica si se trata de una advertencia o de un error grave. type proporciona el código del mensaje de alerta. Cuando hay disponible una descripción textual del mensaje de alerta, se incluye en description.

Nota: Esta señal es principalmente informativa y puede utilizarse con fines de depuración; normalmente no requiere ninguna acción por parte de la aplicación.

Nota: No todos los backends admiten esta funcionalidad.

Véase también alertReceived(), QSsl::AlertLevel y QSsl::AlertType.

[signal] void QSslServer::errorOccurred(QSslSocket *socket, QAbstractSocket::SocketError socketError)

Esta señal se emite cuando se produce un error durante el establecimiento de la conexión. El parámetro « socketError » describe el tipo de error que se ha producido.

El objeto « socket » se elimina automáticamente tras emitirse esta señal si el establecimiento de conexión del socket no ha alcanzado el estado cifrado. Sin embargo, si el objeto « socket » se ha cifrado correctamente, se inserta en la cola de conexiones pendientes del objeto « QSslServer ». Cuando el usuario ha llamado a la función « QTcpServer::nextPendingConnection()», es responsabilidad del usuario destruir el objeto « socket »; de lo contrario, el objeto « socket » no se destruirá hasta que se destruya el objeto « QSslServer ». Si se produce un error en un ` socket ` después de que se haya insertado en la cola de conexiones pendientes, esta señal no se emitirá y el ` socket ` no se eliminará ni se destruirá.

Nota: Nose puede utilizar « Qt::QueuedConnection » al conectarse a esta señal, ya que, de lo contrario, el objeto « socket » ya se habrá destruido cuando se gestione la señal.

Véase también QSslSocket::error() y errorString().

[signal] void QSslServer::handshakeInterruptedOnError(QSslSocket *socket, const QSslError &error)

QSslServer Emite esta señal si socket ha detectado un error de verificación del certificado y si se ha habilitado la notificación temprana de errores en QSslConfiguration. Se espera que la aplicación examine el error y decida si desea continuar con el protocolo de enlace o interrumpirlo y enviar un mensaje de alerta al interlocutor. La conexión señal-ranura debe ser directa.

Véase también QSslSocket::continueInterruptedHandshake(), sslErrors() y QSslConfiguration::setHandshakeMustInterruptOnError().

int QSslServer::handshakeTimeout() const

Devuelve el tiempo de espera de establecimiento de conexión configurado actualmente.

Véase también setHandshakeTimeout().

[override virtual protected] void QSslServer::incomingConnection(qintptr socket)

Reimplementa: ` QTcpServer::incomingConnection` (`qintptr socketDescriptor`).

Se invoca cuando se establece una nueva conexión.

Convierte ` socket ` en un ` QSslSocket`.

[signal] void QSslServer::peerVerifyError(QSslSocket *socket, const QSslError &error)

QSslServer Puede emitir esta señal varias veces durante el protocolo de enlace SSL, antes de que se haya establecido el cifrado, para indicar que se ha producido un error al establecer la identidad del interlocutor. La señal « error » suele indicar que socket no puede identificar de forma segura al interlocutor.

Esta señal te proporciona una indicación temprana de que algo va mal. Al conectarte a esta señal, puedes optar manualmente por interrumpir la conexión desde el interior del slot conectado antes de que se haya completado el protocolo de enlace. Si no se toma ninguna medida, QSslServer procederá a emitir sslErrors().

Véase también sslErrors().

[signal] void QSslServer::preSharedKeyAuthenticationRequired(QSslSocket *socket, QSslPreSharedKeyAuthenticator *authenticator)

QSslServer Emite esta señal cuando socket negocia un conjunto de cifrado PSK, por lo que, a continuación, se requiere la autenticación PSK.

Al utilizar PSK, el servidor debe proporcionar una identidad válida y una clave precompartida válida para que el protocolo de enlace SSL pueda continuar. Las aplicaciones pueden proporcionar esta información en un slot conectado a esta señal, rellenando el objeto ` authenticator ` pasado según sus necesidades.

Nota: Si se ignora esta señal o no se proporcionan las credenciales necesarias, el protocolo de enlace fallará y, por lo tanto, la conexión se interrumpirá.

Nota: El objeto ` authenticator ` es propiedad de ` socket ` y la aplicación no debe eliminarlo.

Véase también QSslPreSharedKeyAuthenticator.

void QSslServer::setHandshakeTimeout(int timeout)

Establece el tiempo de espera de la mano ( timeout ) que se utilizará para todos los procesos de establecimiento de conexión entrantes, en milisegundos.

Esto resulta relevante en el caso de que un cliente, ya sea de forma maliciosa o accidental, se conecte al servidor pero no intente comunicarse ni iniciar un protocolo de enlace. En ese caso, el « QSslServer » cortará automáticamente la conexión una vez transcurridos « timeout » milisegundos.

Por defecto, el tiempo de espera es de 5000 milisegundos (5 segundos).

Nota: Es posible queel marco TLS subyacente tenga su propia lógica de tiempo de espera, ya sea ahora o en el futuro; esta función no afecta a ello.

Nota: El timeout pasado a esta función solo se aplicará a las nuevas conexiones. Si un cliente ya está conectado, utilizará el tiempo de espera que se estableció al conectarse.

Véase también handshakeTimeout().

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

Establece el ` sslConfiguration ` que se utilizará para todas las conexiones entrantes posteriores.

Esta función debe llamarse antes de listen() para garantizar que la configuración deseada se haya utilizado durante todos los procesos de establecimiento de conexión.

Véanse también sslConfiguration() y QSslSocket::setSslConfiguration().

QSslConfiguration QSslServer::sslConfiguration() const

Devuelve la configuración SSL actual.

Véase también setSslConfiguration().

[signal] void QSslServer::sslErrors(QSslSocket *socket, const QList<QSslError> &errors)

QSslServer Emite esta señal tras el protocolo de enlace SSL para indicar que se han producido uno o más errores al establecer la identidad del interlocutor. Estos errores suelen indicar que socket no puede identificar de forma segura al interlocutor. A menos que se tome alguna medida, la conexión se interrumpirá tras la emisión de esta señal.

Si deseas continuar con la conexión a pesar de los errores que se han producido, debes llamar a ` QSslSocket::ignoreSslErrors()` desde una ranura conectada a esta señal. Si necesitas acceder a la lista de errores más adelante, puedes llamar a `sslHandshakeErrors()`.

errors contiene uno o más errores que impiden que ` QSslSocket ` verifique la identidad del par.

Nota: Nopuedes utilizar Qt::QueuedConnection al conectarte a esta señal; de lo contrario, llamar a QSslSocket::ignoreSslErrors() no tendrá ningún efecto.

Véase también peerVerifyError().

[signal] void QSslServer::startedEncryptionHandshake(QSslSocket *socket)

Esta señal se emite cuando el cliente, conectado a socket, inicia el protocolo de enlace TLS.

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