Интерфейс SaslClientFactory

public interface SaslClientFactory

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

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

Since:

1.5

See Also:

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

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

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

createSaslClient

SaslClient createSaslClient(String[] mechanisms, String authorizationId, String protocol, String serverName, Map<String,?> props, CallbackHandler cbh) throws SaslException

Создает SaslClient с использованием предоставленных параметров.

Parameters:: mechanisms - Непустой список имён механизмов для попыток. Каждый представляет собой зарегистрированное IANA имя механизма SASL (например, "GSSAPI", "CRAM-MD5").; authorizationId - Возможно, пустое значение идентификации, зависящее от протокола, используемое для авторизации. Если равно null или пустое, сервер выводит идентификатор авторизации из учетных данных клиента. При успешном завершении аутентификации SASL указанному субъекту предоставляется доступ.; protocol - Непустая строка имени протокола, для которого выполняется аутентификация (например, "ldap").; serverName - Непустое полное имя хоста сервера, к которому производится аутентификация.; props - Возможно, пустой набор свойств, используемых для выбора механизма SASL и для настройки обмена аутентификации выбранного механизма. Список стандартных свойств см. в классе Sasl. Можно включать другие, возможно, специфичные для механизма, свойства. Свойства, не относящиеся к выбранному механизму, игнорируются, включая любые записи карты с ключами, отличными от String.; cbh - Возможно, null обработчик обратных вызовов, используемый механизмами SASL для получения дополнительной информации от приложения/библиотеки для завершения аутентификации. Например, механизм SASL может потребовать идентификатор, пароль и область аутентификации от вызывающей стороны. Идентификатор аутентификации запрашивается с помощью NameCallback. Пароль запрашивается с помощью PasswordCallback. Область запрашивается с помощью RealmChoiceCallback, если есть список областей для выбора, и с помощью RealmCallback, если область должна быть введена.
Returns:: Возможный null SaslClient, созданный с использованием предоставленных параметров. Если null, этот фабричный метод не может создать SaslClient с использованием предоставленных параметров.
Throws:: SaslException - Если невозможно создать SaslClient из-за ошибки.

getMechanismNames

String[] getMechanismNames(Map<String,?> props)

Возвращает массив имён механизмов, соответствующих указанным политикам выбора механизма.

Parameters:: props - Возможно, null набор свойств, используемых для указания политики безопасности механизмов SASL. Например, если props содержит свойство Sasl.POLICY_NOPLAINTEXT со значением "true", то фабрика не должна возвращать механизмы SASL, уязвимые к простым пассивным атакам. Полный список свойств политики см. в классе Sasl. Свойства, не относящиеся к политике, если они присутствуют в props, игнорируются, включая любые записи карты с ключами, отличными от String.
Returns:: Непустой массив, содержащий зарегистрированные IANA имена механизмов SASL.

© 1993, 2023, 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/21/docs/api/java.security.sasl/javax/security/sasl/SaslClientFactory.html