Класс Sasl

public class Sasl
extends Object

Статический класс для создания клиентов и серверов SASL.

Этот класс определяет политику поиска, загрузки и создания экземпляров клиентов и серверов SASL.

Например, приложение или библиотека получает клиента SASL, выполнив действия примерно такого вида:

SaslClient sc = Sasl.createSaslClient(mechanisms,
    authorizationId, protocol, serverName, props, callbackHandler);

Затем оно может продолжить использование экземпляра для создания подключения аутентификации.

Аналогично, сервер получает сервер SASL, используя код, который выглядит следующим образом:

SaslServer ss = Sasl.createSaslServer(mechanism,
    protocol, serverName, props, callbackHandler);

Поля

QOP

public static final String QOP

Имя свойства, которое определяет качество защиты, которое использовать. Свойство содержит упорядоченный список значений качества защиты, разделенных запятыми, которые клиент или сервер готовы поддерживать. Значение qop может быть одним из следующих:

• "auth" — только аутентификация
• "auth-int" — аутентификация плюс защита целостности
• "auth-conf" — аутентификация плюс защита целостности и конфиденциальности

Порядок в списке определяет порядок предпочтения клиента или сервера. Если это свойство отсутствует, значение по умолчанию qop равно "auth". Значение этой константы равно "javax.security.sasl.qop".

См. также:

Значения константного поля

STRENGTH

public static final String STRENGTH

Имя свойства, которое определяет силу шифрования, используемую. Свойство содержит упорядоченный список значений силы шифрования, разделенных запятыми, которые клиент или сервер готовы поддерживать. Значение силы может быть одним из следующих:

• "low"
• "medium"
• "high"

Порядок в списке определяет порядок предпочтения клиента или сервера. Реализация должна позволять настраивать значение этих параметров. Приложение может использовать Java Cryptography Extension (JCE) с механизмами, поддерживающими JCE, для управления выбором наборов шифрования, которые соответствуют значениям силы.
Если это свойство отсутствует, значение силы по умолчанию равно "high,medium,low". Значение этой константы равно "javax.security.sasl.strength".

См. также:

Значения константного поля

SERVER_AUTH

public static final String SERVER_AUTH

Имя свойства, которое определяет, должен ли сервер пройти аутентификацию для клиента. Свойство содержит "true" , если сервер должен пройти аутентификацию для клиента; "false" в противном случае. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.server.authentication".

См. также:

Значения константного поля

BOUND_SERVER_NAME

public static final String BOUND_SERVER_NAME

Имя свойства, которое определяет имя привязанного сервера для непривязанного сервера. Сервер создается как непривязанный сервер путём установки параметра serverName в методе createSaslServer(java.lang.String, java.lang.String, java.lang.String, java.util.Map<java.lang.String, ?>, javax.security.auth.callback.CallbackHandler) в значение null. Свойство содержит имя привязанного хоста после завершения обмена аутентификацией. Оно доступно только со стороны сервера.
Значение этой константы равно "javax.security.sasl.bound.server.name".

См. также:

Значения константного поля

MAX_BUFFER

public static final String MAX_BUFFER

Имя свойства, которое определяет максимальный размер буфера приёма в байтах SaslClient/SaslServer. Свойство содержит строковое представление целого числа.
Если это свойство отсутствует, размер по умолчанию определяется механизмом.
Значение этой константы равно "javax.security.sasl.maxbuffer".

См. также:

Значения константного поля

RAW_SEND_SIZE

public static final String RAW_SEND_SIZE

Имя свойства, которое определяет максимальный размер буфера отправки в байтах SaslClient/SaslServer. Свойство содержит строковое представление целого числа. Значение этого свойства договариваются клиент и сервер во время обмена аутентификацией.
Значение этой константы равно "javax.security.sasl.rawsendsize".

См. также:

Значения константного поля

REUSE

public static final String REUSE

Имя свойства, которое определяет, следует ли повторно использовать ранее аутентифицированную сессионную информацию. Свойство содержит "true", если механизм реализации может попытаться повторно использовать ранее аутентифицированную сессионную информацию; оно содержит "false", если реализация не должна повторно использовать ранее аутентифицированную сессионную информацию. Значение "true" служит только подсказкой: это не обязательно означает фактическое повторное использование, поскольку повторное использование может быть невозможно по ряду причин, включая, но не ограничиваясь, отсутствием поддержки механизма повторного использования, истечением срока действия информации, подлежащей повторному использованию, и отказом пары в поддержке повторного использования. Значение свойства по умолчанию равно "false". Значение этой константы равно "javax.security.sasl.reuse". Обратите внимание, что все остальные параметры и свойства, необходимые для создания экземпляра клиента/сервера SASL, должны быть предоставлены независимо от того, было ли это свойство предоставлено. То есть вы не можете предоставить меньше информации в предвкушении повторного использования. Реализации механизмов, поддерживающие повторное использование, могут позволить настроить его реализацию, например, размер кэша, таймауты и критерии для возможности повторного использования. Такие настройки зависят от реализации.

См. также:

Значения константного поля

POLICY_NOPLAINTEXT

public static final String POLICY_NOPLAINTEXT

Имя свойства, которое определяет, разрешены ли механизмы, подверженные простым пассивным атакам с использованием открытого текста (например, "PLAIN"). Свойство содержит "true" , если такие механизмы не разрешены; "false" если такие механизмы разрешены. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.noplaintext".

См. также:

Значения константного поля

POLICY_NOACTIVE

public static final String POLICY_NOACTIVE

Имя свойства, которое определяет, разрешены ли механизмы, уязвимые для активных (несловарных) атак. Свойство содержит "true" , если механизмы, уязвимые для активных атак, не разрешены; "false" если такие механизмы разрешены. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.noactive".

См. также:

Значения константного поля

POLICY_NODICTIONARY

public static final String POLICY_NODICTIONARY

Имя свойства, которое определяет, разрешены ли механизмы, уязвимые для пассивных словарных атак. Свойство содержит "true" , если механизмы, уязвимые для словарных атак, не разрешены; "false" если такие механизмы разрешены. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.nodictionary".

См. также:

Значения константного поля

POLICY_NOANONYMOUS

public static final String POLICY_NOANONYMOUS

Имя свойства, которое определяет, разрешены ли механизмы, принимающие анонимный вход. Свойство содержит "true" , если механизмы, принимающие анонимный вход, не разрешены; "false" если такие механизмы разрешены. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.noanonymous".

См. также:

Значения константного поля

POLICY_FORWARD_SECRECY

public static final String POLICY_FORWARD_SECRECY

Имя свойства, которое определяет, требуются ли механизмы, реализующие сквозное шифрование между сессиями. Сквозное шифрование означает, что взлом одной сессии не предоставит автоматически информацию для взлома будущих сессий. Свойство содержит "true" , если механизмы, реализующие сквозное шифрование между сессиями, требуются; "false" если такие механизмы не требуются. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.forward".

См. также:

Значения константного поля

POLICY_PASS_CREDENTIALS

public static final String POLICY_PASS_CREDENTIALS

Имя свойства, которое определяет, требуются ли механизмы, передающие учетные данные клиента. Свойство содержит "true" , если механизмы, передающие учетные данные клиента, требуются; "false" если такие механизмы не требуются. Значение по умолчанию равно "false".
Значение этой константы равно "javax.security.sasl.policy.credentials".

См. также:

Значения константного поля

CREDENTIALS

public static final String CREDENTIALS

Имя свойства, которое определяет используемые учетные данные. Свойство содержит объект Java-учетных данных, специфичный для механизма. Реализации механизмов могут проверять значение этого свойства, чтобы определить, поддерживается ли им соответствующий класс. Свойство может использоваться для предоставления учетных данных механизму, поддерживающему делегированную аутентификацию.
Значение этой константы равно "javax.security.sasl.credentials".

См. также:

Значения константного поля

Методы

createSaslClient

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

Параметры:

mechanisms - Непустой список имён механизмов, которые необходимо попробовать. Каждый из них — зарегистрированное IANA имя механизма SASL. (например, "GSSAPI", "CRAM-MD5").

authorizationId - Возможно пустое протокол-зависимое идентификационное имя, используемое для авторизации. Если null или пустое, сервер выводит идентификатор авторизации из учетных данных аутентификации клиента. При успешном завершении аутентификации SASL указанному субъекту предоставляется доступ.

protocol - Непустое строковое имя протокола, для которого выполняется аутентификация (например, "ldap").

serverName - Непустое полное имя хоста сервера, к которому выполняется аутентификация.

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

cbh - Возможно пустой обработчик обратного вызова, используемый механизмами SASL для получения дополнительной информации от приложения/библиотеки для завершения аутентификации. Например, механизм SASL может потребовать идентификатор, пароль и область аутентификации от вызывающего кода. Идентификатор аутентификации запрашивается с помощью NameCallback. Пароль запрашивается с помощью PasswordCallback. Область запрашивается с помощью RealmChoiceCallback, если существует список областей для выбора, и с помощью RealmCallback, если область должна быть введена.

Возвращает:

Возможный экземпляр SaslClient, созданный с использованием предоставленных параметров. Если null, не удается найти SaslClientFactory , который бы его создал.

Выбрасывает:

SaslException - Если не удается создать SaslClient из-за ошибки.

createSaslServer

public static SaslServer createSaslServer(String mechanism,
                                          String protocol,
                                          String serverName,
                                          Map<String,?> props,
                                          CallbackHandler cbh)
                                   throws SaslException

Параметры:

mechanism - Непустое имя механизма. Должно быть зарегистрированным IANA именем механизма SASL. (например, "GSSAPI", "CRAM-MD5").

protocol - Непустое строковое имя протокола, для которого выполняется аутентификация (например, "ldap").

serverName - Полное имя хоста сервера или null, если сервер не привязан к какому-либо конкретному имени хоста. Если механизм не допускает сервер без привязки, будет брошено исключение SaslException.

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

cbh - Возможно пустой обработчик обратного вызова, используемый механизмами SASL для получения дополнительной информации от приложения/библиотеки для завершения аутентификации. Например, механизм SASL может потребовать идентификатор, пароль и область аутентификации от вызывающего кода. Идентификатор аутентификации запрашивается с помощью NameCallback. Пароль запрашивается с помощью PasswordCallback. Область запрашивается с помощью RealmChoiceCallback, если существует список областей для выбора, и с помощью RealmCallback, если область должна быть введена.

Возвращает:

Возможный экземпляр SaslServer, созданный с использованием предоставленных параметров. Если null, не удается найти SaslServerFactory , который бы его создал.

Выбрасывает:

SaslException - Если не удается создать SaslServer из-за ошибки.

getSaslClientFactories

public static Enumeration<SaslClientFactory> getSaslClientFactories()

Получает перечисление известных фабрик для создания SaslClient. Этот метод использует тот же алгоритм поиска фабрик, что и createSaslClient().

Возвращает:

Непустое перечисление известных фабрик для создания SaslClient.

См. также:

createSaslClient(java.lang.String[], java.lang.String, java.lang.String, java.lang.String, java.util.Map<java.lang.String, ?>, javax.security.auth.callback.CallbackHandler)

getSaslServerFactories

public static Enumeration<SaslServerFactory> getSaslServerFactories()

Получает перечисление известных фабрик для создания SaslServer. Этот метод использует тот же алгоритм поиска фабрик, что и createSaslServer().

Возвращает:

Непустое перечисление известных фабрик для создания SaslServer.

См. также:

createSaslServer(java.lang.String, java.lang.String, java.lang.String, java.util.Map<java.lang.String, ?>, javax.security.auth.callback.CallbackHandler)