QSslServer Class

Documentación de Funciones Miembro

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

Construye un nuevo QSslServer con la dirección parent.

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

Destruye la página 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 socket ha recibido un mensaje de alerta de un par. level indica si la alerta era fatal o era una advertencia. type es el código que explica por qué se envió la alerta. Cuando se dispone de una descripción textual del mensaje de alerta, se proporciona en description.

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 describe si se trata de una advertencia o de un error fatal. type proporciona el código del mensaje de alerta. Cuando se dispone de una descripción textual del mensaje de alerta, se proporciona en description.

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

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

Esta señal se emite tras producirse un error durante el handshake. El parámetro socketError describe el tipo de error que se ha producido.

El socket se elimina automáticamente después de que se emita esta señal si el handshake del socket no ha alcanzado el estado cifrado. Pero si el socket se encripta con éxito, se inserta en la cola de conexiones pendientes del QSslServer. Cuando el usuario ha llamado a QTcpServer::nextPendingConnection() es responsabilidad del usuario destruir el socket o el socket no será destruido hasta que el objeto QSslServer sea destruido. 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á.

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 encontrado un error de verificación de certificado y si se ha activado la notificación anticipada de errores en QSslConfiguration. Se espera que una aplicación inspeccione error y decida si quiere continuar con el handshake, o abortarlo y enviar un mensaje de alerta al peer. 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 del handshake actualmente configurado.

Véase también setHandshakeTimeout().

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

Reimplementa: QTcpServer::incomingConnection(qintptr socketDescriptor).

Llamada cuando se establece una nueva conexión.

Convierte socket a QSslSocket.

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

QSslServer puede emitir esta señal varias veces durante el handshake SSL, antes de que se haya establecido el cifrado, para indicar que se ha producido un error al establecer la identidad del peer. La error suele ser una indicación de que socket es incapaz de identificar de forma segura al peer.

Esta señal te proporciona una indicación temprana de que algo va mal. Al conectarte a esta señal, puedes elegir manualmente cortar la conexión desde dentro de la ranura conectada antes de que el apretón de manos haya finalizado. Si no se realiza ninguna acción, 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 ciphersuite PSK, y por lo tanto la autenticación PSK es entonces requerida.

Cuando se utiliza PSK, el servidor debe proporcionar una identidad válida y una clave precompartida válida para que el protocolo SSL pueda continuar. Las aplicaciones pueden proporcionar esta información en una ranura conectada a esta señal, rellenando el objeto authenticator pasado según sus necesidades.

Véase también QSslPreSharedKeyAuthenticator.

void QSslServer::setHandshakeTimeout(int timeout)

Establece el timeout a utilizar para todos los handshakes entrantes, en milisegundos.

Esto es relevante en el escenario en el que un cliente, ya sea malicioso o accidental, se conecta al servidor pero no hace ningún intento de comunicación o de iniciar un handshake. QSslServer entonces finalizará automáticamente la conexión después de que hayan transcurrido timeout milisegundos.

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

Véase también handshakeTimeout().

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

Establece el sslConfiguration a utilizar para todas las siguientes conexiones entrantes.

Esto debe ser llamado antes de listen() para asegurar que la configuración deseada estuvo en uso durante todos los handshakes.

Véase 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 después del handshake SSL para indicar que se han producido uno o más errores al establecer la identidad del peer. Los errores son normalmente una indicación de que socket es incapaz de identificar de forma segura al peer. A menos que se realice alguna acción, la conexión se interrumpirá tras la emisión de esta señal.

Si desea continuar la conexión a pesar de los errores que se han producido, debe llamar a QSslSocket::ignoreSslErrors() desde dentro de una ranura conectada a esta señal. Si necesitas acceder a la lista de errores en un momento posterior, puedes llamar a sslHandshakeErrors().

errors contiene uno o más errores que impiden a QSslSocket verificar la identidad del peer.

Véase también peerVerifyError().

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

Esta señal se emite cuando el cliente, conectado a socket, inicia el handshake TLS.