Configure LDAP advanced actions

Lightweight Directory Access Protocol (LDAP) is a vendor-neutral protocol for managing and accessing network resources, such as authentication servers or directory-based devices like printers. LDAP advanced actions in NeoLoad allow performance testers to connect to an LDAP server and test performing lookups.

For the integration's requirements, check out this table:

Requirements Description
Maturity NeoLoad doesn't support it
License BSD Simplified (opens in new tab)
NeoLoad version Compatible from version 6.5.1
Requirements NeoLoad Enterprise and Professional editions with Integration & Advanced Usage
Bundled with NeoLoad Yes
Download Binaries You can find them in our support hub (opens in new tab)

Before you start

Before you set up the LDAP advanced actions, follow these steps:

  1. Download the latest advanced action .jar file from the latest release (opens in new tab).

  2. Add the .jar file to the extlib folder of your NeoLoad project directory.

  3. Reopen your NeoLoad project to load the new action.

Use LDAP advanced actions

NeoLoad includes these LDAP advanced actions:

  • LdapConnect

  • LdapLookup

  • LdapDisconnect

LdapConnect

The LdapConnect action establishes a connection to an LDAP server.

Before you establish an LDAPS connection, make sure the LDAP server’s SSL certificate is imported into NeoLoad’s JRE keystore. You can do this using the keytool -importcert command, which allows Java to trust the server and establish a secure connection during the bind process. For example:

Copy 
 keytool -importcert -alias ldap_rf -file "C:\Users\Admin\Desktop\CertificateProject.cer" -keystore "C:\Program Files (x86)\NeoLoad 2025.3\jre\lib\security\cacerts" 
 

To authenticate and start the communication with an LDAP server, enter the following parameters:

ParameterFunction
connectionName (mandatory)Identifies the LDAP connection configuration.
ldapServer (mandatory)Specifies the LDAP server to connect to.
ldapUsername (optional)Defines the name of the user account used to authenticate with the LDAP server. If you leave ldapUsername and ldapPassword empty, you'll establish an anonymous connection.
ldapPassword (optional)Defines the password for the LDAP user account. If you leave ldapUsername and ldapPassword empty, you'll establish an anonymous connection.

LdapLookup

The LdapLookup action performs a lookup on the LDAP server. To query accounts or other directory resources, enter the following parameters:

ParameterFunction
connectionName (mandatory)

Specifies the connection configuration and links it to the connection established in the ldapConnect step.

ldapSearchBase (mandatory)Defines the starting point (base DN) in the directory for the search.
searchFilter (mandatory)Defines the criteria used to find entries in the directory.
serviceType (mandatory)Defines which directory type the lookup targets. For example, LDAP or AD.

LdapDisconnect

The ldapDisconnect action closes the connection to the server that you established in the ldapConnect step.

To close the connection, enter the connectionName parameter. It specifies which connection to close.

Change log

Version 0.0.6 (March 30, 2026)

  • Added the LdapDisconnect action.

  • Added an option to establish an anonymous connection.

Version 0.0.1 (April 1, 2022)

  • Initial release with account lookup functionality.