1.9 LDAP URLs

LDAP URLs provide a uniform method to access information on an LDAP server. Defined in RFC 2255, LDAP URLs begin with the prefix LDAP:// or LDAPS://. The following provides the syntax and descriptions of an LDAP URL.

ldap[s]://<hostname>:<port>/<base_dn>?<attributes>?<scope>?<filter>?<extension>

Note that ldaps is a common enhancement used to denote SSL, and is not defined in an RFC.

Table 1-8 Field descriptions for an LDAP URL

URL Element

Default Value

Description

hostname

none

DNS name or IP address of the LDAP server.

port

389

Port of the LDAP server.

base_dn

root

Base DN for the LDAP operation.

attributes

all attributes

A comma delimited list of attributes to return.

scope

base

Search scope.

filter

(objectClass=*)

Search filter.

extension

none

LDAP extended operations.

NOTE:An attribute list is required if you want to provide a scope (even if the attribute list is blank). To return all attributes within a specific scope you must include <base_dn>??<scope>.