QSslServer类

成员函数文档

[显式] QSslServer::QSslServer(QObject *parent = nullptr)

使用给定的parent构建一个新的QSslServer。

[覆盖虚函数，无异常] QSslServer::~QSslServer()

销毁QSslServer。

所有打开的连接都将被关闭。

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

QSslServer在从对等方接收报警信息时发出此信号。_level_指示报警是致命的还是警告。_type_是解释发送报警原因的代码。当用户可用报警信息的文本描述时，它将包含在_description_中。

另请参阅alertSent()、QSsl::AlertLevel和QSsl::AlertType。

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

QSslServer在从socket向对等方发送报警信息时发出此信号。《level》_描述它是警告还是致命错误。《type》_提供报警信息的代码。当可用文本描述报警信息时，它将包含在_description_中。

另请参阅alertReceived()、QSsl::AlertLevel和QSsl::AlertType。

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

此信号在握手过程中发生错误后发出。参数socketError描述了发生的错误类型。

如果socket握手未达到加密状态，则在发出此信号后，将自动删除socket。但如果socket成功加密，则将其插入到QSslServer的挂起连接队列中。当用户调用QTcpServer::nextPendingConnection() 时，有责任销毁socket或QSslServer对象将被销毁之前不会销毁socket。如果在挂起连接队列中的socket上发生错误，则不会发出此信号，并且不会删除或销毁socket。

另请参阅：QSslSocket::error() 和 errorString。

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

QSslServer发出此信号，如果socket发现证书验证错误，并且QSslConfiguration中启用了早期错误报告。应用程序应检查error并决定是否继续握手或中断它并发送警告消息到对等端。信号槽连接必须是直接的。

另请参阅：QSslSocket::continueInterruptedHandshake()、sslErrors() 和 QSslConfiguration::setHandshakeMustInterruptOnError。

int QSslServer::handshakeTimeout() const

返回当前配置的握手超时时间。

另请参阅：setHandshakeTimeout。

[重载虚受保护] void QSslServer::incomingConnection(qintptr socket)

重新实现了：QTcpServer::incomingConnection(qintptr socketDescriptor)。

当建立一个新连接时调用。

将socket转换为QSslSocket。

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

QSslServer 可以在建立加密之前在 SSL 握手过程中多次发出此信号，以指示在建立对等方身份时发生错误。此 错误 通常表明 套接字 无法安全地识别对等方。

此信号可让您在出现问题早期就得到提示。通过连接到此信号，您可以在握手完成之前手动选择断开已连接槽的连接。如果未采取任何行动，QSslServer 将继续发出 sslErrors()。

另请参阅sslErrors。

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

当 socket 协商 PSK 加密套件时，QSslServer 将发出此信号，因此需要 PSK 身份验证。

使用 PSK 时，服务器必须提供一个有效的身份和一个有效的预共享密钥，以便 SSL 握手可以继续。应用程序可以通过连接到此信号的槽来提供此信息，根据需要填充传入的 authenticator 对象。

另请参阅QSslPreSharedKeyAuthenticator。

void QSslServer::setHandshakeTimeout(int timeout)

将超时设置用于所有进入的握手中的超时，以毫秒为单位。

在客户端（无论是恶意还是意外）连接到服务器但未尝试通信或发起握手的情况下，这很相关。在此之后，QSslServer 将在经过 timeout 毫秒后自动结束连接。

默认超时为 5000 毫秒（5 秒）。

另请参阅handshakeTimeout。

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

设置后续进入连接要使用的 sslConfiguration。

必须在 listen() 调用之前调用此函数，以确保在整个握手过程中正在使用所需的配置。

另请参阅sslConfiguration() 和 QSslSocket::setSslConfiguration。

QSslConfiguration QSslServer::sslConfiguration() const

返回当前 SSL 配置。

另请参阅setSslConfiguration。

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

QSslServer在SSL握手后发出此信号，表示在建立对等实体身份时发生了一个或多个错误。这些错误通常表明socket无法安全地识别对等实体。除非采取任何操作，否则将在发出此信号后断开连接。

如果您想要继续连接，尽管发生了错误，您必须从连接到此信号的槽内部调用QSslSocket::ignoreSslErrors()。如果您需要在稍后的某个时间点访问错误列表，可以调用sslHandshakeErrors()。

errors包含一个或多个错误，阻止QSslSocket验证对等实体的身份。

另请参阅：peerVerifyError。

[信号] void QSslServer::startedEncryptionHandshake(QSslSocket *socket)

当连接到socket的客户端开始TLS握手时，将发出此信号。