Интерфейс SaslClientFactory
public interface SaslClientFactory
Интерфейс для создания экземпляров
SaslClient. Класс, реализующий этот интерфейс, должен быть потокобезопасным и обрабатывать несколько одновременных запросов. Он также должен иметь публичный конструктор без аргументов. К этому интерфейсу обычно не обращается непосредственно клиент, который будет использовать статические методы Sasl. Однако конкретная среда может предоставить и установить новый или другой SaslClientFactory.
- С момента:
- 1.5
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
SaslClient |
createSaslClient |
Создает SaslClient с использованием предоставленных параметров. |
String[] |
getMechanismNames |
Возвращает массив имён механизмов, соответствующих указанным политикам выбора механизма. |
Подробное описание методов
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, если область должна быть введена. - Возвращает:
- Возможный null
SaslClient, созданный с использованием предоставленных параметров. Если null, этот фабричный метод не может создатьSaslClientс использованием указанных параметров. - Бросает:
-
SaslException- Если не удаётся создатьSaslClientиз-за ошибки.
getMechanismNames
String[] getMechanismNames(Map<String,?> props)
Возвращает массив имён механизмов, соответствующих указанным политикам выбора механизма.
- Параметры:
-
props- Возможно нулевой набор свойств, используемых для указания политики безопасности SASL-механизмов. Например, еслиpropsсодержит свойствоSasl.POLICY_NOPLAINTEXTсо значением"true", то фабрика не должна возвращать какие-либо SASL-механизмы, уязвимые к простым пассивным атакам. См. классSaslдля полного списка свойств политики. Не относящиеся к политике свойства, если они присутствуют вprops, игнорируются, включая любые записи в карте с ключами, отличными от String. - Возвращает:
- Непустой массив, содержащий зарегистрированные в IANA имена SASL-механизмов.
© 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/SaslClientFactory.html