QHstsPolicy 类

QHstsPolicy 类指定主机支持 HTTP Strict Transport Security 策略 (HSTS)。 更多...

头文件 #include <QHstsPolicy>
CMakefind_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmakeQT += network

公共类型

枚举PolicyFlag { IncludeSubDomains }
flagsPolicyFlags

公共函数

QHstsPolicy()
QHstsPolicy(const QDateTime &expiry, QHstsPolicy::PolicyFlags flags, const QString &host, QUrl::ParsingMode mode = QUrl::DecodedMode)
QHstsPolicy(const QHstsPolicy &other)
~QHstsPolicy()
QDateTimeexpiry() const
QStringhost(QUrl::ComponentFormattingOptions options = QUrl::FullyDecoded) const
boolincludesSubDomains() const
boolisExpired() const
voidsetExpiry(const QDateTime &expiry)
voidsetHost(const QString &host, QUrl::ParsingMode mode = QUrl::DecodedMode)
voidsetIncludesSubDomains(bool include)
voidswap(QHstsPolicy &other)
QHstsPolicy &operator=(const QHstsPolicy &other)
booloperator!=(const QHstsPolicy &lhs, const QHstsPolicy &rhs)
booloperator==(const QHstsPolicy &lhs, const QHstsPolicy &rhs)

详细描述

HSTS 策略定义了 QNetworkAccessManager 应该只以安全方式访问主机的一段时间。HSTS 策略由 RFC6797 定义。

您可以通过构造函数或调用 setExpiry()、setHost() 和 setIncludesSubDomains() 来设置此策略的过期时间和主机名,并控制它是否适用于子域。

另请参阅QNetworkAccessManager::setStrictTransportSecurityEnabled

成员类型文档

enum QHstsPolicy::PolicyFlag
flags QHstsPolicy::PolicyFlags

常量描述
QHstsPolicy::IncludeSubDomains1指示策略是否必须包含子域名

PolicyFlags 类型是 QFlags 的 typedef。它存储了 PolicyFlag 值的 OR 组合。

成员函数文档

QHstsPolicy::QHstsPolicy()

构建一个无效(已过期)的策略,包含空的主机名和未包含的子域名。

QHstsPolicy::QHstsPolicy(const QDateTime &expiry, QHstsPolicy::PolicyFlags flags, const QString &host, QUrl::ParsingMode mode = QUrl::DecodedMode)

使用 expiry(UTC 时间)构建 QHstsPolicy;flags 是一个表示此策略是否必须也包含子域的值的标识符,host 数据根据 mode 进行解释。

另请参阅QUrl::setHostQUrl::ParsingModeQHstsPolicy::PolicyFlag

QHstsPolicy::QHstsPolicy(const QHstsPolicy &other)

创建 other 对象的副本。

[noexcept] QHstsPolicy::~QHstsPolicy()

析构函数。

QDateTime QHstsPolicy::expiry() const

返回策略的过期日期(UTC 时间)。

另请参阅setExpiry

QString QHstsPolicy::host(QUrl::ComponentFormattingOptions options = QUrl::FullyDecoded) const

返回给定策略的域名,根据 options 进行格式化。

另请参阅setHostQUrl::hostQUrl::ComponentFormattingOptions

bool QHstsPolicy::includesSubDomains() const

如果此策略也包含子域名,则返回 true

另请参阅setIncludesSubDomains

bool QHstsPolicy::isExpired() const

如果此策略有一个有效的过期日期,并且这个日期大于 QDateTime::currentGetDateTimeUtc(),则返回 true

另请参阅setExpiryexpiry

void QHstsPolicy::setExpiry(const QDateTime &expiry)

将策略的过期日期(UTC 时间)设置为 expiry

另请参阅expiry

void QHstsPolicy::setHost(const QString &host, QUrl::ParsingMode mode = QUrl::DecodedMode)

设置域名,host 数据根据 mode 参数进行解释。

另请参阅hostQUrl::setHostQUrl::ParsingMode

void QHstsPolicy::setIncludesSubDomains(bool include)

设置此策略是否包含子域名。

另请参阅 includesSubDomains()。

[noexcept] void QHstsPolicy::swap(QHstsPolicy &other)

将此策略与其他策略交换。

QHstsPolicy &QHstsPolicy::operator=(const QHstsPolicy &other)

赋值运算符,复制其他

相关非成员

bool operator!=(const QHstsPolicy &lhs, const QHstsPolicy &rhs)

如果两个策略lhsrhs没有相同的域名或过期日期,或者对是否包含或排除子域的意见不一致,则返回true

bool operator==(const QHstsPolicy &lhs, const QHstsPolicy &rhs)

如果两个策略lhsrhs具有相同的域名和过期日期,并且对是否包含或排除子域的意见一致,则返回true

© 2024 Qt公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3许可的。Qt及其相关标志是芬兰及/或全球其他地区的Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。