QDtls Class

멤버 기능 문서

[explicit] QDtls::QDtls(QSslSocket::SslMode mode, QObject *parent = nullptr)

QDtls 객체를 생성하며, parent 은 QObject 생성자에게 전달됩니다. mode 은 서버 측 DTLS 연결의 경우 QSslSocket::SslServerMode 또는 클라이언트의 경우 QSslSocket::SslClientMode 입니다.

sslMode() 및 QSslSocket::SslMode도 참조하세요 .

[virtual noexcept] QDtls::~QDtls()

QDtls 객체를 삭제합니다.

bool QDtls::abortHandshake(QUdpSocket *socket)

진행 중인 핸드셰이크를 중단합니다. socket 에서 진행 중이면 참을 반환하고, 그렇지 않으면 적절한 오류를 설정하고 거짓을 반환합니다.

doHandshake() 및 resumeHandshake()도 참조하세요 .

QDtls::GeneratorParameters QDtls::cookieGeneratorParameters() const

기본 해시 알고리즘 또는 setCookieGeneratorParameters() 호출로 이전에 설정한 현재 해시 알고리즘과 비밀을 반환합니다.

기본 해시 알고리즘은 Qt XML이 이를 지원하도록 구성된 경우 QCryptographicHash::Sha256, 그렇지 않은 경우 QCryptographicHash::Sha1 입니다. 기본 비밀은 백엔드 전용 암호학적으로 강력한 의사 난수 생성기에서 얻습니다.

setCookieGeneratorParameters(), QDtlsClientVerifier, 쿠키제너레이터 파라미터()도 참조하세요 .

QByteArray QDtls::decryptDatagram(QUdpSocket *socket, const QByteArray &dgram)

dgram 을 해독하고 그 내용을 일반 텍스트로 반환합니다. 핸드셰이크가 완료되어야 데이터그램을 해독할 수 있습니다. TLS 메시지 유형에 따라 연결은 socket 에 쓸 수 있으며, 이 포인터는 유효한 포인터여야 합니다.

bool QDtls::doHandshake(QUdpSocket *socket, const QByteArray &dgram = {})

DTLS 핸드셰이크를 시작하거나 계속합니다. socket 은 유효한 포인터여야 합니다. 서버 측 DTLS 핸드셰이크를 시작할 때 dgram 에는 QUdpSocket 에서 읽은 초기 ClientHello 메시지가 포함되어야 합니다. 이 함수는 오류가 발견되지 않으면 true 을 반환합니다. handshakeState ()를 사용하여 핸드셰이크 상태를 테스트할 수 있습니다. false 반환은 오류가 발생했음을 의미하며, 자세한 내용은 dtlsError()를 참조하세요.

if (!dtls.doHandshake(&socket, dgram)) {
    if (dtls.dtlsError() == QDtlsError::PeerVerificationError)
        dtls.abortAfterError(&socket);
}

handshakeState(), dtlsError(), ignoreVerificationErrors(), resumeHandshake() 및 abortHandshake()도 참조하세요 .

QSslConfiguration QDtls::dtlsConfiguration() const

기본 DTLS 구성 또는 이전에 setDtlsConfiguration()를 호출하여 설정한 구성을 반환합니다.

setDtlsConfiguration() 및 QSslConfiguration::defaultDtlsConfiguration()도 참조하세요 .

QDtlsError QDtls::dtlsError() const

연결에서 발생한 마지막 오류를 반환하거나 QDtlsError::NoError.

dtlsErrorString() 및 QDtlsError도 참조하세요 .

QString QDtls::dtlsErrorString() const

연결 또는 빈 문자열에서 발생한 마지막 오류에 대한 텍스트 설명을 반환합니다.

dtlsError()도 참조하세요 .

bool QDtls::handleTimeout(QUdpSocket *socket)

핸드셰이크 도중 시간 초과가 발생하면 handshakeTimeout() 신호가 전송됩니다. 애플리케이션은 핸들타임아웃()을 호출하여 핸드셰이크 메시지를 재전송해야 합니다. 핸들타임아웃()은 시간 초과가 발생하면 true, 그렇지 않으면 false를 반환합니다. socket 은 유효한 포인터여야 합니다.

handshakeTimeout()도 참조하세요 .

QDtls::HandshakeState QDtls::handshakeState() const

이 QDtls 에 대한 현재 핸드셰이크 상태를 반환합니다.

doHandshake() 및 QDtls::HandshakeState도 참조하세요 .

[signal] void QDtls::handshakeTimeout()

패킷 손실로 인해 핸드셰이크 단계에서 시간 초과가 발생할 수 있습니다. 이 경우 QDtls 은 handshakeTimeout() 신호를 보냅니다. handleTimeout ()를 호출하여 핸드셰이크 메시지를 재전송합니다:

DtlsClient::DtlsClient()
{
    // Some initialization code here ...
    connect(&clientDtls, &QDtls::handshakeTimeout, this, &DtlsClient::handleTimeout);
}

void DtlsClient::handleTimeout()
{
    clientDtls.handleTimeout(&clientSocket);
}

handleTimeout()도 참조하세요 .

void QDtls::ignoreVerificationErrors(const QList<QSslError> &errorsToIgnore)

이 방법은 QDtls 에 errorsToIgnore 에 주어진 오류만 무시하도록 지시합니다.

예를 들어 자체 서명 인증서를 사용하는 서버에 연결하려는 경우 다음 스니펫을 고려하세요:

QList<QSslCertificate> cert = QSslCertificate::fromPath("server-certificate.pem"_L1);
QSslError error(QSslError::SelfSignedCertificate, cert.at(0));
QList<QSslError> expectedSslErrors;
expectedSslErrors.append(error);

QDtls dtls;
dtls.ignoreVerificationErrors(expectedSslErrors);
dtls.doHandshake(udpSocket);

doHandshake()에서 QDtlsError::PeerVerificationError 오류가 발생한 후 이 함수를 호출한 다음 resumeHandshake()를 호출하여 핸드셰이크를 다시 시작할 수도 있습니다.

나중에 이 함수를 호출하면 이전 호출에서 전달된 오류 목록이 대체됩니다. 이 함수를 빈 목록으로 호출하여 무시하려는 오류 목록을 지울 수 있습니다.

doHandshake(), resumeHandshake() 및 QSslError 를참조하세요 .

bool QDtls::isConnectionEncrypted() const

DTLS 핸드셰이크가 성공적으로 완료되면 true 을 반환합니다.

doHandshake() 및 handshakeState()도 참조하세요 .

quint16 QDtls::mtuHint() const

setMtuHint()에서 이전에 설정한 값을 반환합니다. 기본값은 0입니다.

setMtuHint()도 참조하세요 .

QHostAddress QDtls::peerAddress() const

setPeer() 또는 QHostAddress::Null 으로 설정한 피어 주소를 반환합니다.

setPeer()도 참조하세요 .

quint16 QDtls::peerPort() const

setPeer() 또는 0으로 설정된 피어 포트 번호를 반환합니다.

setPeer()도 참조하세요 .

QList<QSslError> QDtls::peerVerificationErrors() const

상대방의 신원을 확인하는 동안 발견된 오류를 반환합니다.

오류가 발생했음에도 불구하고 연결을 계속하려면 ignoreVerificationErrors()를 호출해야 합니다.

QString QDtls::peerVerificationName() const

setPeer() 또는 setPeerVerificationName()에 설정된 호스트 이름을 반환합니다. 기본값은 빈 문자열입니다.

setPeerVerificationName() 및 setPeer()도 참조하세요 .

[signal] void QDtls::pskRequired(QSslPreSharedKeyAuthenticator *authenticator)

QDtls 는 PSK 암호 스위트를 협상할 때 이 신호를 보내므로 PSK 인증이 필요합니다.

PSK를 사용할 때 클라이언트는 유효한 ID와 유효한 사전 공유 키를 서버에 보내야 TLS 핸드셰이크를 계속할 수 있습니다. 애플리케이션은 필요에 따라 전달된 authenticator 객체를 채워 이 신호에 연결된 슬롯에 이 정보를 제공할 수 있습니다.

QSslPreSharedKeyAuthenticator도 참조하세요 .

bool QDtls::resumeHandshake(QUdpSocket *socket)

핸드셰이크 도중 피어 확인 오류가 무시된 경우 resumeHandshake()는 핸드셰이크를 재개하고 완료한 후 true 을 반환합니다. socket 은 유효한 포인터여야 합니다. 핸드셰이크를 재개할 수 없는 경우 false 을 반환합니다.

doHandshake(), abortHandshake(), peerVerificationErrors() 및 ignoreVerificationErrors()도 참조하세요 .

QSslCipher QDtls::sessionCipher() const

이 연결에 사용된 cipher 암호를 반환하거나 연결이 암호화되지 않은 경우 null 암호를 반환합니다. 세션의 암호는 핸드셰이크 단계에서 선택됩니다. 이 암호는 데이터를 암호화하고 해독하는 데 사용됩니다.

QSslConfiguration 는 핸드셰이크 단계에서 최종적으로 세션 암호를 선택할 암호의 순서 목록을 설정하는 기능을 제공합니다. 핸드셰이크 단계가 시작되기 전에 이 정렬된 목록이 준비되어 있어야 합니다.

QSslConfiguration, setDtlsConfiguration() 및 dtlsConfiguration()도 참조하세요 .

QSsl::SslProtocol QDtls::sessionProtocol() const

이 연결에 사용된 DTLS 프로토콜 버전을 반환하거나 연결이 아직 암호화되지 않은 경우 UnknownProtocol을 반환합니다. 연결의 프로토콜은 핸드셰이크 단계에서 선택됩니다.

setDtlsConfiguration()는 핸드셰이크가 시작되기 전에 선호하는 버전을 설정할 수 있습니다.

setDtlsConfiguration(), QSslConfiguration, QSslConfiguration::defaultDtlsConfiguration() 및 QSslConfiguration::setProtocol()도 참조하세요 .

bool QDtls::setCookieGeneratorParameters(const QDtls::GeneratorParameters &params)

params 에서 암호화 해시 알고리즘과 비밀을 설정합니다. 이 함수는 서버 측 QDtls 연결에만 필요합니다. 성공하면 true 을 반환합니다.

cookieGeneratorParameters(), doHandshake(), QDtlsClientVerifier, 및 QDtlsClientVerifier::cookieGeneratorParameters()도 참조하세요 .

bool QDtls::setDtlsConfiguration(const QSslConfiguration &configuration)

configuration 에서 연결의 TLS 구성을 설정하고 성공하면 true 을 반환합니다.

dtlsConfiguration() 및 doHandshake()도 참조하세요 .

void QDtls::setMtuHint(quint16 mtuHint)

mtuHint 는 애플리케이션에서 검색하거나 추측한 최대 전송 단위(MTU)입니다. 애플리케이션이 이 값을 설정할 필요는 없습니다.

mtuHint() 및 QAbstractSocket::PathMtuSocketOption 을참조하세요 .

bool QDtls::setPeer(const QHostAddress &address, quint16 port, const QString &verificationName = {})

피어의 주소, port, 호스트 이름을 설정하고 성공하면 true 을 반환합니다. address 은 null, 멀티캐스트 또는 브로드캐스트가 아니어야 합니다. verificationName 은 인증서 유효성 검사에 사용되는 호스트 이름입니다.

peerAddress(), peerPort() 및 peerVerificationName()도 참조하세요 .

bool QDtls::setPeerVerificationName(const QString &name)

인증서 유효성 검사에 사용할 호스트 name 를 설정하고 성공하면 true 을 반환합니다.

peerVerificationName() 및 setPeer()도 참조하세요 .

bool QDtls::shutdown(QUdpSocket *socket)

암호화된 종료 알림 메시지를 전송하고 DTLS 연결을 닫습니다. 핸드셰이크 상태가 QDtls::HandshakeNotStarted 로 변경됩니다. socket 은 유효한 포인터여야 합니다. 이 함수는 성공 시 true 을 반환합니다.

doHandshake()도 참조하세요 .

QSslSocket::SslMode QDtls::sslMode() const

서버 측 연결의 경우 QSslSocket::SslServerMode, 클라이언트의 경우 QSslSocket::SslClientMode 을 반환합니다.

QDtls() 및 QSslSocket::SslMode도 참조하세요 .

qint64 QDtls::writeDatagramEncrypted(QUdpSocket *socket, const QByteArray &dgram)

dgram 을 암호화하고 암호화된 데이터를 socket 에 씁니다. 쓰여진 바이트 수를 반환하거나 오류가 있는 경우 -1을 반환합니다. 암호화된 데이터를 쓰기 전에 핸드셰이크가 완료되어야 합니다. socket 은 유효한 포인터여야 합니다.

doHandshake(), handshakeState(), isConnectionEncrypted() 및 dtlsError()도 참조하세요 .