QAuthenticator Class
La clase QAuthenticator proporciona un objeto de autenticación. Más información...
| Encabezado: | #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 forma parte de la API de programación de red.
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 habitualmente en las señales ` authenticationRequired()` y ` proxyAuthenticationRequired()` de ` QNetworkAccessManager ` y ` QAbstractSocket`. La clase permite devolver la información de autenticación necesaria al socket al acceder a servicios que requieren autenticación.
QAuthenticator admite los siguientes métodos de autenticación:
- Básico
- NTLM versión 2
- Digest-MD5
- SPNEGO/Negotiate
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() se puede utilizar para consultar las opciones entrantes enviadas por el servidor; la función setOption() se puede utilizar 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()).
Las siguientes tablas 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. Sin embargo, la lista de opciones salientes sí es exhaustiva, por lo que no se tratarán ni se enviarán de vuelta al servidor opciones desconocidas.
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 de salida.
NTLM versión 2
El mecanismo de autenticación NTLM no admite actualmente ninguna opción de entrada ni de salida. En Windows, si no se ha configurado ningún « user », se buscarán en el sistema local las credenciales de dominio\user 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 de salida.
SPNEGO/Negotiate
| Opción | Dirección | Tipo | Descripción |
|---|---|---|---|
spn | Saliente | QString | Proporciona un SPN personalizado. |
Este mecanismo de autenticación no admite actualmente opciones de entrada.
La propiedad « spn » se utiliza en clientes Windows cuando se emplea una biblioteca SSPI. Si no se configura esta propiedad, se utilizará un SPN predeterminado. El SPN predeterminado 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 a través de él. El backend siempre utiliza HTTPS@<hostname> como SPN.
Consideraciones de seguridad
QAuthenticator almacena internamente credenciales como nombres de usuario y contraseñas utilizando tipos de datos de uso general (QString, QByteArray) que no garantizan el borrado seguro de su contenido de la memoria tras su destrucción. La información de las credenciales puede persistir en páginas del montón liberadas, volcados de memoria, archivos de intercambio o en la memoria del proceso después de que un objeto QAuthenticator sea destruido o borrado.
Cuando se negocia la autenticación básica, las credenciales se transmiten utilizando la codificación Base64, que es fácilmente reversible. La autenticación básica solo debe utilizarse en conexiones cifradas con TLS. QAuthenticator no impone este requisito; las aplicaciones son responsables de garantizar la seguridad del transporte cuando se utiliza la autenticación básica.
QAuthenticator selecciona el método de autenticación más seguro que ofrece el servidor, utilizando un orden de prioridad interno fijo: Negotiate (Kerberos/SPNEGO), NTLM, Digest-MD5 y Basic. Actualmente, la aplicación no puede influir en esta selección ni restringir qué métodos son aceptables. Si un servidor o un proxy solo ofrece un método débil, este se utilizará sin previo aviso.
Las aplicaciones con requisitos estrictos en materia de seguridad de las credenciales deben tener esto en cuenta a la hora de decidir cómo y dónde utilizar QAuthenticator.
Véase también QSslSocket.
Documentación de las funciones miembro
QAuthenticator::QAuthenticator()
Crea un objeto de autenticación vacío.
QAuthenticator::QAuthenticator(const QAuthenticator &other)
Crea 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 predeterminado no inicializado.
Esta función se introdujo en Qt 6.11.
bool QAuthenticator::isNull() const
Devuelve ` true ` si el objeto no se ha inicializado. Devuelve ` false ` si se han llamado funciones miembro no const, o si el contenido se ha construido o copiado de otro objeto ` QAuthenticator ` inicializado.
QVariant QAuthenticator::option(const QString &opt) const
Devuelve el valor asociado a la opción opt si el servidor la ha establecido. Consulta Options section para obtener más información sobre las opciones entrantes. Si no se encuentra la opción opt, se devolverá un QVariant no válido.
Véanse también setOption(), options() y QAuthenticator options.
QVariantHash QAuthenticator::options() const
Devuelve todas las opciones entrantes configuradas en este objeto ` QAuthenticator ` mediante el análisis de la respuesta del servidor. Consulta el documento « 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 ». Consulta el documento « 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 que se utiliza para la autenticación.
Véase también « password()» y « QNetworkAccessManager::authenticationRequired()».
void QAuthenticator::setUser(const QString &user)
Establece la clave de autenticación ( user ) utilizada 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.