QSslServer Class

成员函数文档

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

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

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

销毁QSslServer 。

关闭所有打开的连接。

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

QSslServer 如果 收到来自对等程序的警报信息，则会发出该信号。 说明警报是致命的还是警告。 是解释为何发送警报的代码。如果有关于警报信息的文字说明，则在 中提供。socket level type description

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

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

QSslServer socket level ，说明是警告还是致命错误。 给出了警报信息的代码。如果有警报信息的文本描述，则在 中提供。type description

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

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

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

如果套接字握手未达到加密状态，则socket 会在此信号发出后被自动删除。但如果socket 成功加密，则会插入QSslServer 的待处理连接队列。当用户调用QTcpServer::nextPendingConnection() 后，用户有责任销毁socket ，否则在QSslServer 对象被销毁之前，socket 不会被销毁。如果socket 在插入待处理连接队列后发生错误，则不会发出此信号，也不会删除或销毁socket 。

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

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

QSslServer 如果 发现证书验证错误，且 启用了早期错误报告功能，则会发出该信号。应用程序应检查 ，决定是继续握手，还是中止握手并向对等方发送警报信息。信号槽连接必须是直接连接。socket QSslConfiguration error

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

int QSslServer::handshakeTimeout() const

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

另请参阅 setHandshakeTimeout()。

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

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

建立新连接时调用。

将socket 转换为QSslSocket 。

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

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

当出现问题时，该信号会向你提供早期提示。通过连接到该信号，您可以在握手完成前从连接的插槽内手动选择中断连接。如果不采取任何行动，QSslServer 将继续发出sslErrors() 。

另请参阅 sslErrors()。

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

QSslServer 当 协商 PSK 密码套件时会发出该信号，因此需要进行 PSK 验证。socket

使用 PSK 时，服务器必须提供有效的身份和有效的预共享密钥，才能继续进行 SSL 握手。应用程序可以根据自己的需要，通过填写传递的authenticator 对象，在与该信号相连的插槽中提供这些信息。

另请参阅 QSslPreSharedKeyAuthenticator 。

void QSslServer::setHandshakeTimeout(int timeout)

为所有传入握手设置timeout ，单位为毫秒。

如果客户端（无论是恶意的还是意外的）连接到服务器，但没有尝试通信或发起握手，QSslServer 就会在timeout 毫秒后自动结束连接。

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

另请参阅 handshakeTimeout()。

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

设置sslConfiguration ，以用于接下来的所有传入连接。

必须在listen() 之前调用，以确保在所有握手过程中使用所需的配置。

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

QSslConfiguration QSslServer::sslConfiguration() const

返回当前的 SSL 配置。

另请参阅 setSslConfiguration().

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

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

如果想在发生错误的情况下继续连接，则必须在连接到此信号的槽内调用QSslSocket::ignoreSslErrors() 。如果以后需要访问错误列表，可以调用 sslHandshakeErrors()。

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

另请参阅 peerVerifyError()。

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

当连接到socket 的客户端启动 TLS 握手时，会发出该信号。