Installing the Nodinite LDAP Web API

This guide teaches how to install the Nodinite 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\:
C:\Program Files\Nodinite\LDAP Web API

Unblock the files, powershell example below (replace folder as required):

Get-ChildItem -Path 'C:\Program Files\Nodinite\LDAP Web API\' -Recurse | Unblock-File

Step 2: Create IIS Application Pool

Use the Internet Information Server (IIS) Manager.

inetmgr.msc

1. Create a new Application Pool.
   

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

   Make sure to select No Managed Code

3. The App Pool must be configured with a named account, and this account must have read/write rights to the folder with the binaries. Optionallyt, the named account is added to the IIS_IUSRS group, and the file access rights are set on this group instead.

4. Start a cmd-prompt as this user, this process creates a profile that is required by the new password protection scheme.

Step 3: Create IIS Virtual Directory

1. Add a new Virtual Directory:
   

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

3. Convert the virtual directory to an Application
   

4. Select the Application pool you created in step 2
   

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)

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

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

• JSON - application/json
• XML - text/xml, application/xml

• JSON
• 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>