Red Hat Directory Server 8.0 Administrator's Guide

ldap://hostname:portnumber/[optional_dn]
optional_dn is the explicit DN for the server to return to the requesting client application. For
example, this LDAP URL references John Doe's entry:
ldap://directory.example.com:389/cn=john
doe,o=people,l=europe,dc=example,dc=com
For the server to use the DN from the original search request instead, enter the LDAP URL in
the format:
ldap://hostname:portnumber/
Clicking Construct opens a wizard to direct the process of adding a referral.
6. To allow a referral to be followed with different authentication, click Authentication, and
specify the appropriate DN and password. Keep in mind that this authentication remains valid
only until the Console is closed; then it's reset to the same authentication used to log into the
Console.
7. The Smart Referral List lists the referrals currently in place for the selected entry. The entire
list of referrals is returned to client applications in response to a request with the Return
Referrals for All Operations or Return Referrals for Update Operations options in the
Suffix Settings tab, which is available under the Configuration tab.
To modify the list, click Edit to edit the selected referral or Delete to delete the selected
referral.
8. Click OK.
4.3.2. Creating Smart Referrals from the Command Line
Use the ldapmodify command-line utility
1
to create smart referrals from the command-line.
To create a smart referral, create the relevant directory entry, and add the referral object
class. This object class allows a single attribute, ref. The ref attribute must contain an LDAP
URL.
For example, add the following to return a smart referral for an existing entry, uid=jdoe:
dn: uid=jdoe,ou=people,dc=example,dc=com
objectclass: referral
ref:
ldap://directory.europe.example.com/cn=john%20doe,ou=people,l=europe,dc=example,dc=com
Creating Smart Referrals
109