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 socket がPSK暗号スイートをネゴシエートする際、この信号を発信します。そのため、その後PSK認証が必要となります。

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ハンドシェイク後にこのシグナルを発行し、対等側の身元確認中に1つ以上のエラーが発生したことを示します。これらのエラーは通常、socket が対等側を安全に識別できないことを示しています。何らかの措置を講じない限り、このシグナルが発行された後に接続は切断されます。

発生したエラーにもかかわらず接続を継続したい場合は、このシグナルに接続されたスロット内から `QSslSocket::ignoreSslErrors()` を呼び出す必要があります。後でエラーリストにアクセスする必要がある場合は、`sslHandshakeErrors()` を呼び出すことができます。

errors QSslSocket が相手先の身元を検証できない原因となるエラーが 1 つ以上含まれています。

peerVerifyError()も参照してください 。

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

このシグナルは、socket に接続しているクライアントが TLS ハンドシェイクを開始したときに発生します。