Класс QAuthenticator

Класс QAuthenticator предоставляет объект для аутентификации. Подробнее...

Этот класс был представлен в Qt 4.3.

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

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

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

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

Класс QAuthenticator обычно используется в сигналах authenticationRequired() и proxyAuthenticationRequired() QNetworkAccessManager и QAbstractSocket. Класс предоставляет способ передачи необходимой информации об аутентификации в сокет при доступе к службам, требующим аутентификации.

QAuthenticator поддерживает следующие методы аутентификации:

• Basic
• NTLM версии 2
• Digest-MD5
• SPNEGO/Negotiate

Параметры

Помимо имени пользователя и пароля, необходимых для аутентификации, объект QAuthenticator также может содержать дополнительные параметры. Функция options() может использоваться для запроса входных параметров, отправленных сервером; функция setOption() может быть использована для установки исходящих параметров, которые будут обработаны вычислением аутентификатора. Принимаемые и предоставляемые параметры зависят от типа аутентификации (см. метод()).

Следующие таблицы перечисляют известные входные параметры, а также допустимые исходящие параметры. Список входных параметров не является исчерпывающим, так как серверы могут включать дополнительную информацию в любое время. Однако список исходящих параметров является исчерпывающим, и никакие неизвестные параметры не будут обрабатываться или возвращаться серверу.

Basic

Механизм аутентификации Basic не поддерживает исходящие параметры.

NTLM версии 2

Механизм аутентификации NTLM в настоящее время не поддерживает входные или исходящие параметры. В Windows, если user не задан, будут искаться учетные данные домена\пользователя в локальной системе для обеспечения работы Single-Sign-On.

Digest-MD5

Механизм аутентификации Digest-MD5 не поддерживает исходящие параметры.

SPNEGO/Negotiate

Этот механизм аутентификации в настоящее время не поддерживает входные или исходящие параметры.

См. также QSslSocket.

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

QAuthenticator::QAuthenticator(const QAuthenticator &other)

Создает копию other.

QAuthenticator::QAuthenticator()

Создает пустой объект аутентификации.

QAuthenticator &QAuthenticator::operator=(const QAuthenticator &other)

Присваивает содержимое other данному аутентификатору.

QAuthenticator::~QAuthenticator()

Уничтожает объект.

bool QAuthenticator::isNull() const

Возвращает true, если объект не был инициализирован. Возвращает false, если были вызваны не-const методы-члены, или содержимое было создано или скопировано из другого инициализированного объекта QAuthenticator.

QVariant QAuthenticator::option(const QString &opt) const

Возвращает значение, связанное с параметром opt, если оно было установлено сервером. См. раздел Параметры для получения дополнительной информации о входных параметрах. Если параметр opt не найден, будет возвращен невалидный QVariant.

Эта функция была представлена в Qt 4.7.

См. также setOption(), options() и Параметры QAuthenticator.

QVariantHash QAuthenticator::options() const

Возвращает все входные параметры, установленные в этом объекте QAuthenticator путем анализа ответа сервера. См. раздел Параметры для получения дополнительной информации о входных параметрах.

Эта функция была представлена в Qt 4.7.

См. также option() и Параметры QAuthenticator.

QString QAuthenticator::password() const

Возвращает пароль, используемый для аутентификации.

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

QString QAuthenticator::realm() const

Возвращает область, требующую аутентификации.

void QAuthenticator::setOption(const QString &opt, const QVariant &value)

Устанавливает исходящий параметр opt со значением value. См. раздел Параметры для получения дополнительной информации об исходящих параметрах.

Эта функция была представлена в Qt 4.7.

См. также options(), option() и Параметры QAuthenticator.

void QAuthenticator::setPassword(const QString &password)

Устанавливает password, используемый для аутентификации.

См. также password() и QNetworkAccessManager::authenticationRequired().

void QAuthenticator::setUser(const QString &user)

Устанавливает user, используемый для аутентификации.

См. также user() и QNetworkAccessManager::authenticationRequired().

QString QAuthenticator::user() const

Возвращает пользователя, используемого для аутентификации.

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

bool QAuthenticator::operator!=(const QAuthenticator &other) const

Возвращает true если данный аутентификатор отличается от other; в противном случае возвращает false.

bool QAuthenticator::operator==(const QAuthenticator &other) const

Возвращает true если данный аутентификатор идентичен other; в противном случае возвращает false.