QSslServer Class

Documentation des fonctions membres

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

Construit un nouveau QSslServer avec l'adresse parent.

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

Détruit le site QSslServer.

Toutes les connexions ouvertes sont fermées.

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

QSslServer émet ce signal si un message d'alerte a été reçu par socket de la part d'un homologue. level indique si l'alerte était fatale ou s'il s'agissait d'un avertissement. type est le code expliquant pourquoi l'alerte a été envoyée. Lorsqu'une description textuelle du message d'alerte est disponible, elle est fournie dans description.

Voir aussi alertSent(), QSsl::AlertLevel, et QSsl::AlertType.

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

QSslServer émet ce signal si un message d'alerte a été envoyé par socket à un homologue. level indique s'il s'agit d'un avertissement ou d'une erreur fatale. type donne le code du message d'alerte. Lorsqu'une description textuelle du message d'alerte est disponible, elle est fournie dans description.

Voir aussi alertReceived(), QSsl::AlertLevel, et QSsl::AlertType.

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

Ce signal est émis lorsqu'une erreur s'est produite lors de la prise de contact. Le paramètre socketError décrit le type d'erreur qui s'est produite.

L'adresse socket est automatiquement supprimée après l'émission de ce signal si le handshake de la socket n'a pas atteint l'état crypté. Mais si le socket est crypté avec succès, il est inséré dans la file d'attente des connexions en attente du QSslServer. Lorsque l'utilisateur a appelé QTcpServer::nextPendingConnection(), il lui incombe de détruire l'objet socket, sinon l'objet socket ne sera pas détruit tant que l'objet QSslServer ne l'aura pas été. Si une erreur survient sur un objet socket après qu'il a été inséré dans la file d'attente des connexions en attente, ce signal n'est pas émis et l'objet socket n'est ni supprimé ni détruit.

Voir aussi QSslSocket::error() et errorString().

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

QSslServer émet ce signal si une erreur de vérification de certificat a été détectée par socket et si le signalement précoce des erreurs a été activé dans QSslConfiguration. Une application est censée inspecter le site error et décider si elle souhaite poursuivre la poignée de main ou l'interrompre et envoyer un message d'alerte à l'homologue. La connexion signal-slot doit être directe.

Voir également QSslSocket::continueInterruptedHandshake(), sslErrors() et QSslConfiguration::setHandshakeMustInterruptOnError().

int QSslServer::handshakeTimeout() const

Renvoie le délai d'attente de la poignée de main actuellement configuré.

Voir aussi setHandshakeTimeout().

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

Réimplémente : QTcpServer::incomingConnection(qintptr socketDescriptor).

Appelé lorsqu'une nouvelle connexion est établie.

Convertit socket en QSslSocket.

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

QSslServer peut émettre ce signal plusieurs fois au cours de la poignée de main SSL, avant que le cryptage n'ait été établi, pour indiquer qu'une erreur s'est produite lors de l'établissement de l'identité de l'homologue. Le signal error indique généralement que socket n'est pas en mesure d'identifier l'homologue de manière sécurisée.

Ce signal vous permet de savoir rapidement si quelque chose ne va pas. En vous connectant à ce signal, vous pouvez choisir manuellement de couper la connexion à partir du slot connecté avant que la poignée de main ne soit terminée. Si aucune action n'est entreprise, QSslServer émettra sslErrors().

Voir aussi sslErrors().

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

QSslServer émet ce signal lorsque socket négocie une suite de chiffrement PSK, et que l'authentification PSK est donc requise.

Lors de l'utilisation de la PSK, le serveur doit fournir une identité valide et une clé prépartagée valide pour que la poignée de main SSL puisse se poursuivre. Les applications peuvent fournir ces informations dans un slot connecté à ce signal, en remplissant l'objet authenticator en fonction de leurs besoins.

Voir également QSslPreSharedKeyAuthenticator.

void QSslServer::setHandshakeTimeout(int timeout)

Définit l'adresse timeout à utiliser pour toutes les prises de contact entrantes, en millisecondes.

Ceci est important dans le cas où un client, qu'il soit malveillant ou accidentel, se connecte au serveur mais ne tente pas de communiquer ou d'initier une poignée de main. QSslServer mettra alors automatiquement fin à la connexion après que timeout millisecondes se soient écoulées.

Par défaut, le délai d'attente est de 5000 millisecondes (5 secondes).

Voir aussi handshakeTimeout().

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

Définit le sslConfiguration à utiliser pour toutes les connexions entrantes suivantes.

Il doit être appelé avant listen() pour s'assurer que la configuration souhaitée a été utilisée lors de tous les échanges.

Voir aussi sslConfiguration() et QSslSocket::setSslConfiguration().

QSslConfiguration QSslServer::sslConfiguration() const

Renvoie la configuration ssl actuelle.

Voir aussi setSslConfiguration().

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

QSslServer émet ce signal après la poignée de main SSL pour indiquer qu'une ou plusieurs erreurs se sont produites lors de l'établissement de l'identité de l'homologue. Ces erreurs indiquent généralement que socket n'est pas en mesure d'identifier l'homologue de manière sécurisée. Si aucune action n'est entreprise, la connexion sera interrompue après l'émission de ce signal.

Si vous voulez continuer à vous connecter malgré les erreurs qui se sont produites, vous devez appeler QSslSocket::ignoreSslErrors() à partir d'un slot connecté à ce signal. Si vous devez accéder à la liste des erreurs ultérieurement, vous pouvez appeler sslHandshakeErrors().

errors contient une ou plusieurs erreurs qui empêchent QSslSocket de vérifier l'identité de l'homologue.

Voir aussi peerVerifyError().

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

Ce signal est émis lorsque le client, connecté à socket, initie la poignée de main TLS.