Spec-Zone .ru спецификации, руководства, описания, API

Содержание документации

Проект 0.4.2

Оглавление

 

1. Введение

2. Соответствие

3. Свойства среды

4. Имена

5. Атрибуты

6. URL

7. Объекты Java

8. Схема

9. Исключения

10. Отображение API

11. Федерация

12. SASL

13. Расширения и Средства управления

14. Уведомление о событии

15. SSL

1. Введение

Не все функции, описанные в этом документе, должны поддерживаться поставщиком услуг LDAP. Однако, если функция поддерживается, она должна поддерживаться в пути, описанном этим документом.

2. Соответствие

•  RFC 2251 и связанные спецификации.

•  RFC 1777 и связанные спецификации.

3. Свойства среды

Есть четыре типа свойств среды, которые влияют на поставщиков услуг LDAP:

• Стандартные свойства среды JNDI
• LDAP-специфичные свойства среды
• Специфичные для провайдера свойства среды
• Специфичные для функции свойства среды

3.1 Краткий обзор

3.1.1 Инициализация

В частности если какое-либо из следующих свойств не предоставляется в свойствах среды тогда, это разыскивается от системных свойств, параметров апплета, и и провайдер и файлы ресурсов приложения (в том порядке):

• java.naming.factory.control
• java.naming.factory.initial
• java.naming.factory.object
• java.naming.factory.state
• java.naming.provider.url

Свойства среды контекста могут быть исследованы, используя метод Context.getEnvironment.

3.1.2 Модификация

3.1.3 Контекст

3.1.4 Своевременность

3.1.5 Значения по умолчанию

Когда свойство удаляется из свойств среды контекста, контекст принимает поведение по умолчанию, определенное для того свойства. Это не обязательно означает, что значение по умолчанию должно быть записано как значение свойства. Удаление может также быть обозначено отсутствием свойства от свойств среды контекста.

3.1.6 Приемлемые Значения

3.2 Свойства JNDI

java.naming.batchsize

Значение этого свойства является строкой десятичных цифр, которая определяет пакетный размер результатов поиска, возвращенных сервером.

Это свойство влияет на поведение блокирования Context.list, Context.listBindings, и методы DirContext.search и NamingEnumeration возражают, что возвращаются. Это не влияет, сколько элементов возвращается в перечислении; это только влияет, как элементы обрабатываются в пакетном режиме или читаются на уровне протокола LDAP.

Установка нулевых средств, которые должен блокировать провайдер, пока все результаты не были получены. Установка целого числа n больше чем нулевые средства, что провайдер должен блокировать до n результаты, была получена от сервера или пока перечисление завершается, какой бы ни производит меньше числа результатов. После того, как приложение считало результаты n (использующий NamingEnumeration.next или NamingEnumeration.nextElement), провайдер должен считать n больше следствий сервера или пока перечисление завершается, какой бы ни производит меньше числа результатов.

Если это свойство не устанавливается тогда, его значение по умолчанию специфично для реализации.

Например, следующий код определяет, что провайдер должен блокировать, пока 24 записи не были считаны из сервера или пока перечисление завершается, какой бы ни производит меньше числа результатов:

env.put(Context.BATCHSIZE, "24");

java.naming.factory.control

Значение этого свойства является разделенным от двоеточия списком полностью определенных имен классов классов фабрики управления.

Фабрики ответственны за сужение класса средств управления ответом. Они создают определенные средства управления ответом из универсальных средств управления ответом, сгенерированных провайдером.

Никакое значение по умолчанию не определяется для этого свойства.

Например, следующие кодовые наборы класс ResponseControlFactory как фабрика управления, чтобы попробовать:

env.put(LdapContext.CONTROL_FACTORIES,
       "com.sun.jndi.ldap.ctl.ResponseControlFactory");

java.naming.factory.initial

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

Это используется, чтобы выбрать определенного поставщика услуг LDAP; это фактически не используется провайдером непосредственно. Это свойство не должно быть установлено, когда параметром имени начальным методам контекста является URL.

Никакое значение по умолчанию не определяется для этого свойства.

Например, следующий код выбирает провайдера Sun LDAP:

env.put(Context.INITIAL_CONTEXT_FACTORY,
       "com.sun.jndi.ldap.LdapCtxFactory");

java.naming.factory.object

Значение этого свойства является разделенным от двоеточия списком полностью определенных имен классов объектных классов фабрики.

Фабрики ответственны за создание конкретных целей из записей LDAP, возвращенных провайдером. Например, фабрика объекта Человека могла бы генерировать объект Person от записи LDAP человека класса объекта. Объектные фабрики ведут себя противоположным способом утвердить фабрики, на которых они генерируют объекты от атрибутов LDAP.

Никакое значение по умолчанию не определяется для этого свойства.

Например,

env.put(Context.OBJECT_FACTORIES,
       "com.sun.jndi.ldap.obj.PersonFromLDAP");

java.naming.factory.state

Значение этого свойства является разделенным от двоеточия списком полностью определенных имен классов классов фабрики состояния.

Фабрики ответственны за создание состояния объекта (для того, чтобы сохранить) от объекта непосредственно. Например, фабрика состояния Человека могла бы генерировать запись LDAP человека класса объекта от объекта Person. Государственные фабрики ведут себя противоположным способом возразить фабрикам в этом, они генерируют атрибуты LDAP от объектов.

Никакое значение по умолчанию не определяется для этого свойства.

Например,

env.put(Context.STATE_FACTORIES,
       "com.sun.jndi.ldap.obj.PersonToLDAP");

устанавливает класс PersonToLDAP как фабрику состояния, чтобы попробовать.

java.naming.language

Значение этого свойства является строковым тегом языка согласно RFC 1766.

Это свойство указывает на предпочтение определенному естественному языку. Провайдер может скорректировать свои запросы LDAP и ответы согласно значению этого свойства.
Влияние этого свойства специфично для реализации. Никакое значение по умолчанию не определяется.
Например:

env.put(Context.LANGUAGE, "ja-JP");

указывает на предпочтение японскому языку.

java.naming.provider.url

Значение этого свойства является списком разделенного пробелом LDAP или строк URL LDAPS, каждая из которых определяет имя хоста и номер порта сервера LDAP, и корневое отличительное имя контекста именования, чтобы использовать. URL LDAP определяет использование плоскости (то есть, незащищенный) соединение; URL LDAPS определяет использование соединения SSL. Если список содержит больше чем один URL, провайдер должен попытаться использовать каждый URL поочередно, пока это не в состоянии создать успешное соединение, и после создания, установить свойство в успешный URL.

Именем хоста по умолчанию является localhost; портом по умолчанию является 389 для простых соединений и 636 для соединений SSL. Корневое отличительное имя по умолчанию является пустой строкой. Если это свойство не устанавливается, или если или имя хоста или номер порта опускаются, то значения по умолчанию используются вместо недостающей информации. Если и имя хоста и порт отсутствуют, но непустое отличительное имя присутствует в URL, то провайдер должен использовать отличительное имя, чтобы определить имя хоста и порт сервера (ов) LDAP как описано в разделе URL и когда соединение было установлено успешно, установил свойство java.naming.provider.url в URL, созданный, используя успешное имя хоста, порт и отличительное имя. См. также раздел URL для информации о том, как провайдер должен обработать другую информацию, найденную в URL.

Например:

env.put(Context.PROVIDER_URL, "ldap://secserver:636");

ОТМЕТЬТЕ: Изменение этого свойства, используя методы Context.addToEnvironment ИЛИ Context.removeFromEnvironment не влияет на контекст. Это только используется начальными конструкторами контекста.

java.naming.referral

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

follow

автоматически следуйте за любыми отсылками.

throw

бросьте ReferralException для каждой отсылки.

ignore

проигнорируйте отсылки, если они появляются в результатах. PartialResultException бросается, чтобы указать на неполный результат. Кроме того, для серверов LDAPv3, провайдер должен запросить, чтобы отсылки были обработаны как обычные атрибуты, когда они появляются в записях. Это достигается, отправляя некритическому ManageDsaIT (RFC 3296) управление LDAP с каждым запросом LDAP. Серверы LDAP, которые не поддерживают это управление LDAP, просто проигнорируют его и обработают запрос как нормальный.

См. раздел URL для информации о том, как обработать многократные URL, найденные в единственной записи отсылки.

Если это свойство не устанавливается тогда, его значением по умолчанию является ignore.

Например:

env.put(Context.REFERRAL, "throw");

определяет, что отсылки, с которыми встречаются во время работы LDAP, должны бросить ReferralException в приложение.

java.naming.security.authentication

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

none

не используйте аутентификацию (анонимный, связывают).

simple

используйте простую аутентификацию (пароль в виде открытого текста).

Разделенный пробелом список одного или более имен механизма SASL:

используйте первый доступный механизм SASL в списке, который соответствует указанным требованиям политики

См. раздел SASL для информации о том, как это свойство используется для аутентификации SASL. См. RFC 2829 для информации о механизмах аутентификации LDAP.

Если это свойство не устанавливается тогда, его значением по умолчанию является none, если java.naming.security.credentials свойство не устанавливается, когда значением по умолчанию является simple. Если это свойство устанавливается в значение, которое провайдер не распознает или поддерживает, это должно бросить AuthenticationNotSupportedException.

Например:

env.put(Context.SECURITY_AUTHENTICATION, "simple");

определяет, что простая аутентификация используется, чтобы аутентифицировать к серверу LDAP. Или,

env.put(Context.SECURITY_AUTHENTICATION, "DIGEST-MD5 CRAM-MD5");

определяет, что аутентификация ОБЗОРА-MD5 используется и, если это механизм SASL недоступно, та аутентификация CRAM-MD5 использоваться. Если ни один не доступен, тогда бросают AuthenticationNotSupportedException.

java.naming.security.credentials

Значение этого свойства является объектом, который определяет учетные данные принципала, который будет аутентифицироваться. Его формат и обработка зависят от значения java.naming.security.authentication свойства.
Поскольку анонимный связывает, это свойство игнорируется - пустая строка всегда используется для учетных данных. Для простой аутентификации и аутентификации SASL, которая требует пароля, значение этого свойства может быть предоставлено как java.lang.String, char[] или byte[]. Если это - String или char[] тогда, это кодируется в байтовый массив, используя UTF-8 в случае LDAPv3 и закодировало использование ISO-Latin-1 в случае LDAPv2. Если это - byte[] тогда, это используется как есть.
См. раздел SASL для информации о том, как это свойство используется для аутентификации SASL.
Никакое значение по умолчанию не определяется для этого свойства.
Например:

env.put(Context.SECURITY_CREDENTIALS, "secret");

устанавливает учетные данные, чтобы быть строкой "секрет".

java.naming.security.principal

Значение этого свойства является строкой, которая определяет идентификационные данные принципала, который будет аутентифицироваться. Его формат зависит от типа аутентификации; см. RFC 2829 для получения дополнительной информации. Значение используется в качестве компонента name в LDAP ASN.1 BindRequest для non-SASL аутентификации. Для аутентификации SASL значение этого свойства используется в качестве ID аутентификации для механизмов SASL, которые нуждаются в ID аутентификации.

Провайдер не обязан проверять законность основного имени. Это может, например, только передать строку, которая будет проверена сервером. Если идентифицированный принципал не будет допустимым принципалом тогда, то провайдер должен бросить AuthenticationException.

Никакое значение по умолчанию не определяется для этого свойства.

Например:

env.put(Context.SECURITY_PRINCIPAL, "cn=admin,o=sun,c=us");

определяет основное имя, чтобы быть отличительным именем "cn=admin, o=sun, c=us".

java.naming.security.protocol

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

ssl

используйте версию 3.0 Уровня защищенных сокетов.

Если это свойство устанавливается в ssl, провайдер должен использовать сокеты SSL, или бросить ConfigurationException, если это неспособно сделать так. В дополнение к упомянутому выше значению провайдер может поддерживать другие протоколы системы защиты. Однако, такие специфичные для провайдера протоколы не могли бы поддерживаться всеми провайдерами. Если это свойство устанавливается в протокол системы защиты, который провайдер не распознает или поддерживает, это должно бросить ConfigurationException.

Если java.naming.ldap.factory.socket свойство устанавливается, то фабрика сокета, идентифицированная тем свойством, должна создать сокеты, которые являются подходящими для этой установки протокола. Например, если протокол системы защиты устанавливается в ssl, то фабрика сокета должна создать совместимые SSL сокеты.

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

Как разработчик провайдера LDAP, следует знать, что использование SSL, чтобы соединиться с сервером на порту, который не прислушивается к соединениям SSL, заставляет сокет зависать. Точно так же использование простого сокета, чтобы соединиться с сервером, который прислушивается к соединениям SSL также, приводит к зависанию. Это - характеристика протокола, который некоторые реализации могут хотеть исправлять, но иначе не обязаны делать так. Документация провайдера, однако, должна описать это поведение своим пользователям. См. SSL для информации о том, как использовать SSL.

Например:

env.put(Context.SECURITY_PROTOCOL, "ssl");

определяет, что совместимые SSL сокеты используются, чтобы связаться с сервером.

3.3 LDAP-специфичные Свойства

java.naming.ldap.attributes.binary

Значение этого свойства является строкой разделенных пробелом названий атрибута. Это определяет атрибуты, у которых есть нестроковый синтаксис. Это расширяет встроенный список провайдера нестроковых атрибутов (ниже). Значение атрибута, у которого есть нестроковый синтаксис, возвращается как байтовый массив (byte[]) вместо String.
Никакое значение по умолчанию не определяется. Если это свойство не устанавливается тогда, только у следующих атрибутов, как полагают, есть нестроковый синтаксис:

ID атрибута	OID	Ссылка
Любой ID атрибута с опцией ";binary".
photo	0.9.2342.19200300.100.1.7	RFC 1274
personalSignature	0.9.2342.19200300.100.1.53	RFC 1274
audio	0.9.2342.19200300.100.1.55	RFC 1274
jpegPhoto	0.9.2342.19200300.100.1.60	RFC 2798
javaSerializedData	1.3.6.1.4.1.42.2.27.4.1.7	RFC 2713
thumbnailPhoto	2.16.128.113533.1.1400.1	Схема LIP NAC
thumbnailLogo	2.16.128.113533.1.1400.2	Схема LIP NAC
userPassword	2.5.4.35	RFC 2256
userCertificate	2.5.4.36	RFC 2256
cACertificate	2.5.4.37	RFC 2256
authorityRevocationList	2.5.4.38	RFC 2256
certificateRevocationList	2.5.4.39	RFC 2256
crossCertificatePair	2.5.4.40	RFC 2256
x500UniqueIdentifier	2.5.4.45	RFC 2256

Например:

env.put("java.naming.ldap.attributes.binary",
       "mpegVideo myspecialkey");

сообщает провайдеру возвращаемым значениям mpegVideo и атрибутов myspecialkey как byte[].

java.naming.ldap.control.connect

Значение этого свойства является объектом Control[]. Это устанавливает средства управления запросом соединения, которые являются активными на соединении. См. LdapContext.
Никакое значение по умолчанию не определяется для этого свойства.
Например:

env.put("java.naming.ldap.control.connect",
       new Control[]{ new ManageReferralControl(true) });

устанавливает критический ManageDsaIT управление LDAP как управление запросом соединения.

java.naming.ldap.deleteRDN

Значение этого свойства является строкой, которая определяет, удаляется ли старый RDN методом Context.rename. Следующие значения определяются для этого свойства:
 

true

удалите старый RDN из записи во время переименовать работы.

false

сохраните старый RDN как значение атрибута записи.

 

Если это свойство не устанавливается тогда, его значением по умолчанию является true.

Например:

env.put("java.naming.ldap.deleteRDN", "false");

заставляет старый RDN быть сохраненным как атрибут переименованной записи.

java.naming.ldap.derefAliases

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

always

всегда разыменовывайте псевдонимы.

never

никогда не разыменовывайте псевдонимы.

finding

разыменуйте псевдонимы только во время разрешения имени (то есть, определяя местоположение целевой записи).

searching

разыменуйте псевдонимы, как только разрешение имени завершилось (то есть, после определения местоположения целевой записи).

Если это свойство не устанавливается тогда, его значением по умолчанию является always.
Например:

env.put("java.naming.ldap.derefAliases", "searching");

заставляет провайдера разыменовывать псевдонимы только, как только целевая запись была расположена.

ОТМЕТЬТЕ: это свойство не связано с флагом разыменовывать-ссылок в объекте SearchControls.

java.naming.ldap.factory.socket

Значение этого свойства является строкой, идентифицирующей имя класса фабрики сокета.
Это свойство используется, чтобы переопределить фабрику сокета по умолчанию. Класс, определенный в этом свойстве, должен реализовать интерфейс javax.net.SocketFactory. См. Справочник JSSE для получения дополнительной информации. См. SSL для информации о том, как использовать SSL.
Кроме того, если java.naming.security.protocol свойство устанавливается, то фабрика сокета, идентифицированная этим свойством, должна создать сокеты, которые являются подходящими для той установки протокола. Например, если протокол системы защиты устанавливается в ssl тогда, фабрика сокета должна создать совместимые SSL сокеты.
Никакое значение по умолчанию не определяется для этого свойства.
Например:

env.put("java.naming.ldap.factory.socket",
       "javax.net.ssl.SSLSocketFactory");

устанавливает фабрику сокета провайдера, чтобы быть javax.net.ssl.SSLSocketFactory.

java.naming.ldap.ref.separator

Значение этого свойства является строкой, содержащей символ, чтобы использовать, кодируя объект RefAddr в атрибуте javaReferenceAddress (см. Объекты Java).
Это свойство используется, чтобы избежать конфликта в случае, где символ разделителя по умолчанию появляется в компонентах объекта RefAddr.
Если это свойство не устанавливается тогда, его значением по умолчанию является '#' (символ хеша).
Например:

env.put("java.naming.ldap.ref.separator", ":");

определяет что разделитель ':' (символ двоеточия) использоваться, храня экземпляры RefAddr.

java.naming.ldap.referral.limit

Значение этого свойства является строкой десятичных цифр, определяющих максимальное количество отсылок, чтобы следовать в цепочке отсылок. Установка нуля указывает, что нет никакого предела.
Если это свойство не устанавливается тогда, значением по умолчанию является 10.
Например:

env.put("java.naming.ldap.referral.limit", "5");

определяет, что предел отсылки 5.

java.naming.ldap.typesOnly

Значение этого свойства является строкой, которая определяет, приписывают ли только ID, возвращаются в результатах - значения атрибута опускаются. Влияет на методы SearchResult.getAttributes И DirContext.getAttributes. Следующие значения определяются для этого свойства:
 

true

возврат только приписывает ID.

false

возвратите и ID атрибута и значения атрибута.

Если это свойство не устанавливается тогда, его значением по умолчанию является false.

Например:

env.put("java.naming.ldap.typesOnly", "true");

заставляет сервер возвращать ID атрибута, но не значения атрибута.

java.naming.ldap.version

Значение этого свойства является строкой, которая определяет версию протокола для провайдера. Следующие значения определяются для этого свойства:
 

2

выбирает версию 2 (LDAPv2) LDAP.

3

выбирает версию 3 (LDAPv3) LDAP.

Если это свойство не устанавливается тогда, провайдер сначала пытается связать использование LDAP v3 и сбои к использованию LDAP v2, если ошибка протокола получается от сервера. Этот failover механизм только используется, когда свойство java.naming.security.authentication указывает анонимный, связывают или простая аутентификация.

Например:

env.put("java.naming.ldap.version", "2");

запрашивает провайдера LDAP связаться с сервером, используя LDAPv2.

3.4 Специфичные для функции Свойства

3.4.1 Свойства SASL

java.naming.security.sasl.authorizationId

Значение этого свойства является строкой, которая определяет ID авторизации для механизмов SASL.

Если это свойство не устанавливается, то ID авторизации, который передают к механизмам SASL, является пустой строкой. Согласно SASL (RFC 2222), используя ID авторизации пустой строки направляет сервер, чтобы получить ID авторизации из учетных данных аутентификации клиента.

Например:

env.put("java.naming.security.sasl.authorizationId",
       "dn:cn=administrators,ou=groups,o=sun,c=us");

определяет идентификационные данные, чтобы использовать для авторизации (управление доступом) после успешной аутентификации.

java.naming.security.sasl.realm

Значение этого свойства является строкой, которая определяет информацию области, запрошенную некоторыми механизмами SASL, такими как ОБЗОР-MD5.

Если это свойство не устанавливается, то специфичное для механизма значение по умолчанию, такое как согласованное между клиентом и сервером во время обмена аутентификации используется.

Например:

env.put("java.naming.security.sasl.realm", "webusers");

определяет, что клиент хочет использовать область "веб-пользователей" для аутентификации.

java.naming.security.sasl.callback

Значение этого свойства является экземпляром javax.security.auth.callback.CallbackHandler. Когда провайдер использует механизм SASL, который требует обратных вызовов, механизм SASL использует объект, предоставленный в свойстве. Обработчик обратного вызова должен удовлетворить NameCallback, предоставляя ID аутентификации.

Если это свойство не устанавливается, то провайдер должен использовать обработчик обратного вызова по умолчанию, который удовлетворяет NameCallback, используя значение свойства java.naming.security.principal, удовлетворяет PasswordCallback, используя значение свойства java.naming.security.credentials, и удовлетворяет RealmCallback и RealmChoiceCallback (описанный в Java API SASL) использование значения свойства java.naming.security.sasl.realm.

Например:

env.put("java.naming.security.sasl.callback",
       new MyCallbackHandler());

предоставляет экземпляр обработчика обратного вызова для механизмов SASL, чтобы использовать.

Значением этого свойства является ', '-separated список качества защиты (qop) значения, используемые, чтобы определить qop предпочтение клиента. Значение qop является одним из

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

Значением этого свойства является ', '-separated список значений силы шифра, используемых, чтобы определить предпочтение клиента. Значение силы является одним из

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

Для конфиденциальности в ОБЗОРЕ-MD5 "high" отображается на "3des", "medium" к "rc4" или "des", и "low" к "rc4-56" или "rc4-40".

Значение этого свойства является строковым представлением целого числа, которое определяет максимальный размер получить буфера в байтах, которые клиент готов получить. Если это свойство отсутствует, размер по умолчанию определяется механизмом SASL.

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

Значение этого свойства является или "истиной" или "ложью", определяя, должен ли выбранный механизм SASL поддерживать прямую тайну между сеансами или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

Значение этого свойства является или "истиной" или "ложью", определяя, должен ли выбранный механизм SASL потребовать удостоверений клиента или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

Значение этого свойства является или "истиной" или "ложью", определяя, не должен ли выбранный механизм SASL быть восприимчивым к простым простым пассивным атакам или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

Значение этого свойства является или "истиной" или "ложью", определяя, не должен ли выбранный механизм SASL быть восприимчивым к активному (несловарь) атаки или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

Значение этого свойства является или "истиной" или "ложью", определяя, не должен ли выбранный механизм SASL быть восприимчивым к атакам с подбором по словарю или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

Значение этого свойства является или "истиной" или "ложью", определяя, не должен ли выбранный механизм SASL принять анонимные входы в систему или нет, соответственно. Если это свойство отсутствует, значение по умолчанию является "ложью".

3.5 Специфичные для провайдера Свойства

4. Имена

1. Имена String, предоставленные как параметры методам контекста, находятся в составном синтаксисе имени. Первый компонент составного имени является отличительным именем LDAP, в то время как остальная часть компонентов используется для федерации.
2. Если параметром Name является объект CompositeName тогда, его первый компонент, как предполагается, является отличительным именем LDAP, и остающиеся компоненты (если кто-либо) используются для федерации.
3. Если параметром Name не является объект CompositeName тогда, все его компоненты, как предполагается, являются проанализированной формой отличительного имени LDAP. Таким образом, каждый компонент Name является относительным отличительным именем LDAP (RDN).
4. Имена анализируются, используя синтаксический анализатор имени, возвращенный методом Context.getNameParser. Синтаксический анализатор принимает отличительные имена LDAP, поскольку String возражает и производит отличительные имена LDAP, как Name возражает.
5. Имена, возвращенные операциями контекста, являются строковыми именами составного объекта или представляют URL в виде строки.

• CN=Steve Kille, O=Isode Limited, C=GB
• OU=Sales+CN=J. Smith, O=Widget Inc., C=US
• CN=L. Eagle, O=Sue\, Grabbit and Runn, C=GB

Имя, предоставленное контексту LDAP, всегда относительно того контекста. Например, учитывая контекст LDAP (lctx) для "dc=widget,dc=com", чтобы назвать записи LDAP в том поддереве, имя относительно "dc=widget,dc=com" должно быть предоставлено. Например, следующий вызов получает атрибуты для записи "cn=John Smith,dc=widget,dc=com".

       Attributes attrs = lctx.getAttributes("cn=John Smith");

Точно так же, когда контекст перечисляется, используя любой из методов перечисления (Context.list, Context.listBindings, DirContext.search), возвращенные имена относительно целевого контекста - перечисляемый контекст. Когда отсылки вызываются вместо относительного имени, LDAP или строка URL LDAPS, содержащая полностью определенное имя, возвращаются. (Если перечисление выполнялось, используя простое соединение, строка URL LDAP возвращается; если это было сделано, используя соединение SSL, строка URL LDAPS возвращается.) Формат URL LDAP определяется в RFC 2255.

LDAP URL, которые следуют за RFC 2255 и URL LDAPS, может быть предоставлен любому из методов контекста. Имя хоста и номер порта извлекаются из URL и используются, чтобы связаться с сервером LDAP; схема URL ("ldap" или "ldaps") используется, чтобы определить, используется ли соединение плоскости или SSL. Свойства java.naming.factory.initial И java.naming.provider.url игнорируются. Например,

   DirContext ictx = new InitialDirContext();
   Attributes attrs = ictx.getAttributes(
       "ldap://wserver:389/cn=John Smith,dc=widget,dc=com");

Этот фрагмент кода связывается с сервером LDAP в машине wserver в порту 389, используя простое соединение.

5. Атрибуты

Провайдер LDAP ожидает так ввод и возвращает как выходной все значения атрибута или как String или как объекты byte[]. См. свойство среды java.naming.ldap.attributes.binary для того, которые обрабатываются как byte[] и как расширить список.

6. URL

ldap://host:port/dn?attributes?scope?filter?extensions

Информация об аутентификации может быть определена в части extensions URL. См. RFC для полного описания формата.

В дополнение к URL LDAP провайдер может также поддерживать нестандартные, но широко используемые URL LDAPS. LDAPS URL используют соединения SSL вместо плоскости (то есть, незащищенные) соединения. У них есть синтаксис, подобный URL LDAP кроме схем, отличаются, и порт по умолчанию для URL LDAPS 636 вместо 389.

ldaps://host:port/dn?attributes?scope?filter?extensions

URL играют роль в нескольких местах в JNDI:

1. Конфигурация поставщиков услуг.
   Чтобы сконфигурировать поставщика услуг LDAP, Вы обычно предоставляете один или более разделенных пробелом LDAP или URL LDAPS в свойстве java.naming.provider.url. Это используется поставщиком услуг LDAP, чтобы сконфигурировать его соединение с сервером каталогов. Только host, port, и части dn URL релевантны в этой установке. Предоставление других частей URL приводит к ConfigurationException.
    
2. Параметр начальным методам контекста.
   Если строку URL (с синтаксисом scheme_id:rest_of_name) передают к методам в InitialContext, или как параметр String или как первый компонент Name, идентификатор схемы URL используется, чтобы определить местоположение фабрики контекста для того, чтобы обработать ту схему. Если ни один не находится, строка URL обрабатывается как обычное имя и передается к начальному контексту, определенному свойством java.naming.factory.initial, используется. См. метод java.naming.spi.NamingManager.getURLContext для деталей о том, как располагаются фабрики контекста URL. Отметьте, что эта поддержка URL как имена только доступна в начальном контексте.

   За исключением поисковых методов, когда LDAP или URL LDAPS передают как имя к начальному контексту, URL не должен содержать запрос ('?') компоненты. Иначе, InvalidNameException бросается поставщиком услуг. Для поисковых методов компоненты запроса URL переопределяют любые соответствующие компоненты, предоставленные как параметры. Например, если URL LDAP, содержащий компонент контекста, предоставляется, то тот контекст переопределяет любой контекст, устанавливающий, который можно передать в параметре SearchControls.
    

3. Отсылки.
   Отсылка LDAP содержит список одного или более URL. Чтобы обработать отсылку LDAP (или явно или неявно устанавливая свойство java.naming.referral), поставщик услуг должен использовать информацию в этих URL, чтобы создать соединения с серверами LDAP, к которым они обращаются. Когда многократные URL присутствуют в единственной отсылке, они обрабатываются как альтернативы, и каждый сопровождается, пока каждый не успешно выполняется. Полный URL (то есть, включая любые компоненты запроса) используется.
    
4. Возвращенный как имя в списке и поисковых перечислениях.
   Когда у имени возвращаемой записи есть имя, которое не является относительно целевого контекста (то есть, запускающийся контекст для списка или поиска), имя возвращается как URL. См. метод NameClassPair.isRelative для деталей.
    
5. Параметр методу getObjectInstance NamingManager или DirectoryManager.
   Когда пространство имен LDAP объединяется в федерацию под другим пространством имен (например, таким как DNS), информацией, которая хранится в превосходящем пространстве имен, мог бы быть LDAP или URL LDAPS. В таком сценарии работа поиска/списка/поиска в превосходящем пространстве имен возвратила бы Reference, содержащий LDAP или URL LDAPS для пространства имен LDAP. Поставщик услуг для превосходящего пространства имен передал бы Reference к методу getObjectInstance, чтобы создать экземпляр контекста LDAP.

7. Объекты Java

7.1 Хранение

• Context.bind()
• Context.rebind()
• DirContext.bind()
• DirContext.rebind()

1. Экземпляры Reference
2. Объекты, которые реализуют интерфейс Referenceable
3. Объекты, которые реализуют интерфейс Serializable
4. Объекты, которые реализуют интерфейс DirContext

Ссылки, referenceable и сериализуемые объекты должны быть сохранены согласно RFC 2713. объекты DirContext должны храниться, храня их атрибуты.

Храня список ссылки RefAddr в атрибут javaReferenceAddress, разделителем, чтобы использовать для того, чтобы разграничить позицию адреса, тип и контент управляют, используя свойство среды java.naming.ldap.ref.separator. Если это свойство среды не определяется, символ хеша '#' должен использоваться в качестве разделителя.

Провайдер использует метод DirectoryManager.getStateToBind, храня объекты в каталоге. Это позволяет объектам любого типа быть преобразованными в одну из этих четырех категорий, упомянутых выше так, чтобы они могли быть сохранены в каталог.

7.2 Чтение

• Context.lookup()
• Context.lookupLink()
• Binding.getObject()

8.0 Схема

• AttributeDefinition
• ClassDefinition
• SyntaxDefinition

Разрешение, чтобы изменить содержание дерева схемы определяется администратором каталога. Когда дерево схемы изменяется, изменения производятся в схеме, сохраненной на сервере каталогов.

8.1 Древовидная структура схемы

• MatchingRule
• ExtensionDefinition
• ControlDefinition
• SASLDefinition
• 
   

Любая из этой привязки может отсутствовать, если базовый каталог не публикует такую информацию о схеме, или поставщик услуг не поддерживает получение их. Если эти имена присутствуют в корневом контексте схемы, однако, у них должна быть привязка, определенная в вышеупомянутой таблице.

Названия атрибута и значения атрибутов этих записей являются нечувствительными к регистру.

8.2 Определения атрибута

У каждого объекта в контексте "AttributeDefinition" есть следующие обязательные и дополнительные атрибуты:
 

Эти атрибуты имеют 1 к 1 корреспонденция именам, определенным в RFC 2252 для "AttributeTypeDescription". Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий атрибут "cn", используя следующий код:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext cnSchema = schema.lookup("AttributeDefinition/cn");

Если бы Вы тогда получаете атрибуты "cnSchema" объекта DirContext, Вы видели бы:

NUMERICOID     2.5.4.3
NAME           cn
SYNTAX         1.3.6.1.4.1.1466.115.121.1.15
DESC           Standard Attribute, alias for commonName

Эквивалентный способ получить "cnSchema" состоит в том, если у Вас уже есть атрибут "cn". Следующий код иллюстрирует эту альтернативу:

Attributes attrs = ctx.getAttributes("cn=John", new String[]{"cn"});
Attribute cnAttr = attrs.get("cn");
DirContext cnSchema = cnAttr.getAttributeDefinition();

8.3 Определения Класса объекта

У каждого объекта в контексте "ClassDefinition" есть следующие обязательные и дополнительные атрибуты:
 

Эти атрибуты имеют 1 к 1 корреспонденция именам, определенным в RFC 2252 для "ObjectClassDescription". Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий класс объекта "страны", используя следующий код:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext countrySchema = schema.lookup("ClassDefinition/country");

Если бы Вы тогда получаете атрибуты "countrySchema" объекта DirContext, Вы видели бы:

NUMERICOID     2.5.6.2
NAME           country
MAY            aci, searchguide, description
MUST           objectclass, c
DESC           Standard ObjectClass
SUP            top

Эквивалентный способ получить "countrySchema" состоит в том, если у Вас уже есть объект "страны". Следующий код иллюстрирует эту альтернативу:

// Read object from directory
DirContext countryObj = (DirContext)ctx.lookup("c=us", new String[]{"country"});

// Get all of object's object class definitions
DirContext objClasses = countryAttr.getSchemaClassDefinition();

// Pick out "country" object class in particular
DirContext countryClass = (DirContext)objClasses.lookup("country");

ОТМЕТЬТЕ: JNDI 1.1's спецификация getSchemaClassDefinition() подразумевает, что поставщик услуг должен возвратить любое из определений класса объекта объекта. Эта спецификация является несоответствующей, потому что у объекта обычно есть многократные классы объектов, и приложение могло бы потребовать знания о любых из тех классов объектов в зависимости от того, что это делает. Предложение как иллюстрировано примером выше состоит в том, чтобы возвратить контекст, содержащий все определения класса объекта.

8.4 Определения синтаксиса

У каждого объекта в контексте "SyntaxDefinition" есть следующие обязательные и дополнительные атрибуты:
 

Эти атрибуты имеют 1 к 1 корреспонденция именам, определенным в RFC 2252 для "SyntaxDescription". Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий "1.3.6.1.4.1.1466.115.121.1.15" синтаксиса, используя следующий код:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext dirStringSchema = 
   schema.lookup("SyntaxDefinition/1.3.6.1.4.1.1466.115.121.1.15");

Если бы Вы тогда получаете атрибуты "dirStringSchema" объекта DirContext, Вы видели бы:

NUMERICOID     1.3.6.1.4.1.1466.115.121.1.15
DESC           Directory String

Эквивалентный способ получить "dirStringSchema" состоит в том, если у Вас уже есть атрибут, у которого есть тот синтаксис (такой как, атрибут "страны"). Следующий код иллюстрирует эту альтернативу:

Attributes attrs = ctx.getAttributes("c=us", new String[]{"country"});
Attribute countryAttr = attrs.get("country");
DirContext dirStringSchema = countryAttr.getSyntaxAttributeDefinition();

8.5 Соответствие Правил

То, когда соответствующее правило является расширяемым правилом соответствия, оно должно также содержать, "ПРИМЕНЯЕТ" атрибут, перечисляющий атрибуты, к которым может быть применено это расширяемое правило соответствия.

У каждого объекта в контексте "MatchingRule" есть следующие обязательные и дополнительные атрибуты:
 

Эти атрибуты имеют 1 к 1 корреспонденция именам, определенным в RFC 2252 для "MatchingRuleDescription" и "MatchingRuleUseDescription". Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий "soundAlikeMatch" синтаксис, используя следующий код:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext soundMatchSchema = 
   schema.lookup("MatchingRule/soundAlikeMatch");

Если бы Вы тогда получаете атрибуты "soundMatchSchema" объекта DirContext, Вы видели бы:

NUMERICOID     1.2.3.4.5
NAME           soundAlikeMatch
SYNTAX         1.3.6.1.4.1.1466.115.121.1.15 (for directory string)
APPLIES        2.5.4.41, 2.5.4.15
DESC           Home-grown Phonetic match

8.6 Определения расширения

У каждого объекта в контексте "ExtensionDefinition" есть следующие обязательные и дополнительные атрибуты:
 

Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий расширение TLS Запуска ("1.3.6.1.4.1.1466.20037") использование следующего кода:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext startTLSSchema = 
   schema.lookup("ExtensionDefinition/1.3.6.1.4.1.1466.20037");

Если бы Вы тогда получаете атрибуты "startTLSSchema" объекта DirContext, Вы видели бы:

NUMERICOID     1.3.6.1.4.1.1466.20037
DESC           Start TLS (see RFC 2830)

8.7 Определения управления

У каждого объекта в контексте "ControlDefinition" есть следующие обязательные и дополнительные атрибуты:
 

Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий управление сортировкой серверной стороны ("1.2.840.113556.1.4.473") использование следующего кода:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext svrSortSchema = 
   schema.lookup("ControlDefinition/1.2.840.113556.1.4.473");

Если бы Вы тогда получаете атрибуты "svrSortSchema" объекта DirContext, Вы видели бы:

NUMERICOID     1.2.840.113556.1.4.473
DESC           server-side sorting of search results

8.8 Механизмы SASL

У каждого объекта в контексте "SASLMechanism" есть следующие обязательные и дополнительные атрибуты:
 

Все значения атрибута представляются классом java.lang.String.

Можно, например, получить объект, представляющий ВНЕШНИЙ механизм SASL, используя следующий код:

DirContext schema = ctx.getSchema(""); // get schema tree
DirContext saslExternalSchema = 
   schema.lookup("SASLMechanism/EXTERNAL");

NAME     
EXTERNAL
DESC     EXTERNAL SASL mechanism (RFC
2222)

9. Исключения

10. Отображение API

EventContext.addNamingListener

EventDirContext.addNamingListener

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

Context.addToEnvironment

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

Предоставление нуля для значения свойства имеет тот же самый эффект как удаление свойства.
Для всех свойств среды записывается новое свойство, даже если оно не влияет на контекст. См. раздел Свойств Среды.

Context.bind

DirContext.bind

Выполните LDAP, добавляет работа, чтобы создать новую запись в каталоге. Метод DirContext.bind может принять нуль как объект связать, если это также предоставляется непустое множество атрибутов. Иначе, если методу дают недостаточную информацию (то есть, никакой объект или атрибуты), никакая запись не может быть добавлена. Если объект обеспечивается в параметрах, то он преобразовывается в атрибуты и сохранен в записи наряду с любыми предоставленными атрибутами, как описано в разделе Объектов Java. Провайдер должен использовать метод DirectoryManager.getStateToBind, чтобы преобразовать входной объект в форму, которую это может сохранить.
Если провайдер не поддерживает привязку каких-либо объектов в каталоге тогда, это должно бросить OperationNotSupportedException. Иначе, если это поддерживает обязательные объекты, но не поддерживает предоставленный объект тогда, это должно бросить IllegalArgumentException.

Context.close

Высвободите средства, связанные с контекстом. Например, если соединение, используемое этим контекстом, не совместно используется с другим контекстом, провайдер может отказаться от любых выдающихся запросов и закрыть сетевое соединение с сервером. Точно то, какие средства высвобождаются, является зависящим от реализации.

Context.composeName

Если родительский контекст от того же самого пространства имен LDAP, то свяжите имена согласно синтаксису имени LDAP, описанному в Context.getNameParser(). Иначе, свяжите имена как составные имена.

Context.createSubcontext

DirContext.createSubcontext

Выполните LDAP, добавляет работа, чтобы создать именованную запись и ее связанные атрибуты. Если никакие атрибуты не предоставляются тогда, атрибут objectClass сгенерирован со значениями top, и javaContainer (javaContainer является структурным классом, который необходим, чтобы избежать ошибки нарушения схемы).

Context.destroySubcontext

Выполните LDAP, удаляют работу, чтобы удалить именованную запись и ее связанные атрибуты. Именованная запись должна быть листовой записью; поддеревья не удаляются. Если листовая запись не существует (но ее родитель существует), работа все еще успешно выполняется.

LdapContext.extendedOperation

Выполните LDAP расширенная работа.

DirContext.getAttributes

Выполните работу поиска базового объекта LDAP, чтобы получить атрибуты записи LDAP. Используйте" (objectclass = *)" как фильтр.
Если список требуемых атрибутов является нулем или содержит специальный идентификатор атрибута '*' тогда, все пользовательские атрибуты при записи LDAP возвращаются. Если операционные атрибуты требуются тогда, те идентификаторы атрибута должны присутствовать в списке требуемых атрибутов.

LdapContext.getConnectControls

Получите средства управления запросом соединения в действительности для LDAP, связывают операции, вызванные на этот контекст.

Context.getEnvironment

Возвратите свойства среды, записанные в контексте.

Context.getNameInNamespace

Возвратите отличительное имя LDAP контекста.

Context.getNameParser

Возвратите синтаксический анализатор имени, который анализирует имена LDAP согласно RFC 2253.

LdapContext.getRequestControls

Получите средства управления запросом в действительности для операций LDAP, впоследствии вызванных на этот контекст.

LdapContext.getResponseControls

Получите средства управления ответом, возвращенные последней работой LDAP, вызванной на этот контекст.

DirContext.getSchema

См. Раздел Схемы.

DirContext.getSchemaClassDefinition

См. Раздел Схемы.

Context.list

Выполните одноуровневую поисковую работу LDAP именованной записи, используя фильтр" (objectclass = *)", чтобы получить имена записей сразу ниже именованной записи.
Попросите, как минимум, атрибуты javaClassName так, чтобы имя класса каждой записи могло быть определено. Если имя класса не может быть определено, возвратите javax.naming.directory.DirContext как имя класса.
Имена, которые возвращаются, или относительно именованного контекста, или они - LDAP или URL LDAPS.

Context.listBindings

Выполните одноуровневую поисковую работу LDAP именованной записи, используя фильтр" (objectclass = *)", чтобы получить атрибуты, представляющие объекты (или ссылки на объект). Запросите атрибуты на то, что они восстановили объект Java и возможно другие атрибуты также. См. Объекты Java на том, как восстановить объект. Если объект не может быть восстановлен согласно RFC 2713, тогда возвращают объект DirContext представление записи LDAP. Провайдер должен использовать метод DirectoryManager.getObjectInstance, чтобы удовлетворить звонки в метод Binding.getObject.
Имена, которые возвращаются, или относительно именованного контекста, или они - LDAP или URL LDAPS.

Context.lookup

Context.lookupLink

Выполните работу поиска базового объекта LDAP именованной записи, используя фильтр" (objectclass = *)". Запрос (возможно все) атрибуты для того, чтобы восстановить объект Java. См. Объекты Java на том, как восстановить объект. Провайдер должен использовать метод DirectoryManager.getObjectInstance, чтобы удовлетворить звонки в метод Binding.getObject.

DirContext.modifyAttributes

Выполните LDAP, изменяют работу при именованной записи, используя предоставленные модификации. Для перегруженный метод, который принимает Attributes, сначала преобразуйте параметр Attributes в упорядоченный список модификаций, перечисляя его содержание, используя Attributes.getAll() и снова используя параметр работы модификации (mod_op).

Инициализируйте новый экземпляр этого контекста с указанными средствами управления запросом.

Context.rebind

DirContext.rebind

Этот метод может включить несколько различных операций LDAP. Сначала получите атрибуты существующей записи. Если существующая запись не существует, этот метод ведет себя то же самое как bind(). Иначе, если никакие атрибуты не были предоставлены, и связываемым объектом является DirContext, вызовите DirContext.getAttributes() и используйте результат в качестве параметра атрибутов (attrs). Если нет все еще никаких атрибутов, используйте атрибуты исходной записи в качестве attrs. Удалите существующую запись, используя LDAP, удаляют работу. Преобразуйте объект, обеспеченный в параметрах в атрибуты (как описано в разделе Объектов Java), и хранилище в записи наряду с attrs, используя LDAP добавляют работу. Провайдер должен использовать метод DirectoryManager.getStateToBind, чтобы преобразовать входной объект в форму, которую это может сохранить.

LdapContext.reconnect

Повторно соединитесь с сервером LDAP, используя предоставленные средства управления запросом соединения и текущие свойства среды.

Context.removeFromEnvironment

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

Для всех свойств среды записывается новое свойство, даже если оно не влияет на контекст. Удаление свойства должно заставить контекст принимать значение по умолчанию свойства.

EventContext.removeNamingListener

Вычеркните из списка слушателя события именования так, чтобы последующие события, предназначенные для того слушателя, не были поставлены.

Context.rename

Выполните LDAP, изменяют работу DN, чтобы переименовать запись. Если LDAPv2 используется тогда, новое имя и старое название должны совместно использовать то же самое имя непосредственного родителя. Если родители не равны, тогда бросают InvalidNameException.
Отметьте эффект java.naming.ldap.deleteRDN свойства на поведении этого метода.

DirContext.search

Выполните работу поиска LDAP согласно указанным поисковым средствам управления.
Если список требуемых атрибутов является нулем или содержит специальный идентификатор атрибута '*' тогда, все пользовательские атрибуты при записи LDAP возвращаются. Если операционные атрибуты требуются тогда, те идентификаторы атрибута должны присутствовать в списке требуемых атрибутов.
Если объекты требуют быть возвращенными, то Java связанные с объектом атрибуты (RFC 2713) требуют в дополнение к любому, которого требует пользователь API. Если эти атрибуты присутствуют тогда, они используются, чтобы собрать исходные объекты (см. Объекты Java). Если объект не может быть восстановлен согласно RFC 2713, тогда возвращают объект DirContext представление записи LDAP. Провайдер должен использовать метод DirectoryManager.getObjectInstance, чтобы удовлетворить звонки в метод Binding.getObject.
Имена, которые возвращаются, или относительно именованного контекста, или они - LDAP или URL LDAPS.
Провайдер может использовать LDAP, сравнивают работу вместо поиска LDAP, когда поисковый предоставленный фильтр соответственно ограничивается:
 

• Фильтр должен иметь форму "(<attributeID>=<value>)"
• Контекст должен быть объектным контекстом
• Нулевые атрибуты нужно требовать (пустой список атрибутов возврата)

В формах поиска, которые принимают строковый фильтр как параметр, синтаксис фильтра следует за RFC 2254 за исключением того, что символы Unicode также позволяются. Использование символов Unicode предпочтительно для использования закодированных октетов UTF-8. Поставщик услуг ответственен за преобразование символов Unicode в их соответствующее представление UTF-8 для передачи к серверу. Например, альфа греческой буквы может быть определена в строковом фильтре или как "\u03B1" или как "\\CE\\B1".

В форме search(Name, Attributes) и связанные методы, параметр Attributes преобразовывается в строковый фильтр, создавая соединительное выражение из его элементов. Каждое значение атрибута обрабатывается как литерал; поэтому '*' и другие специальные символы, определенные в RFC 2254, которые появляются в значениях атрибута, должен быть оставлен согласно правилам в RFC 2254. Например, значение атрибута '*' должно быть закодировано как строка "\\2a".

В форме search(Name, String filterExpr, Object[] filterArgs) и его перегруженный метод String, "{цифровое}" расширение делается в фильтре, включая значения от filterArgs. Каждый" {цифровой}" компонент может появиться вместо "attr" или "значения" в Разделе 4 от RFC 2254.

Объекты в filterArgs должны быть закодированы следующим образом:
 

• байтовые массивы (byte[]) кодируются, кодируя каждый байт строкой согласно RFC 2254. Например, массив {0, 1, 10, 100} кодируется как строка "\\00\\01\\0a\\64".
• Строки обрабатываются как литералы. Другими словами, '*' и другие специальные символы, определенные в RFC 2254, которые появляются в строке, оставляются согласно правилам в RFC 2254. Например, строка "*" кодируется как строка "\\2a".
• Объекты, которые не являются ни String, ни byte[], преобразовываются в их строковую форму, используя Object.toString() и затем правила для примененного String.

LdapContext.setRequestControls

Установите средства управления запросом для операций LDAP, впоследствии вызванных на этот контекст.

EventContext.targetMustExist

Определите, может ли слушатель зарегистрировать интерес к записи LDAP, которая не существует.

Context.unbind

Выполните LDAP, удаляют работу, чтобы удалить именованную запись. Именованная запись должна быть листовой записью; поддеревья не удаляются. Если листовая запись не существует (но ее родители существуют), работа все еще успешно выполняется.

11. Федерация

12. SASL

API SASL Java зависит от Службы Аутентификации и авторизации Java (JAAS), который оказывает поддержку обратного вызова для механизмов SASL, которые должны получить или предоставить пользователя/информацию по применению непосредственно.

12.1 Конфигурация SASL

Некоторые механизмы SASL требуют идентификационных данных аутентифицируемого объекта. Это известно как ID аутентификации. Некоторые механизмы SASL, как ОБЗОР-MD5, требуют использования пароля и/или области. По умолчанию провайдер предоставляет значение свойства java.naming.security.principal как ID аутентификации к любому механизму SASL, который требует ID аутентификации, значения свойства java.naming.security.credentials как пароль, и значение свойства java.naming.security.sasl.realm как область. Чтобы переопределить эти значения по умолчанию, используйте свойство java.naming.security.sasl.callback.

Механизмы SASL поддерживают понятие идентификационных данных авторизации или ID авторизации, который является объектом, к которому сервер должен предоставить доступ, если аутентификация успешно выполняется. Если свойство java.naming.security.sasl.authorizationId было установлено, то его значение используется в качестве ID авторизации. Иначе, пустая строка используется в качестве ID авторизации, который направляет сервер, чтобы получить ID авторизации из учетных данных аутентификации клиента.

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

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

Например, если приложение нуждается в конфиденциальности, оно может сделать так при использовании вызова, такого как:

    env.put("javax.security.sasl.qop", "auth-conf");

прежде, чем передать env начальному конструктору контекста. См. Java API SASL для деталей об этих свойствах.

12.2 Драйверы Механизма SASL

13. Расширения и Средства управления

Несколько расширений LDAP и средств управления определяются IETF LDAPEXT рабочая группа.

"Запускаются, TLS" расширение ("1.3.6.1.4.1.1466.20037") поддерживается классами StartTlsResponse и StartTlsRequest. Провайдер LDAP должен обеспечить конкретную реализацию абстрактного класса StartTlsResponse и сделать его реализацию доступной для провайдера LDAP. См. описание в StartTlsRequest.createExtendedResponse. Как правило, реализация StartTlsResponse нуждалась бы в доступе к структурам данных провайдера LDAP.

Поставщик услуг LDAP должен выполнить проверку имени хоста после того, как Начинают переговоры TLS как определено в RFC 2830. Если бы сервер LDAP был обнаружен автоматически при использовании информации в DNS (как описано в разделе URL), то провайдер должен использовать доменное имя, полученное из отличительного имени как имя хоста, чтобы проверить, как рекомендующийся draft-ietf-ldapext-locate-08.txt.

14. Уведомление о событии

Приложение JNDI может зарегистрироваться для событий, которые происходят в каталоге, таком как дополнение или удаление записи, или модификация записи. Приложения могут также зарегистрироваться для незапрашиваемых уведомлений.

15. SSL

Провайдер поддерживает SSL согласно Расширению Защищенного сокета Java (JSSE) спецификация. SSL активируется, устанавливая свойство среды java.naming.security.protocol следующим образом:

env.put(Context.SECURITY_PROTOCOL,
"ssl");

Если кроме того аутентификация LDAP также требуется тогда java.naming.security.authentication, java.naming.security.principal, и свойства среды java.naming.security.credentials должны быть установлены, как соответствующие. Если аутентификация LDAP требуется, и учетные данные SSL должны быть снова использованы для аутентификации LDAP тогда набор свойство среды java.naming.security.authentication, чтобы выбрать ВНЕШНИЙ механизм SASL, следующим образом:

       env.put(Context.SECURITY_AUTHENTICATION, "EXTERNAL");
 

---

Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Свяжитесь с Нами