- 3 minutes to read

Installing the Nodinite LDAP Web API

In this section, you will learn how to install the LDAP Web API.

Before you begin

Make sure you comply with the prerequisites.

Step 1: Unzip package

The Nodinite LDAP Web API has no installer (MSI). Unzip the package to the target folder, for example:
C:\Program Files\Nodinite\LDAP Web API

Unzip Folder

Step 2: Create IIS Application Pool

Use the Internet Information Server (IIS) Manager.

inetmgr.msc
  1. Create a new Application Pool.
    Add

  2. Name the App Pool, for Example Nodinite LDAP Web API
    App Pool

    Make sure to select No Managed Code

Step 3: Create IIS Virtual Directory

  1. Add a new Virtual Directory:
    Create Virtual Directory

  2. Name the Virtual Directory and set the Physical path to the folder where you extracted the ZIP package in step 1
    Name

  3. Convert the virtual directory to an Application
    Convert

  4. Select the Application pool you created in step 2
    Assign App Pool

Step 4: Configure Connections

Before you can use the Nodinite LDAP Web API, you must perform the initial Configuration

Step 5: Perform a basic test

You can now test the Nodinite LDAP Web API. There is a plethora of methods in the Samples folder.

  1. Navigate to http://localhost/LDAPAdapter/swagger/ (replace LDAPAdapter according to the name you set in step 3b) or even better if you use HTTPS, https://REPLACEME/swagger/ (review the 'How to perform hardening on your Nodinite LDAP Web API' user guide)

Swagger

  1. Set the connectionId. This Id is set in the Configuration, Step 4
  2. Execute statement
    GetDomainControllers

NOTE Make sure to set the content type according to your statement to either:

  • JSON - application/json
  • XML - text/xml, application/xml
{
  "RequestId": "b7a211d7-20f3-44bc-b078-7f1b6e1c047f",
  "Batches": [
    {
      "continueOnError": false,
      "guid": "2b25b9e6-4af2-4094-9ae7-e1e4c99b6c8d",
      "AD": {
            "Operations": {
            "GetDomainControllers": {}
        }
      },      
    }
  ],
}
<ns0:LDAP xmlns:ns0="http://integrationsoftware.se/BizTalk/Adapters/LDAP/Request/1.0">
  <Batches guid="2B25B9E6-4AF2-4094-9AE7-E1E4C99B6C8D" returnResponseMessageOnExceptions ="true">
    <Batch guid="3B25B9E6-4AF2-4094-9AE7-E1E4C99B6C8E">      
       <AD>          
          <Operations>
            <GetDomainControllers/>
          </Operations>
        </AD>
    </Batch>    
  </Batches>
</ns0:LDAP>

Sample statement that is easy to use for testing connectivity with Active Directory. This example usually does not require admin rights and uses the default port (389)


Support

Contact our Support for additional guidance if you fail to resolve the installation problem.

Note: There may be additional information written to the Windows Event logs

Frequently asked questions

Common problems and FAQ for the Nodinite LDAP Web API can be found in the troubleshooting page.


Next step

Configuration
Update

Prerequisites
Uninstall