Appendix C. LDAP URLs
496
Component
Description
cn,mail,telephoneNumber
. If no attributes
are specified in the URL, all attributes are
returned.
scope
The scope of the search, which can be one of
these values:
base
retrieves information only about the
distinguished name (
base_dn
) specified in the
URL.
one
retrieves information about entries one
level below the distinguished name (
base_dn
)
specified in the URL. The base entry is not
included in this scope.
sub
retrieves information about entries at all
levels below the distinguished name (
base_dn
)
specified in the URL. The base entry is included
in this scope.
If no scope is specified, the server performs a
base
search.
filter
Search filter to apply to entries within
the specified scope of the search. If no
filter is specified, the server uses the filter
(objectClass=*)
.
Table C.1. LDAP URL Components
The attributes, scope, and filter components are identified by their positions in the URL. Even if no
attributes are specified, the question marks still must be included to delimit that field.
For example, to specify a subtree search starting from
dc=example,dc=com
that returns all attributes
for entries matching
(sn=Jensen)
, use the following LDAP URL:
ldap://ldap.example.com/dc=example,dc=com??sub?(sn=Jensen)
The two consecutive question marks,
??
, indicate that no attributes have been specified. Since no
specific attributes are identified in the URL, all attributes are returned in the search.
C.2. Escaping Unsafe Characters
Any
unsafe
characters in the URL need to be escaped, or substituted with a special sequence of
characters.
For example, a space is an unsafe character that must be represented as
%20
within the URL. Thus,
the distinguished name
o=example.com corporation
must be encoded as
o=example.com
%20corporation
.
The following table lists the characters that are considered unsafe within URLs and provides the
associated escape characters to use in place of the unsafe character:
Unsafe Character
Escape Characters
space
%20
Содержание DIRECTORY SERVER 8.0
Страница 18: ...xviii ...
Страница 29: ...Configuring the Directory Manager 11 6 Enter the new password and confirm it 7 Click Save ...
Страница 30: ...12 ...
Страница 112: ...94 ...
Страница 128: ...110 ...
Страница 190: ...Chapter 6 Managing Access Control 172 4 Click New to open the Access Control Editor ...
Страница 224: ...206 ...
Страница 324: ...306 ...
Страница 334: ...316 ...
Страница 358: ...340 ...
Страница 410: ...392 ...
Страница 420: ...402 ...
Страница 444: ...426 ...
Страница 454: ...436 ...
Страница 464: ...446 ...
Страница 484: ...466 ...
Страница 512: ...494 ...
Страница 522: ...504 ...