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()도 참조하십시오 .

지정된 익스포터(exporter) label, 출력(output) size 및 선택 사항인 키링( context)을 사용하여 ` QSslKeyingMaterial ` 객체를 생성합니다.

label 는 내보낸 키 생성 자료의 용도를 식별하며, 비어 있어서는 안 됩니다. size 는 TLS 익스포터에서 파생될 바이트 수를 지정합니다.

선택 사항인 context 는 도메인 분리를 제공하기 위해 키 도출 과정에 혼합되는 애플리케이션 정의 데이터입니다.

키 생성 자료 자체는 TLS 핸드셰이크가 성공적으로 완료될 때까지 생성되지 않습니다.

isValid(), label(), context(), value()도 참조하십시오 .

QSslKeyingMaterial QSslKeyingMaterial::clone() const

value()를 제외한 이 키 생성 자료 요청의 복사본을 반환합니다.

반환된 객체에는 exporter 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()도 참조하십시오 .