Интерфейс SaslClientFactory

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

Параметры:

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

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

protocol — Имя протокола, для которого выполняется аутентификация; не может быть null (например, "ldap").

serverName — Полное доменное имя сервера, на котором выполняется аутентификация; не может быть null.

props — Набор свойств, используемых для выбора механизма SASL и настройки обмена данными для аутентификации выбранного механизма; может быть null. Список стандартных свойств приведён в классе Sasl. Также могут быть указаны другие свойства, возможно специфичные для механизма. Свойства, не относящиеся к выбранному механизму, игнорируются, включая записи карты с ключами, не являющимися строками.

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

Возвращает:

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

Выбрасывает:

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

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

Параметры:

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

Возвращает:

Не равный null массив имён механизмов SASL, зарегистрированных в IANA.