Интерфейс SaslServerFactory

public interface SaslServerFactory

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

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

Методы

createSaslServer

SaslServer createSaslServer(String mechanism,
                            String protocol,
                            String serverName,
                            Map<String,?> props,
                            CallbackHandler cbh)
                     throws SaslException

Создаёт SaslServer с использованием предоставленных параметров. Возвращает null, если SaslServer не может быть создан с использованием предоставленных параметров. Бросает SaslException, если не может создать SaslServer из-за ошибки.

Параметры:

mechanism - Непустое зарегистрированное IANA имя SASL механизма. (например, "GSSAPI", "CRAM-MD5").

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

serverName - Полное имя хоста сервера, к которому производится аутентификация, или null, если сервер не привязан к какому-либо имени хоста. Если механизм не допускает непривязанного сервера, будет брошено исключение SaslException.

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

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

Возвращает:

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

Бросает:

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

getMechanismNames

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

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

Параметры:

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

Возвращает:

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