Интерфейс SaslClientFactory

public interface SaslClientFactory

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

К этому интерфейсу обычно не обращается напрямую клиент, который будет использовать статические методы Sasl вместо этого. Однако определенная среда может предоставить и установить новый или другой SaslClientFactory.

Методы

createSaslClient

SaslClient createSaslClient(String[] mechanisms,
                            String authorizationId,
                            String protocol,
                            String serverName,
                            Map<String,?> props,
                            CallbackHandler cbh)
                     throws SaslException

Создает SaslClient с использованием предоставленных параметров.

Параметры:

mechanisms - Непустой список имён механизмов для попыток. Каждый из них — зарегистрированное IANA имя SASL механизма. (например, "GSSAPI", "CRAM-MD5").

authorizationId - Возможно нулевое идентификатор, зависящее от протокола, используемое для авторизации. Если null или пустое, сервер вычисляет идентификатор авторизации из учетных данных аутентификации клиента. После успешного завершения SASL аутентификации указанному субъекту предоставляется доступ.

protocol - Непустая строка имени протокола, для которого выполняется аутентификация (например, "ldap").

serverName - Непустое полное имя хоста сервера, с которым выполняется аутентификация.

props - Возможно нулевой набор свойств, используемых для выбора SASL механизма и для настройки обмена данными аутентификации выбранного механизма. См. класс Sasl для списка стандартных свойств. Можно включить и другие, возможно, специфичные для механизма, свойства. Свойства, не относящиеся к выбранному механизму, игнорируются, включая любые элементы карты с ключами, отличными от String.

cbh - Возможно нулевой обработчик обратных вызовов, используемый SASL механизмами для получения дополнительной информации от приложения/библиотеки для завершения аутентификации. Например, SASL механизм может потребовать от вызывающего объекта идентификатор аутентификации, пароль и область. Идентификатор аутентификации запрашивается с помощью NameCallback. Пароль запрашивается с помощью PasswordCallback. Область запрашивается с помощью RealmChoiceCallback, если есть список областей для выбора, и с помощью RealmCallback, если область должна быть введена.

Возвращает:

Возможно нулевой SaslClient созданный с использованием предоставленных параметров. Если null, этот фабрика не может произвести SaslClient с использованием предоставленных параметров.

Инициализация:

SaslException - Если не удаётся создать SaslClient из-за ошибки.

getMechanismNames

String[] getMechanismNames(Map<String,?> props)

Возвращает массив имён механизмов, соответствующих заданным политикам выбора механизма.

Параметры:

props - Возможно нулевой набор свойств, используемых для указания политики безопасности SASL механизмов. Например, если props содержит свойство Sasl.POLICY_NOPLAINTEXT со значением "true", то фабрика не должна возвращать какие-либо SASL механизмы, уязвимые для простых пассивных атак. См. класс Sasl для полного списка свойств политики. Свойства, не относящиеся к политике, если присутствуют в props, игнорируются, включая любые элементы карты с ключами, отличными от String.

Возвращает:

Непустой массив, содержащий имена зарегистрированных IANA SASL механизмов.