Класс QSslPreSharedKeyAuthenticator

Класс QSslPreSharedKeyAuthenticator предоставляет данные аутентификации для шифрования с предварительно общим ключом (PSK). Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются повторно входящими.

Открытые функции

Связанные внешние члены

Подробное описание

Класс QSslPreSharedKeyAuthenticator предоставляет данные аутентификации для шифрования с предварительно общим ключом (PSK).

Класс QSslPreSharedKeyAuthenticator используется сокетом SSL для предоставления необходимых данных аутентификации в шифровании с предварительно общим ключом (PSK).

При установлении связи с предварительно общим ключом клиент должен вывести ключ, который должен соответствовать ключу, установленному на сервере. Точный алгоритм вывода ключа зависит от приложения; однако, для этой цели сервер может отправить подсказку идентификатора клиенту. Эта подсказка в сочетании с другой информацией (например, паролем) используется клиентом для построения общего ключа.

Класс QSslPreSharedKeyAuthenticator предоставляет средства клиентским приложениям для завершения процесса установления связи с предварительно общим ключом. Приложение клиента должно подключить слот к сигналу QSslSocket::preSharedKeyAuthenticationRequired:

connect(socket, &QSslSocket::preSharedKeyAuthenticationRequired,
        this, &AuthManager::handlePreSharedKeyAuthentication);

Сигнал передает объект QSslPreSharedKeyAuthenticator, содержащий подсказку идентификатора, отправленную сервером клиенту, который должен быть заполнен соответствующим клиенту идентификатором и выведенным ключом:

void AuthManager::handlePreSharedKeyAuthentication(QSslPreSharedKeyAuthenticator *authenticator)
{
    authenticator->setIdentity("My Qt App");

    const QByteArray key = deriveKey(authenticator->identityHint(), passphrase);
    authenticator->setPreSharedKey(key);
}

Примечание: Шифрование с предварительно общим ключом поддерживается только при использовании OpenSSL 1.0.1 (или более поздней версии) в качестве бэкенда SSL.

См. также QSslSocket.

Документация функций-членов

QSslPreSharedKeyAuthenticator::QSslPreSharedKeyAuthenticator()

Создаёт объект QSslPreSharedKeyAuthenticator по умолчанию.

Подсказка идентификатора, идентификатор и ключ будут инициализированы пустыми массивами байтов; максимальная длина и для идентификатора, и для ключа будет инициализирована значением 0.

QSslPreSharedKeyAuthenticator::QSslPreSharedKeyAuthenticator(const QSslPreSharedKeyAuthenticator &authenticator)

Создаёт объект QSslPreSharedKeyAuthenticator как копию authenticator.

См. также operator=().

QSslPreSharedKeyAuthenticator::~QSslPreSharedKeyAuthenticator()

Удаляет объект QSslPreSharedKeyAuthenticator.

QByteArray QSslPreSharedKeyAuthenticator::identity() const

Возвращает идентификатор клиента PSK.

См. также setIdentity().

QByteArray QSslPreSharedKeyAuthenticator::identityHint() const

Возвращает подсказку идентификатора PSK, предоставленную сервером. Интерпретация этой подсказки предоставляется приложению.

int QSslPreSharedKeyAuthenticator::maximumIdentityLength() const

Возвращает максимальную длину, в байтах, идентификатора клиента PSK.

Примечание: возможно установить идентификатор, длина которого больше maximumIdentityLength(); в этом случае будут отправлены только первые maximumIdentityLength() байтов на сервер.

См. также setIdentity().

int QSslPreSharedKeyAuthenticator::maximumPreSharedKeyLength() const

Возвращает максимальную длину, в байтах, предварительно общего ключа.

Примечание: возможно установить ключ, длина которого больше maximumPreSharedKeyLength(); в этом случае будут отправлены только первые maximumPreSharedKeyLength() байтов на сервер.

См. также setPreSharedKey().

QByteArray QSslPreSharedKeyAuthenticator::preSharedKey() const

Возвращает предварительно общий ключ.

См. также setPreSharedKey().

void QSslPreSharedKeyAuthenticator::setIdentity(const QByteArray &identity)

Устанавливает идентификатор клиента PSK (для передачи серверу) в identity.

Примечание: возможно установить идентификатор, длина которого больше maximumIdentityLength(); в этом случае будут отправлены только первые maximumIdentityLength() байтов на сервер.

См. также identity() и maximumIdentityLength().

void QSslPreSharedKeyAuthenticator::setPreSharedKey(const QByteArray &preSharedKey)

Устанавливает предварительно общий ключ в preSharedKey.

Примечание: возможно установить ключ, длина которого больше maximumPreSharedKeyLength(); в этом случае будут отправлены только первые maximumPreSharedKeyLength() байтов на сервер.

См. также preSharedKey(), maximumPreSharedKeyLength(), и QByteArray::fromHex().

void QSslPreSharedKeyAuthenticator::swap(QSslPreSharedKeyAuthenticator &authenticator)

Меняет местами объект QSslPreSharedKeyAuthenticator authenticator с текущим объектом. Эта операция очень быстрая и никогда не завершается с ошибкой.

QSslPreSharedKeyAuthenticator &QSslPreSharedKeyAuthenticator::operator=(const QSslPreSharedKeyAuthenticator &authenticator)

Присваивает объект QSslPreSharedKeyAuthenticator authenticator данному объекту и возвращает ссылку на копию.

QSslPreSharedKeyAuthenticator &QSslPreSharedKeyAuthenticator::operator=(QSslPreSharedKeyAuthenticator &&authenticator)

Переносит объект QSslPreSharedKeyAuthenticator authenticator в данный объект и возвращает ссылку на перемещённый экземпляр.