Referrals use LDAP URLs to redirect a client application’s request to another server.
LDAP URLs have a specific format, described in RFC 4516 and require that all special characters be properly escaped and any spaces indicated as "%20". LDAP URLs have the following syntax.
- Indicates the type of LDAP connection to the PingDirectory server. If the server
connects over a standard, non-encrypted connection, then LDAP is used. If it connects
over SSL, then LDAPS is used. Note:
Any search request initiated by means of an LDAP URL is anonymous by default unless an LDAP client provides authentication.
- Specifies the host name or IP address of the PingDirectory server.
- Specifies the port number of the PingDirectory server. If no port number is provided, the default LDAP port (389) or LDAPS port (636) is used.
- Specifies the distinguished name (DN) of an entry in the directory information tree (DIT). The PingDirectory server uses the base DN as the starting point entry for its searches. If no base DN is provided, the search begins at the root of the DIT.
- Specifies those attributes for which the PingDirectory server should search and return. You can indicate more than one attribute by providing a comma-separated list of attributes. If no attributes are provided, the search returns all attributes.
- Specifies the scope of the search, which could be one of the following:
- Only searches the specified base DN entry.
- Only search one level below the specified base DN.
- Searches the base entry and all entries below the specified base DN.
- Specifies the search filter to apply to entries within the scope of the search. If
no filter is provided, the server uses