Spec-Zone.ru › OpenJDK 24

Интерфейс SaslClientFactory

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

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

С момента:
1.5
См. также:
  • SaslClient
  • Sasl

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

Модификатор и тип Метод Описание
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 с использованием предоставленных параметров.
Параметры:
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

Spec-Zone.ru

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