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 を破棄するのはユーザの責任であり、socket はQSslServer オブジェクトが破棄されるまで破棄されない。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 ハンドシェイクの間、暗号化が確立される前にこのシグナルを何度か発して、相手の ID を確立する際にエラーが発生したことを示すことができます。 は通常、 がピアを安全に識別できないことを示す。error socket

このシグナルは、何か問題が発生したときに、その兆候を早期に示してくれる。このシグナルに接続することで、ハンドシェイクが完了する前に、接続されたスロットの内部から手動で接続を切断することを選択できる。何もアクションを起こさなければ、QSslServer はsslErrors()の発信に進む。

sslErrors()も参照 。

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

QSslServer は、 がPSK暗号化方式をネゴシエートし、PSK認証が必要になると、 このシグナルを発する。socket

PSKを使用する場合、SSLハンドシェイクを継続するために、サーバーは有効なIDと有効な事前共有鍵を提供しなければならない。アプリケーションはこのシグナルに接続されたスロットに、渡された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 ハンドシェイクの後にこのシグナルを発し、 ピアの ID を確立する際に 1 つ以上のエラーが発生したことを示す。エラーは通常、 がピアを安全に識別できないことを示すものである。何らかのアクションを取らない限り、このシグナルが発せられた後に接続は切断されます。socket

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

errors には、 がピアの ID を検証できないようなエラーが 1 つ以上含まれている。QSslSocket

peerVerifyError()も参照 。

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

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