Класс QSslPreSharedKeyAuthenticator

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

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

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

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

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

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

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

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

QSslPreSharedKeyAuthenticator предоставляет клиентам приложения средства для завершения процесса установления соединения по PSK. Приложению клиента необходимо подключить слот к сигналу 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);
    }

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

Примечание: PSK в настоящее время поддерживается только в OpenSSL.

См. также QSslSocket.

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

QSslPreSharedKeyAuthenticator::QSslPreSharedKeyAuthenticator(const QSslPreSharedKeyAuthenticator &authenticator)

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

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

QSslPreSharedKeyAuthenticator::QSslPreSharedKeyAuthenticator()

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

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

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

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

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

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

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.

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

См. также предопределенный ключ, максимальная длина предварительно согласованного ключа() и QByteArray::fromHex().

void QSslPreSharedKeyAuthenticator::swap(QSslPreSharedKeyAuthenticator &authenticator)

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