QAuthenticator Class
La clase QAuthenticator proporciona un objeto de autenticación. Más...
| Cabecera: | #include <QAuthenticator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network)target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los heredados
- QAuthenticator es parte de la API de programación de redes.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones Públicas
| 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 |
Descripción detallada
La clase QAuthenticator se utiliza normalmente en las señales authenticationRequired() y proxyAuthenticationRequired() de QNetworkAccessManager y QAbstractSocket. La clase provee una forma de pasar la información de autenticación requerida al socket cuando se accede a servicios que requieren autenticación.
QAuthenticator soporta los siguientes métodos de autenticación:
- Básico
- NTLM versión 2
- Digest-MD5
- SPNEGO/Negociar
Opciones
Además del nombre de usuario y la contraseña necesarios para la autenticación, un objeto QAuthenticator también puede contener opciones adicionales. La función options() puede utilizarse para consultar las opciones entrantes enviadas por el servidor; la función setOption() puede utilizarse para establecer las opciones salientes, que serán procesadas por el cálculo del autenticador. Las opciones aceptadas y proporcionadas dependen del tipo de autenticación (véase method()).
En las tablas siguientes se enumeran las opciones entrantes conocidas, así como las opciones salientes aceptadas. La lista de opciones entrantes no es exhaustiva, ya que los servidores pueden incluir información adicional en cualquier momento. La lista de opciones salientes es exhaustiva, sin embargo, y ninguna opción desconocida será tratada o enviada de vuelta al servidor.
Básico
| Opción | Dirección | Tipo | Descripción |
|---|---|---|---|
realm | Entrante | QString | Contiene el dominio de la autenticación, igual que realm() |
El mecanismo de autenticación básica no admite opciones salientes.
NTLM versión 2
El mecanismo de autenticación NTLM no admite actualmente opciones entrantes ni salientes. En Windows, si no se ha configurado user, se buscarán las credenciales del dominio\user en el sistema local para habilitar la funcionalidad de inicio de sesión único.
Digest-MD5
| Opción | Dirección | Tipo | Descripción |
|---|---|---|---|
realm | Entrante | QString | Contiene el dominio de la autenticación, igual que realm() |
El mecanismo de autenticación Digest-MD5 no admite opciones salientes.
SPNEGO/Negociar
| Opción | Dirección | Tipo | Descripción |
|---|---|---|---|
spn | Saliente | QString | Proporciona un SPN personalizado. |
Este mecanismo de autenticación no admite actualmente opciones entrantes.
La propiedad spn se utiliza en clientes Windows cuando se utiliza una biblioteca SSPI. Si no se establece la propiedad, se utilizará un SPN predeterminado. El SPN por defecto en Windows es HTTP/<hostname>.
Otros sistemas operativos utilizan bibliotecas GSSAPI. Para ello, se espera que el KDC esté configurado y que las credenciales puedan obtenerse de él. El backend siempre utiliza HTTPS@<hostname> como SPN.
Véase también QSslSocket.
Documentación de las funciones miembro
QAuthenticator::QAuthenticator()
Construye un objeto de autenticación vacío.
QAuthenticator::QAuthenticator(const QAuthenticator &other)
Construye una copia de other.
[noexcept] QAuthenticator::~QAuthenticator()
Destruye el objeto.
[since 6.11] void QAuthenticator::clear()
Borra todas las credenciales y restablece el objeto a su estado no inicializado por defecto.
Esta función se introdujo en Qt 6.11.
bool QAuthenticator::isNull() const
Devuelve true si el objeto no ha sido inicializado. Devuelve false si se ha llamado a funciones miembro no-const, o el contenido se ha construido o copiado de otro objeto inicializado QAuthenticator.
QVariant QAuthenticator::option(const QString &opt) const
Devuelve el valor relacionado con la opción opt si fue establecida por el servidor. Consulte Options section para obtener más información sobre las opciones entrantes. Si no se encuentra la opción opt, se devolverá un QVariant inválido.
Véase también setOption(), options(), y QAuthenticator options.
QVariantHash QAuthenticator::options() const
Devuelve todas las opciones entrantes establecidas en este objeto QAuthenticator analizando la respuesta del servidor. Consulte Options section para obtener más información sobre las opciones entrantes.
Véase también option() y QAuthenticator options.
QString QAuthenticator::password() const
Devuelve la contraseña utilizada para la autenticación.
Véase también setPassword().
QString QAuthenticator::realm() const
Devuelve el dominio que requiere autenticación.
void QAuthenticator::setOption(const QString &opt, const QVariant &value)
Establece la opción de salida opt en el valor value. Consulte Options section para obtener más información sobre las opciones de salida.
Véase también options(), option(), y QAuthenticator options.
void QAuthenticator::setPassword(const QString &password)
Establece el password utilizado para la autenticación.
Véase también password() y QNetworkAccessManager::authenticationRequired().
void QAuthenticator::setUser(const QString &user)
Establece el user utilizado para la autenticación.
Véase también user() y QNetworkAccessManager::authenticationRequired().
QString QAuthenticator::user() const
Devuelve el usuario utilizado para la autenticación.
Véase también setUser().
bool QAuthenticator::operator!=(const QAuthenticator &other) const
Devuelve true si este autenticador es diferente de other; en caso contrario devuelve false.
QAuthenticator &QAuthenticator::operator=(const QAuthenticator &other)
Asigna el contenido de other a este autenticador.
bool QAuthenticator::operator==(const QAuthenticator &other) const
Devuelve true si este autenticador es idéntico a other; en caso contrario devuelve 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.
