QAuthenticator Class
La classe QAuthenticator fournit un objet d'authentification. Plus d'informations...
| En-tête : | #include <QAuthenticator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Network)target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake : | QT += network |
- Liste de tous les membres, y compris les membres hérités
- QAuthenticator fait partie de l'API de programmation réseau.
Note : Toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| QAuthenticator() | |
| QAuthenticator(const QAuthenticator &other) | |
| ~QAuthenticator() | |
(since 6.11) void | clear() |
| bool | isNull() const |
| QVariant | option(const QString &opt) const |
| QVariantHash | options() const |
| QString | password() const |
| QString | realm() const |
| void | setOption(const QString &opt, const QVariant &value) |
| void | setPassword(const QString &password) |
| void | setUser(const QString &user) |
| QString | user() const |
| bool | operator!=(const QAuthenticator &other) const |
| QAuthenticator & | operator=(const QAuthenticator &other) |
| bool | operator==(const QAuthenticator &other) const |
Description détaillée
La classe QAuthenticator est généralement utilisée dans les signaux authenticationRequired() et proxyAuthenticationRequired() de QNetworkAccessManager et QAbstractSocket. Cette classe permet de renvoyer les informations d'authentification requises à la socket lors de l'accès à des services nécessitant une authentification.
QAuthenticator prend en charge les méthodes d'authentification suivantes :
- Basique
- NTLM version 2
- Digest-MD5
- SPNEGO/Négociation
Options
Outre le nom d'utilisateur et le mot de passe requis pour l'authentification, un objet QAuthenticator peut également contenir des options supplémentaires. La fonction options() peut être utilisée pour interroger les options entrantes envoyées par le serveur ; la fonction setOption() peut être utilisée pour définir les options sortantes, qui seront traitées par le calcul de l'authentificateur. Les options acceptées et fournies dépendent du type d'authentification (voir method()).
Les tableaux suivants énumèrent les options entrantes connues ainsi que les options sortantes acceptées. La liste des options entrantes n'est pas exhaustive, car les serveurs peuvent inclure des informations supplémentaires à tout moment. La liste des options sortantes est exhaustive, cependant, et aucune option inconnue ne sera traitée ou renvoyée au serveur.
De base
| Option | Direction | Type d'option | Description de l'option |
|---|---|---|---|
realm | Entrant | QString | Contient le domaine de l'authentification, le même que realm() |
Le mécanisme d'authentification de base ne prend en charge aucune option sortante.
NTLM version 2
Le mécanisme d'authentification NTLM ne prend actuellement en charge aucune option entrante ou sortante. Sous Windows, si aucune adresse user n'a été définie, les informations d'identification du domaine\user seront recherchées sur le système local afin d'activer la fonctionnalité de signature unique.
Digest-MD5
| Option | Direction | Type d'option | Description de l'option |
|---|---|---|---|
realm | Entrant | QString | Contient le domaine de l'authentification, le même que realm() |
Le mécanisme d'authentification Digest-MD5 ne prend en charge aucune option sortante.
SPNEGO/Négocier
| Option | Direction | Type d'option | Description de l'option |
|---|---|---|---|
spn | Sortant | QString | Fournit un SPN personnalisé. |
Ce mécanisme d'authentification ne prend actuellement en charge aucune option entrante.
La propriété spn est utilisée sur les clients Windows lorsqu'une bibliothèque SSPI est utilisée. Si la propriété n'est pas définie, un SPN par défaut sera utilisé. Le SPN par défaut sous Windows est HTTP/<hostname>.
D'autres systèmes d'exploitation utilisent des bibliothèques GSSAPI. Pour cela, il faut que le KDC soit configuré et que les informations d'identification puissent être récupérées à partir de celui-ci. Le backend utilise toujours HTTPS@<hostname> comme SPN.
Voir également QSslSocket.
Documentation des fonctions membres
QAuthenticator::QAuthenticator()
Construit un objet d'authentification vide.
QAuthenticator::QAuthenticator(const QAuthenticator &other)
Construit une copie de other.
[noexcept] QAuthenticator::~QAuthenticator()
Détruit l'objet.
[since 6.11] void QAuthenticator::clear()
Efface toutes les informations d'identification et réinitialise l'objet à son état non initialisé par défaut.
Cette fonction a été introduite dans Qt 6.11.
bool QAuthenticator::isNull() const
Renvoie true si l'objet n'a pas été initialisé. Renvoie false si des fonctions membres non-const ont été appelées, ou si le contenu a été construit ou copié à partir d'un autre objet initialisé QAuthenticator.
QVariant QAuthenticator::option(const QString &opt) const
Renvoie la valeur liée à l'option opt si elle a été définie par le serveur. Voir Options section pour plus d'informations sur les options entrantes. Si l'option opt n'est pas trouvée, une valeur invalide QVariant sera renvoyée.
Voir aussi setOption(), options(), et QAuthenticator options.
QVariantHash QAuthenticator::options() const
Renvoie toutes les options entrantes définies dans cet objet QAuthenticator en analysant la réponse du serveur. Voir Options section pour plus d'informations sur les options entrantes.
Voir aussi option() et QAuthenticator options.
QString QAuthenticator::password() const
Renvoie le mot de passe utilisé pour l'authentification.
Voir aussi setPassword().
QString QAuthenticator::realm() const
Renvoie le domaine nécessitant une authentification.
void QAuthenticator::setOption(const QString &opt, const QVariant &value)
Définit l'option de sortie opt à la valeur value. Voir Options section pour plus d'informations sur les options de sortie.
Voir également options(), option() et QAuthenticator options.
void QAuthenticator::setPassword(const QString &password)
Définit l'adresse password utilisée pour l'authentification.
Voir aussi password() et QNetworkAccessManager::authenticationRequired().
void QAuthenticator::setUser(const QString &user)
Définit l'adresse user utilisée pour l'authentification.
Voir aussi user() et QNetworkAccessManager::authenticationRequired().
QString QAuthenticator::user() const
Renvoie l'utilisateur utilisé pour l'authentification.
Voir aussi setUser().
bool QAuthenticator::operator!=(const QAuthenticator &other) const
Renvoie true si cet authentificateur est différent de other; sinon, renvoie false.
QAuthenticator &QAuthenticator::operator=(const QAuthenticator &other)
Attribue le contenu de other à cet authentificateur.
bool QAuthenticator::operator==(const QAuthenticator &other) const
Renvoie true si cet authentificateur est identique à other; sinon, renvoie false.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
