Интерфейс SaslServerFactory
public interface SaslServerFactory
Интерфейс для создания экземпляров
SaslServer. Класс, реализующий этот интерфейс, должен быть потокобезопасным и обрабатывать несколько одновременных запросов. Он также должен иметь публичный конструктор без аргументов. К этому интерфейсу сервер обычно не обращается напрямую, вместо этого он использует статические методы Sasl. Однако определенная среда может предоставить и установить новый или другой SaslServerFactory.
- Since:
- 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 механизма (например, "GSSAPI", "CRAM-MD5"). -
protocol- Непустое имя протокола, для которого выполняется аутентификация (например, "ldap"). -
serverName- Полное доменное имя сервера, с которым требуется аутентификация, или null, если сервер не связан с каким-либо конкретным именем хоста. Если механизм не допускает несвязанного сервера, будет брошено исключениеSaslException. -
props- Возможно нулевой набор свойств, используемых для выбора SASL механизма и настройки обмена аутентификацией выбранного механизма. См. классSaslдля списка стандартных свойств. Можно включить и другие, возможно, зависящие от механизма, свойства. Свойства, не относящиеся к выбранному механизму, игнорируются, включая любые записи карты с ключами, отличными от String. -
cbh- Возможно нулевой обработчик обратного вызова, используемый SASL механизмами для получения дополнительной информации от приложения/библиотеки для завершения аутентификации. Например, SASL механизм может потребовать идентификатор аутентификации, пароль и область от вызывающей стороны. Идентификатор аутентификации запрашивается с помощьюNameCallback. Пароль запрашивается с помощьюPasswordCallback. Область запрашивается с помощьюRealmChoiceCallback, если есть список областей для выбора, и с помощьюRealmCallback, если область необходимо ввести. - Возвращает:
- Возможно нулевой
SaslServer, созданный с использованием предоставленных параметров. Если null, этот фабричный метод не может создатьSaslServerс использованием предоставленных параметров. - Бросает:
-
SaslException- Если не удаётся создатьSaslServerиз-за ошибки.
getMechanismNames
String[] getMechanismNames(Map<String,?> props)
Возвращает массив имён механизмов, соответствующих указанным политикам выбора механизма.
- Параметры:
-
props- Возможно нулевой набор свойств, используемых для указания политики безопасности SASL механизмов. Например, еслиpropsсодержит свойствоSasl.POLICY_NOPLAINTEXTсо значением"true", то фабрика не должна возвращать какие-либо SASL механизмы, уязвимые к простым пассивным атакам. См. классSaslдля полного списка свойств политики. Свойства, не относящиеся к политике, если они присутствуют вprops, игнорируются, включая любые записи карты с ключами, отличными от String. - Возвращает:
- Непустой массив, содержащий имена SASL механизмов, зарегистрированных в IANA.
© 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://download.java.net/java/early_access/jdk24/docs/api/java.security.sasl/javax/security/sasl/SaslServerFactory.html