class QAuthenticator#

QAuthenticator 类提供了一个身份验证对象。更多信息

摘要#

方法#

注释

本文档可能包含从 C++ 自动翻译到 Python 的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有任何问题,您也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 创建工单的方式告知我们

详细描述#

通常,QAuthenticator 类用于 authenticationRequired()proxyAuthenticationRequired() 的信号中,以及 QNetworkAccessManagerQAbstractSocket。该类提供了在访问需要认证的服务时,将所需的认证信息传递回套接字的方式。

QAuthenticator支持以下认证方法

  • 基本认证

  • NTLM版本2

  • Digest-MD5

  • SPNEGO/Negotiate

选项#

除了认证所需的用户名和密码之外,QAuthenticator对象还可以包含其他选项。可以使用options()函数查询服务器发送的传入选项;可以使用setOption()函数设置要由认证器处理发送的选项。接受的选项和提供的选项取决于认证类型(参见方法())。

以下表格列出了已知的传入选项以及接受的传出选项。传入选项的列表不是详尽的,因为服务器可以在任何时候包含其他信息。传出选项的列表是详尽的,不会处理或返回给服务器的未知选项。

基本认证#

选项

方向

类型

描述

realm

传入

QString

包含认证的领域,与realm()相同

基本认证机制不支持传出选项。

NTLM版本2#

当前NTLM认证机制不支持传入或传出选项。在Windows上,如果未设置任何用户,将在本地系统上搜索域\用户凭据以启用单点登录功能。

Digest-MD5#

选项

方向

类型

描述

realm

传入

QString

包含认证的领域,与realm()相同

Digest-MD5认证机制不支持传出选项。

SPNEGO/Negotiate#

选项

方向

类型

描述

spn

传出

QString

提供自定义SPN。

该认证机制当前不支持传入选项。

在Windows客户端上使用SSPI库时使用spn属性。如果没有设置属性,将使用默认SPN。Windows上的默认SPN为HTTP/<hostname>

其他操作系统使用GSSAPI库。对于它,期望设置KDC,并且可以从它那里检索凭据。后端始终使用HTTPS@<hostname>作为SPN。

另请参阅

QSslSocket

__init__()#

构建一个空的认证对象。

__init__(other)
参数:

otherQAuthenticator

构建other的副本。

isNull()#
返回类型:

bool

如果对象未初始化,则返回 true。如果已调用非const成员函数,或者内容是从另一个初始化的 QAuthenticator 对象构造或复制的,则返回 false

__ne__(other)#
参数:

otherQAuthenticator

返回类型:

bool

如果此认证器不同于 other,则返回 true;否则返回 false

__eq__(other)#
参数:

otherQAuthenticator

返回类型:

bool

如果此认证器与 other 完全相同,则返回 true;否则返回 false

option(opt)#
参数:

opt - 字符串

返回类型:

对象

如果已由服务器设置,则返回与选项 opt 相关的值。有关更多信息,请参阅 Options section。如果未找到选项 opt,则返回无效的 QVariant。

另请参阅

setOption() options() QAuthenticator options

options()#
返回类型:

字典,键为 QString 类型,值为 QVariant 类型。

返回由服务器响应解析在此 QAuthenticator 对象中设置的接收到的所有选项。有关更多信息,请参阅 Options section

另请参阅

option() QAuthenticator options

password()#
返回类型:

字符串

返回用于身份验证的密码。

另请参阅

setPassword()

realm()#
返回类型:

字符串

返回需要身份验证的域。

setOption(opt, value)#
参数:
  • opt - 字符串

  • value - 对象

将发出选项 opt 设置为值 value。有关发出选项的更多信息,请参阅 Options section

另请参阅

options() option() QAuthenticator options

setPassword(password)#
参数:

password – 字符串

设置用于身份验证的 password

setRealm(realm)#
参数:

realm – 字符串

setUser(user)#
参数:

user – 字符串

设置用于身份验证的 user

user()#
返回类型:

字符串

返回用于身份验证的用户。

另请参阅

setUser()