PySide6.QtNetwork.QAuthenticator

class QAuthenticator

QAuthenticator 类提供了一个认证对象。更多

概要

方法

注意

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

详细描述

QAuthenticator 类通常用于 QNetworkAccessManagerQAbstractSocketauthenticationRequired()proxyAuthenticationRequired() 信号中。该类提供了一种方式,用于在访问需要身份验证的服务时,将所需的身份验证信息传递回套接字。

QAuthenticator 支持以下认证方法:

  • 基础

  • NTLM 版本 2

  • 摘要-MD5

  • SPNEGO/协商

选项

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

以下表格列出了已知的传入选项以及接受的传出选项。传入选项的列表并不详尽,因为服务器可能随时包含额外的信息。然而,传出选项的列表是详尽的,不会处理或发送回任何未知选项。

基础

选项

方向

类型

描述

realm

传入

QString

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

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

NTLM 版本 2

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

摘要-MD5

选项

方向

类型

描述

realm

传入

QString

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

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

SPNEGO/协商

选项

方向

类型

描述

spn

出站

QString

提供自定义的SPN。

此认证机制目前不支持任何传入选项。

spn 属性在 Windows 客户端上使用 SSPI 库时使用。如果未设置该属性,将使用默认的 SPN。Windows 上的默认 SPN 是 HTTP/

其他操作系统使用GSSAPI库。为此,预计KDC已设置,并且可以从其中获取凭据。后端始终使用HTTPS@作为SPN。

另请参阅

QSslSocket

__init__()

构造一个空的认证对象。

__init__(other)
Parameters:

其他QAuthenticator

构造other的副本。

isNull()
Return type:

布尔

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

__ne__(other)
Parameters:

其他QAuthenticator

Return type:

布尔

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

__eq__(other)
Parameters:

其他QAuthenticator

Return type:

布尔

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

option(opt)
Parameters:

opt – 字符串

Return type:

对象

如果服务器设置了选项opt,则返回与该选项相关的值。有关传入选项的更多信息,请参见Options section。如果未找到选项opt,将返回无效的QVariant。

另请参阅

setOption() options() QAuthenticator options

options()
Return type:

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

通过解析服务器回复,返回在此QAuthenticator对象中设置的所有传入选项。有关传入选项的更多信息,请参见Options section

另请参阅

option() QAuthenticator 选项

password()
Return type:

字符串

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

另请参阅

setPassword()

realm()
Return type:

字符串

返回需要认证的领域。

setOption(opt, value)
Parameters:
  • opt – str

  • value – 对象

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

另请参阅

options() option() QAuthenticator 选项

setPassword(password)
Parameters:

password – str

设置用于身份验证的password

setRealm(realm)
Parameters:

realm – str

setUser(user)
Parameters:

用户 – str

设置用于身份验证的user

user()
Return type:

字符串

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

另请参阅

setUser()