Интерфейс SaslServerFactory

public interface SaslServerFactory

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

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

Since:

1.5

См. также:

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

Модификатор и тип	Метод	Описание
`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.
Возвращает:: Непустой массив содержащий имена зарегистрированных в IANA SASL-механизмов.

© 1993, 2021, 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/17/docs/api/java.security.sasl/javax/security/sasl/SaslServerFactory.html