Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Using JNDI to specify an LDAP server when using an authentication service

Updated on March 15, 2022

You can set up an authentication service to override or extend the default Pega Platform™ authentication process. You can enter a Java Naming and Directory Interface (JNDI) entry, which represents a directory located on the LDAP server. Using JNDI enables you relocate servers without having to reconfigure the application.

The JNDI syntax is dependent upon the server environment.

Using a JNDI entry with WebSphere

Enter the name used for the JNDI lookup. This value matches the value entered as the Provider URL in the authentication server instance. For example, enter pega/ldapURL.

To define the JNDI entry, do the following:

  1. Use the WebSphere administrative console and navigate to EnvironmentNamingName Space Bindings.
  2. Specify the Binding identifier. For example, pega
  3. Specify the Name in name space. This value matches the value entered as the Directory in the authentication service instance. For example, pega/ldapURL
  4. Specify the String value, which is the actual URL of the directory. For example, ldap://serverx:384

Using a JNDI entry with Tomcat

Enter the full JNDI reference that corresponds to the environment entry specified in the deployment descriptor and the prefix java:com/env. For example, enter java:com/env/pega/ldapURL

Here is an example of an environment entry:

  <description><![CDATA[Generic LDAP URL entry]]> </description>

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us