Does ActiveADAPTER support SSL connections to Active Directory?

ActiveADAPTER allows you to use SSL for Active Directory communications if your Active Directory infrastructure is configured to support it (refer to your Microsoft documentation on how to enable SSL).

To use SSL with ActiveADAPTER, you must specify a server or domain name in your WhereToBind or container value and add your SSL port (normally 636). For example, to target the domain via SSL on server testDC1 you might use:


It is also possible to use a domain name for serverless binding if your SSL configuration supports it. For example:


Important notes

Do not use “LDAPS” in your strings. This is a convention not used in Microsoft’s Active Directory implementation and may cause an exception.

Note that using SSL may increase load on your Active Directory infrastructure. Our recommendation is to only use SSL where a clear business case exists.

If SSL is critical to your Active Directory solution, always perform an audit of your Active Directory configuration and inspect network traffic to confirm encryption before production use.

Will the ActiveADAPTER Send Adapter return error information back to my orchestration?

Yes. The adapter will return any exceptions back to your application AFTER any retries you have configured have been done.

Within your orchestration you can use Scope shapes to catch exceptions. In your exception handlers you can retrieve the error description to determine which way to branch.

Sample orchestrations that illustrate exception handing are included in the ActiveADAPTER Samples folder.

See the entire answer

I have purchased an ActiveADAPTER license. How do I swap out the evaluation version for the licensed version?

To uninstall your evaluation version and replace it with your licensed version follow this procedure:

1. Stop any BizTalk applications and host instances that use ActiveADAPTER

2. Close any instances of the BizTalk Admin Console

3. Uninstall ActiveADAPTER through Control Panel

4. Check that the %ProgramFiles%\ActiveADAPTER folder has been  completely removed

5. Install your licensed software

In most cases this shouldn't affect any receive location or send port settings you have created, but check your BizTalk applications after restarting them.

See the entire answer

What will ActiveADAPTER add to what I see in BizTalk Server?

After installing ActiveADAPTER you will see a new transport type option when configuring a send port or receive location. With BizTalk send ports, you can create, delete, rename, move, and modify Active Directory objects. With BizTalk receive locations, you can draw XML messages into BizTalk containing Active Directory query results.

On your Programs menu you will also have an ActiveADAPTER program group containing shortcuts to documentation, sample orchestrations and schemas to get you developing your solutions quickly.

See the entire answer