En esta página

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

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ónDirecciónTipoDescripción
realmEntranteQStringContiene 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ónDirecciónTipoDescripción
realmEntranteQStringContiene el dominio de la autenticación, igual que realm()

El mecanismo de autenticación Digest-MD5 no admite opciones de salida.

SPNEGO/Negotiate

OpciónDirecciónTipoDescripción
spnSalienteQStringProporciona 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.