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
Name the App Pool, for Example
Nodinite LDAP Web API
Make sure to select
No Managed Code
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.
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
Name the Virtual Directory and set the Physical path to the folder where you extracted the ZIP package in step 1
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.
- 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)
- Set the
connectionId
. This Id is set in the Configuration, Step 4 - Execute statement
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: Additional information to aid the troubleshooting may exist in the Windows Event Logs.
Frequently asked
Additional solutions to common problems and the FAQ for the Nodinite LDAP Web API exist in the Troubleshooting user guide.
Next step
Related
Table of content