QAuthenticator Class
Die Klasse QAuthenticator bietet ein Authentifizierungsobjekt. Mehr...
| Kopfzeile: | #include <QAuthenticator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network)target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAuthenticator ist Teil der Network Programming API.
Hinweis: Alle Funktionen in dieser Klasse sind reentrant.
Öffentliche Funktionen
| QAuthenticator() | |
| QAuthenticator(const QAuthenticator &other) | |
| ~QAuthenticator() | |
| 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 |
Detaillierte Beschreibung
Die Klasse QAuthenticator wird normalerweise in den Signalen authenticationRequired() und proxyAuthenticationRequired() von QNetworkAccessManager und QAbstractSocket verwendet. Die Klasse bietet eine Möglichkeit, die erforderlichen Authentifizierungsinformationen an den Socket zurückzugeben, wenn auf Dienste zugegriffen wird, die eine Authentifizierung erfordern.
QAuthenticator unterstützt die folgenden Authentifizierungsmethoden:
- Basic
- NTLM Version 2
- Digest-MD5
- SPNEGO/Negotiate
Optionen
Neben dem Benutzernamen und dem Passwort, die für die Authentifizierung erforderlich sind, kann ein QAuthenticator-Objekt auch zusätzliche Optionen enthalten. Mit der Funktion options() können die vom Server gesendeten eingehenden Optionen abgefragt werden; mit der Funktion setOption() können ausgehende Optionen gesetzt werden, die von der Authenticator-Berechnung verarbeitet werden sollen. Welche Optionen akzeptiert und bereitgestellt werden, hängt vom Authentifizierungstyp ab (siehe method()).
In den folgenden Tabellen sind sowohl die bekannten eingehenden Optionen als auch die akzeptierten ausgehenden Optionen aufgeführt. Die Liste der eingehenden Optionen ist nicht erschöpfend, da Server jederzeit zusätzliche Informationen einfügen können. Die Liste der ausgehenden Optionen ist jedoch vollständig, und unbekannte Optionen werden nicht behandelt oder an den Server zurückgeschickt.
Grundlegend
| Option | Richtung | Typ | Beschreibung |
|---|---|---|---|
realm | Eingehend | QString | Enthält den Bereich der Authentifizierung, derselbe wie realm() |
Der Basic-Authentifizierungsmechanismus unterstützt keine ausgehenden Optionen.
NTLM Version 2
Der NTLM-Authentifizierungsmechanismus unterstützt derzeit keine eingehenden oder ausgehenden Optionen. Wenn unter Windows keine user festgelegt wurde, wird auf dem lokalen System nach Domänenbenutzeranmeldeinformationen gesucht, um die Single-Sign-On-Funktionalität zu aktivieren.
Digest-MD5
| Option | Richtung | Typ | Beschreibung |
|---|---|---|---|
realm | Eingehend | QString | Enthält den Bereich der Authentifizierung, derselbe wie realm() |
Der Digest-MD5-Authentifizierungsmechanismus unterstützt keine ausgehenden Optionen.
SPNEGO/Negotiate
| Option | Richtung | Typ | Beschreibung |
|---|---|---|---|
spn | Ausgehend | QString | Stellt einen benutzerdefinierten SPN bereit. |
Dieser Authentifizierungsmechanismus unterstützt derzeit keine eingehenden Optionen.
Die Eigenschaft spn wird auf Windows-Clients verwendet, wenn eine SSPI-Bibliothek verwendet wird. Wenn die Eigenschaft nicht gesetzt ist, wird ein Standard-SPN verwendet. Der Standard-SPN unter Windows lautet HTTP/<hostname>.
Andere Betriebssysteme verwenden GSSAPI-Bibliotheken. Dafür wird erwartet, dass das KDC eingerichtet ist und die Anmeldeinformationen von dort geholt werden können. Das Backend verwendet immer HTTPS@<hostname> als SPN.
Siehe auch QSslSocket.
Dokumentation der Mitgliedsfunktionen
QAuthenticator::QAuthenticator()
Konstruiert ein leeres Authentifizierungsobjekt.
QAuthenticator::QAuthenticator(const QAuthenticator &other)
Konstruiert eine Kopie von other.
[noexcept] QAuthenticator::~QAuthenticator()
Zerstört das Objekt.
bool QAuthenticator::isNull() const
Gibt true zurück, wenn das Objekt nicht initialisiert wurde. Gibt false zurück, wenn nicht-konstante Mitgliedsfunktionen aufgerufen wurden, oder der Inhalt von einem anderen initialisierten QAuthenticator Objekt konstruiert oder kopiert wurde.
QVariant QAuthenticator::option(const QString &opt) const
Gibt den Wert für die Option opt zurück, wenn sie vom Server gesetzt wurde. Weitere Informationen über eingehende Optionen finden Sie unter Options section. Wenn die Option opt nicht gefunden wird, wird ein ungültiger QVariant zurückgegeben.
Siehe auch setOption(), options(), und QAuthenticator options.
QVariantHash QAuthenticator::options() const
Gibt alle eingehenden Optionen zurück, die in diesem QAuthenticator Objekt durch Parsen der Serverantwort gesetzt wurden. Siehe Options section für weitere Informationen über eingehende Optionen.
Siehe auch option() und QAuthenticator options.
QString QAuthenticator::password() const
Gibt das für die Authentifizierung verwendete Passwort zurück.
Siehe auch setPassword().
QString QAuthenticator::realm() const
Gibt den Realm zurück, der eine Authentifizierung erfordert.
void QAuthenticator::setOption(const QString &opt, const QVariant &value)
Setzt die ausgehende Option opt auf den Wert value. Weitere Informationen über ausgehende Optionen finden Sie unter Options section.
Siehe auch options(), option(), und QAuthenticator options.
void QAuthenticator::setPassword(const QString &password)
Legt die für die Authentifizierung verwendete password fest.
Siehe auch password() und QNetworkAccessManager::authenticationRequired().
void QAuthenticator::setUser(const QString &user)
Legt die für die Authentifizierung verwendete user fest.
Siehe auch user() und QNetworkAccessManager::authenticationRequired().
QString QAuthenticator::user() const
Gibt den für die Authentifizierung verwendeten Benutzer zurück.
Siehe auch setUser().
bool QAuthenticator::operator!=(const QAuthenticator &other) const
Gibt true zurück, wenn sich dieser Authentifikator von other unterscheidet; andernfalls wird false zurückgegeben.
QAuthenticator &QAuthenticator::operator=(const QAuthenticator &other)
Weist diesem Authentifikator den Inhalt von other zu.
bool QAuthenticator::operator==(const QAuthenticator &other) const
Gibt true zurück, wenn dieser Authentifikator mit other identisch ist; andernfalls wird false zurückgegeben.
© 2025 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.
