Skip to main content

Table of Contents

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


Only available versions of this content are shown in the dropdown

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 Environment Naming Name 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>
Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us