- 3 minutes to read

LDAP Test Client

The Nodinite LDAP Adapter for Microsoft BizTalk Server package includes a complimentary Windows forms-based test client that developers can use to test the solutions before event developing, and/or installing them into the BizTalk Server environment. This client can also be used by administrators who wishes to validate the installation of the LDAP adapter and also test connectivity.

  • Test connectivity
  • Execute Requests
  • Receive and view responses
  • Transform responses using XSLT
    Client

Connectivity

The following connectivity options exist in the tool:

Not specified

If you do not provide any connection credentials the tools uses the currently logged on account

Leave the Custom Connection checkbox un-checked to use the currently logged on users credentials for the operations:
Custom Connection not checked
Here's an example of an Unchecked Custom Connection.

Custom Connection

You can specify the credentials to use connecting to the target LDAP Service.
Custom Connection

How to enable LDAP signing in Windows Server

Important

Make sure to run as secure as you possibly can!

Tip

You can significantly improve the security of a directory server by configuring the server to reject Simple Authentication and Security Layer (SASL) LDAP binds that do not request signing (integrity verification), or to reject LDAP simple binds that are performed on a clear text (non-SSL/TLS-encrypted) connection.

Please review the How to enable LDAP signing in Windows Server user guide

SSO

From within the SSO tab, you can test your SSO configuration by specifying the name of the SSO Application to test. Use the SSO App text box (not case sensitive):

Click the ‘Test SSO’ button to get the connection information from the SSO Store.

Note

If successful, the values are presented on the screen in the messagebox.

If you don’t have enough privileges and/or the SSO application does not exist you will face an exception dialogue with information about the exception condition.

Error example:

  1. Start the Windows Forms Application (IS.BizTalk.Adapters.LDAP.Windows.ClientTestUtility_v1_0.exe)
  2. Use a generic command (copy and paste) to determine if your node has the binaries and connectivity for a successful usage in BizTalk Server.

    Note

    You may have to change the Configuration file for the Windows Forms client as you did in the configuration chapter.

Sample query : This query should return an xml message with a list of all the domains in your forest. This particular query requires the server must be be joined/part of a Windows Active Directory domain. If you do not have this type ov environment then please run some other command.

<ns0:LDAPxmlns: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 there is a SSO app name provided it is used by the queries within the tool. Clear this textbox to use the other options.

10.1.3 Custom connection The other custom connection option provides the ability to specify details in the textboxes. Check the ‘Custom Connetion’ checkbox to use this connection option (NOTE: SSO is used anyway if a value has been entered).

Troubleshooting

No/Invalid license

If you did not provide a valid license in the IS.BizTalk.Adapters.LDAP.Windows.ClientTestUtility_v1_0.exe.config file, you will get the following exception message when you launch the client:

Bad License
Here's an example of bad and/or missing license information

Next Step

Nodinite LDAP Web API