- 3 minutes to read

LDAP Test Client

The Nodinite LDAP Adapter for Microsoft BizTalk Server package includes a powerful, complimentary Windows forms-based Test Client. This tool empowers developers and administrators to validate solutions, test connectivity, and troubleshoot configurations—before deploying to your BizTalk Server environment.

✅ Instantly test LDAP connectivity and SSO configuration
✅ Execute and transform LDAP requests with XSLT
✅ Troubleshoot installation and licensing issues quickly

  • Test connectivity
  • Execute Requests
  • Receive and view responses
  • Transform responses using XSLT
    Client
    The Test Client provides a user-friendly interface for validating LDAP operations and responses.

Connectivity

The Test Client offers flexible connectivity options to match your environment:

Not specified

If you do not provide any connection credentials, the tool uses the currently logged-on account.

Leave the Custom Connection checkbox unchecked to use the current user's credentials for all operations:
Custom Connection not checked
Unchecked Custom Connection uses the logged-on user's credentials.

Custom Connection

You can specify credentials to connect to the target LDAP Service.
Custom Connection
Custom Connection allows you to test with specific credentials for different LDAP environments.

How to enable LDAP signing in Windows Server

Important

Always run as securely as possible!

Tip

You can significantly improve directory server security by configuring it to reject unsigned SASL LDAP binds or simple binds over non-SSL/TLS connections.

Review the How to enable LDAP signing in Windows Server user guide

SSO

Within the SSO tab, you can test your SSO configuration by specifying the SSO Application name (not case sensitive). Click the 'Test SSO' button to retrieve connection information from the SSO Store.

Note

If successful, the values are displayed in a message box. If you lack privileges or the SSO application does not exist, an exception dialog provides details.

Error example:

  1. Start the Windows Forms Application (IS.BizTalk.Adapters.LDAP.Windows.ClientTestUtility_v1_0.exe)
  2. Use a generic command to verify binaries and connectivity for BizTalk Server.

    Note

    You may need to update the Configuration file for the client as described in the configuration chapter.

Sample query: This query returns an XML message listing all domains in your forest. The server must be joined to a Windows Active Directory domain. If not, use another command.

<ns0:LDAP xmlns:ns0="http://IntegrationSoftware.se/BizTalk/Adapter/LDAP/Operations/1.0">
    <Batches guid="2B25B9E6-4AF2-4094-9AE7-E1E4C99B6C8D">
        <Batch transactionScopeOption="Required" guid="2B25B9E6-4AF2-4094-9AE7-E1E4C99B6C8D">
            <AD>
                <Operations>
                    <GetDomainsInForest/>
                </Operations>
            </AD>
        </Batch>
    </Batches>
 </ns0:LDAP>

If you provide an SSO app name, the tool uses it for queries. Clear the textbox to use other options.

Custom connection: Check the ‘Custom Connection’ checkbox to specify details in the textboxes. (Note: SSO is used if a value is entered.)

Troubleshooting

No/Invalid license

If you do not provide a valid license in the IS.BizTalk.Adapters.LDAP.Windows.ClientTestUtility_v1_0.exe.config file, you will see the following exception message when launching the client:
Bad License
Example of missing or invalid license information.

Next Step

Nodinite LDAP Web API