QSslServer Class

Documentation des fonctions membres

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

Crée un nouvel objet QSslServer avec l'parent spécifiée.

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

Supprime l'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 l'socket e de la part d'un pair. 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 également 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é depuis socket à un pair. level indique s'il s'agissait d'un avertissement ou d'une erreur fatale. type fournit le code du message d'alerte. Lorsqu'une description textuelle du message d'alerte est disponible, elle est fournie dans description.

Voir également 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 au cours de la phase d'établissement de la connexion. Le paramètre « socketError » décrit le type d'erreur survenue.

L’ socket est automatiquement supprimée après l’émission de ce signal si l’établissement de la connexion socket n’a pas atteint l’état chiffré. En revanche, si l’ socket est chiffrée avec succès, elle est insérée dans la file d’attente des connexions en attente de l’ QSslServer. Lorsque l’utilisateur a appelé la fonction QTcpServer::nextPendingConnection(), il lui incombe de détruire l’ socket; sinon, l’ socket ne sera pas détruite tant que l’objet QSslServer n’aura pas été détruit. Si une erreur survient sur une socket après son insertion dans la file d’attente des connexions en attente, ce signal ne sera pas émis, et l’ socket ne sera ni supprimée ni détruite.

Voir également 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 la notification précoce des erreurs a été activée dans QSslConfiguration. L'application doit examiner la valeur de error et décider si elle souhaite poursuivre la négociation de connexion ou l'interrompre et envoyer un message d'alerte au pair. La connexion signal-slot doit être directe.

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

int QSslServer::handshakeTimeout() const

Renvoie le délai d'expiration de la négociation de connexion actuellement configuré.

Voir également setHandshakeTimeout().

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

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

Appelée lorsqu’une nouvelle connexion est établie.

Convertit ` socket ` en un ` QSslSocket`.

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

QSslServer peut émettre ce signal à plusieurs reprises au cours de la négociation SSL, avant que le chiffrement ne soit établi, pour signaler qu'une erreur s'est produite lors de la vérification de l'identité du pair. Le signal « error » indique généralement que socket n'est pas en mesure d'identifier le pair de manière sécurisée.

Ce signal vous alerte rapidement lorsqu’un problème survient. En vous connectant à ce signal, vous pouvez choisir manuellement de rompre la connexion depuis l’intérieur du slot connecté avant que la négociation ne soit terminée. Si aucune action n’est entreprise, ` QSslServer ` émettra alors ` sslErrors()` ().

Voir également sslErrors().

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

QSslServer émet ce signal lorsque socket négocie un ensemble de chiffrement PSK ; l'authentification PSK est alors requise.

Lors de l’utilisation d’une clé pré-partagée (PSK), le serveur doit fournir une identité valide et une clé pré-partagée valide pour que la négociation SSL puisse se poursuivre. Les applications peuvent fournir ces informations dans un slot connecté à ce signal, en remplissant l’objet ` authenticator ` transmis en fonction de leurs besoins.

Voir aussi QSslPreSharedKeyAuthenticator.

void QSslServer::setHandshakeTimeout(int timeout)

Définit la durée de la phase de négociation ( timeout ) à utiliser pour toutes les connexions entrantes, en millisecondes.

Ceci s'applique dans le cas où un client, qu'il soit malveillant ou qu'il s'agisse d'une connexion accidentelle, se connecte au serveur sans tenter de communiquer ni d'initier une procédure de connexion. QSslServer mettra alors automatiquement fin à la connexion après l'écoulement de timeout millisecondes.

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

Voir également handshakeTimeout().

void QSslServer::setSslConfiguration(const QSslConfiguration &sslConfiguration)

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

Cette fonction doit être appelée avant listen() afin de garantir que la configuration souhaitée a bien été utilisée pendant toutes les procédures d'établissement de connexion.

Voir également ` 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 négociation SSL pour indiquer qu'une ou plusieurs erreurs se sont produites lors de l'établissement de l'identité du pair. Ces erreurs indiquent généralement que ` socket ` est incapable d'identifier le pair de manière sécurisée. À moins qu'une action ne soit entreprise, la connexion sera interrompue après l'émission de ce signal.

Si vous souhaitez poursuivre la connexion malgré les erreurs survenues, vous devez appeler la fonction ` QSslSocket::ignoreSslErrors()` depuis un slot connecté à ce signal. Si vous avez besoin d’accéder à la liste des erreurs ultérieurement, vous pouvez appeler la fonction `sslHandshakeErrors()`.

errors contient une ou plusieurs erreurs qui empêchent ` QSslSocket ` de vérifier l’identité du pair.

Voir également peerVerifyError().

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

Ce signal est émis lorsque le client, connecté à socket, lance la procédure d'établissement de la connexion TLS.