Интерфейс SaslServerFactory
public interface SaslServerFactory
Интерфейс для создания экземпляров
SaslServer. Класс, реализующий этот интерфейс, должен быть потокобезопасным и обрабатывать несколько одновременных запросов. Он также должен иметь открытый конструктор без аргументов. Этот интерфейс обычно не используется сервером напрямую: вместо этого сервер использует статические методы Sasl. Однако конкретная среда может предоставлять и устанавливать новую или другую реализацию SaslServerFactory.
- С версии:
- 1.5
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
SaslServer |
createSaslServer |
Создает SaslServer с использованием переданных параметров. |
String[] |
getMechanismNames |
Возвращает массив имен механизмов, соответствующих указанным политикам выбора механизмов. |
Подробное описание методов
createSaslServer
SaslServer createSaslServer(String mechanism, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh) throws SaslException
Создает
SaslServer с использованием переданных параметров. Возвращает null, если с использованием переданных параметров невозможно создать SaslServer. Выбрасывает SaslException, если не удается создать SaslServer из-за ошибки.- Параметры:
-
mechanism— зарегистрированное в IANA имя механизма SASL, не равное null (например, "GSSAPI", "CRAM-MD5"). -
protocol— строковое имя протокола, для которого выполняется аутентификация (например, "ldap"), не равное null. -
serverName— полное доменное имя сервера, к которому выполняется аутентификация, или null, если сервер не привязан к конкретному имени узла. Если механизм не допускает сервер без привязки, будет выброшеноSaslException. -
props— возможно, равный null набор свойств, используемых для выбора механизма SASL и настройки обмена данными при аутентификации с использованием выбранного механизма. Список стандартных свойств см. в классеSasl. Можно включать и другие свойства, в том числе специфичные для конкретного механизма. Свойства, не относящиеся к выбранному механизму, игнорируются, включая записи карты с ключами, не являющимися строками. -
cbh— возможно, равный null обработчик обратных вызовов, используемый механизмами SASL для получения от приложения или библиотеки дополнительных сведений, необходимых для завершения аутентификации. Например, механизму SASL могут потребоваться от вызывающей стороны идентификатор аутентификации, пароль и область аутентификации. Идентификатор аутентификации запрашивается с помощьюNameCallback. Пароль запрашивается с помощьюPasswordCallback. Область аутентификации запрашивается с помощьюRealmChoiceCallback, если доступен список областей для выбора, и с помощьюRealmCallback, если область необходимо ввести. - Возвращает:
- Возможно, равный null
SaslServer, созданный с использованием переданных параметров. Если возвращено значение null, эта фабрика не может создатьSaslServerс использованием переданных параметров. - Выбрасывает:
-
SaslException— если не удается создатьSaslServerиз-за ошибки.
getMechanismNames
String[] getMechanismNames(Map<String,?> props)
Возвращает массив имен механизмов, соответствующих указанным политикам выбора механизмов.
- Параметры:
-
props— возможно, равный null набор свойств, используемых для задания политики безопасности механизмов SASL. Например, еслиpropsсодержит свойствоSasl.POLICY_NOPLAINTEXTсо значением"true", фабрика не должна возвращать механизмы SASL, уязвимые для простых пассивных атак с передачей открытого текста. Полный список свойств политики см. в классеSasl. Свойства, не относящиеся к политике, если они есть вprops, игнорируются, включая записи карты с ключами, не являющимися строками. - Возвращает:
- Массив имен механизмов SASL, зарегистрированных в IANA; массив не равен null.
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.security.sasl/javax/security/sasl/SaslServerFactory.html