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() を除いて返します。

返されるオブジェクトには、エクスポーター `label()`、`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().