Spec-Zone.ru › OpenJDK 25

Интерфейс SaslServerFactory

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

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

С версии:
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, не равное 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.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, способы обхода проблем и примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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

Spec-Zone.ru

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