Spec-Zone.ru › OpenJDK 24

Интерфейс SaslServerFactory

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

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

Since:
1.5
См. также:
  • SaslServer
  • Sasl

Краткое описание методов

Модификатор и тип Метод Описание
SaslServer createSaslServer(String mechanism, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh)
Создаёт SaslServer с использованием предоставленных параметров.
String[] getMechanismNames(Map<String,?> props)
Возвращает массив имён механизмов, соответствующих указанным политикам выбора механизма.

Подробное описание методов

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API