QSslKeyingMaterial Class

// Both client and server configure the same label and optional context
QSslKeyingMaterial keying("session-label", 32, "app-specific-context");

// After the TLS handshake completes get data from QSslConfiguration.
QByteArray derived = sslConfiguration().takeKeyingMaterial(keying)->value();

// Both client and server will obtain the same 'derived' bytes
// even though they each performed the derivation independently.
use(derived);

QSslConfiguration config = socket->sslConfiguration();

// Copy the value out of the temporary that owns it, and let it die:
QByteArray secret = config.takeKeyingMaterial(request)->value();

// Overwrite the socket's copy with the entry left behind, which has no value:
socket->setSslConfiguration(config);

成员函数文档

QSslKeyingMaterial::QSslKeyingMaterial()

默认构造一个 QSslKeyingMaterial 实例。

默认实例永远无效。

另请参阅 isValid()。

使用给定的导出器label 、输出size 以及可选的context ，构建一个QSslKeyingMaterial 对象。

label 用于标识所导出密钥材料的用途，且必须为非空。size 指定要从 TLS 导出器中派生的字节数。

可选的context 是应用程序定义的数据，将其混入密钥派生过程中以实现域分离。

在 TLS 握手成功完成之前，密钥材料本身不会被生成。

另请参见 isValid()、label()、context() 和value()。

QSslKeyingMaterial QSslKeyingMaterial::clone() const

返回此密钥材料请求的副本，但不包含其value()。

返回的对象包含 exporterlabel()、context() 和requestedSize()，因此可用于再次请求相同的密钥材料，但其value() 为空。使用它来初始化一个副本，或重置一个条目，而不会携带该值。

另请参阅 value()。

QByteArray QSslKeyingMaterial::context() const

返回用于推导密钥材料的可选上下文值。

上下文值将导出的密钥生成材料与应用程序特定数据绑定，并有助于防止在不同用途中意外重复使用相同的密钥。

如果未指定上下文，则返回一个 null/空的QByteArray （参见QSslKeyingMaterial::QSslKeyingMaterial()）。

另请参阅 label() 和value()。

[noexcept] bool QSslKeyingMaterial::isValid() const

如果该QSslKeyingMaterial 对象描述了一个有效的导出请求，则返回true。

如果QSslKeyingMaterial 对象具有非空的导出器标签和正的输出大小，则被视为有效。

另请参阅 label() 和value()。

QByteArray QSslKeyingMaterial::label() const

返回用于推导密钥材料的导出器标签。

该标签用于标识导出密钥材料的用途，并将原样包含在 TLS 导出器推导过程中。

另请参阅 context() 和value()。

[noexcept] qsizetype QSslKeyingMaterial::requestedSize() const

密钥材料的期望大小。

所需大小是指握手协议被要求生成的字节数，该字节数用于实现所请求密钥素材的label()和context()所描述的目的。

另请参阅 value()。

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

将此密钥材料与other 进行交换。此操作速度极快，且从未失败。

QByteArray QSslKeyingMaterial::value() const

返回导出的密钥材料。

返回的QByteArray 包含使用配置的导出器标签和上下文从TLS会话中派生的密钥材料。

如果 TLS 握手未成功完成，或者 TLS 后端不支持密钥导出器，则该函数返回空值。

另请参阅 label()、context() 和requestedSize()。