- 0 minutes to read

Prerequisites for the Nodinite LDAP Adapter for Microsoft BizTalk Server

Prepare your Microsoft BizTalk Server environment for seamless LDAP integration with the Nodinite LDAP Adapter. This page covers BizTalk-specific requirements including supported versions, Visual Studio setup, and installation permissions.

✅ BizTalk Server 2010-2020 supported with appropriate Visual Studio versions
✅ MSDTC two-phase commit protocol support for future transaction capabilities
✅ Clear installation account requirements (BizTalk Administrators and SSO Administrators)
✅ Host instance restart planning to minimize runtime disruption

This page describes the BizTalk-specific prerequisites for installing and running the Nodinite LDAP Adapter for Microsoft BizTalk Server

Tip

For shared prerequisites including firewall settings, user rights, and LDAP catalog requirements, see the LDAP Web API Prerequisites page.

graph LR subgraph "Microsoft BizTalk Server" ro2(fal:fa-users Nodinite LDAP Adapter) end subgraph "LDAP Services" ro2 -.- roAD(fab:fa-windows Active Directory) ro2 -.- roDIRX(fal:fa-users DIRX) ro2 -.- roADAM(fas:fa-users ADAM/LDS) ro2 -.- roLDAP(far:fa-folder LDAP Service X) end

Visual overview: Nodinite LDAP Adapter connects BizTalk Server to multiple LDAP services, including Active Directory, DIRX, and ADAM/LDS.

Verified Topic
BizTalk Server Requirements
Visual Studio Requirements
MSDTC Transaction Support
Installation Account Permissions

Installation Considerations

The host instances associated with the LDAP adapter (associated send hosts) must be restarted after installation. This might temporarily disrupt your run-time, so always install during an announced, pre-approved service window.

Before installing the LDAP adapter, ensure:

  • The software is properly licensed

  • Microsoft BizTalk Server is installed and configured

  • The installation account is part of the BizTalk Administrators and SSO Administrators roles

  • You have planned for host instance restarts

  • You have planned for host instance restarts

BizTalk Server Requirements

Install the Nodinite LDAP Adapter for Microsoft BizTalk Server on all BizTalk Server nodes that process LDAP operations.

Supported Platforms

Product Versions
Windows Server Windows 2025, Windows 2022, Windows 2019, Windows 2016, Windows 2012 R2, Windows 2012, Windows 2008 R2
.NET Framework .NET Framework 4.0 or later (depends on your installed version of BizTalk)

General Requirements

  • Supports virtualized environments
  • Virus protection is supported; apply appropriate exclusions
  • FIPS can be enabled on Windows/BizTalk servers; license key uses FIPS-compliant algorithms
  • The adapter may log to the local event log and can generate many entries. Set event logs to overwrite (avoid fixed-size logs) to prevent data loss

Supported BizTalk Server Versions

  • Latest SP and CU recommended
  • All BizTalk Server editions supported (Developer, Standard, Enterprise, RFID, etc.)
  • Send hosts can be X86 and/or X64

Visual Studio Requirements

For developers creating BizTalk artifacts:

  • Visual Studio Professional 2010 or later with C# and the appropriate source control client

Use the following Visual Studio version for your BizTalk Server:

BizTalk Server Visual Studio
BizTalk 2020 2019
BizTalk 2016 2015
BizTalk 2013 R2 2013
BizTalk 2013 2012
BizTalk 2010 2010

MSDTC Transaction Support

The Adapter is built with Microsoft MSDTC and supports the two-phase commit protocol. While Active Directory does not currently support distributed transactions, the Adapter is ready to leverage this feature when available.

Review the MSDTC user guide for additional information.

Installation Account Permissions

The user account used for installation must be part of:

  • BizTalk Administrators role
  • SSO Administrators role

These permissions are required to:

  • Register the adapter in the BizTalk Server configuration
  • Install assemblies into the Global Assembly Cache (GAC)
  • Configure Enterprise SSO settings

Shared Prerequisites

The following prerequisites are shared with the LDAP Web API. See the LDAP Web API Prerequisites page for detailed information:

Credential Management

The Nodinite LDAP Adapter for Microsoft BizTalk Server offers flexible credential options (in priority order):

  1. Context properties - Dynamically set at runtime (overrides send port settings)
  2. SSO Application - Enterprise SSO for password-free deployments
  3. Send port configuration - Explicitly set in the transport properties
  4. Host Instance service account - Defaults if not set (requires domain-joined server for Active Directory)

See the Configuration guide for detailed setup instructions.

Frequently asked questions

Find solutions to common problems and explore the Nodinite LDAP Adapter for Microsoft BizTalk Server FAQ in the Troubleshooting user guide.

Next Step

Install

LDAP Web API Prerequisites
Firewall Settings
Configuration
SSL/LDAPS Configuration