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 test.com domain via SSL on server testDC1 you might use:

LDAP://testDC1:636/OU=Accounting,DC=test,DC=com

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

LDAP://test.com:636/OU=Accounting,DC=test,DC=com

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.

FAQs
Can the Active Directory Receive Adapter help me build an orchestration that listens for changes to Active Directory?

Yes. The ON CHANGE ONLY option on the Active Directory Receive Adapter provides this feature. A message is submitted to your BizTalk application only when the results of the query you have specified change. This feature provides a great way to trigger orchestrations and keep information in your Enterprise Applications synchronized.

There is also a REAL-TIME mode that gets events from Active Directory asynchronously and submits them to BizTalk  as they happen.

See the entire answer

What is ActiveADAPTER?

ActiveADAPTER is a set of BizTalk adapters for working with Active Directory from BizTalk Server. We offer you:

  • A BizTalk Send Adapter that you can use to:
    • Create, move and delete Active Directory objects
    • Change object properties such as email addresses, office locations, home folder locations...
    • Set user passwords and add objects to security groups
  • A BizTalk Receive Adapter that you can use to query Active Directory and receive the results in an XML message into BizTalk Server
  • The input and output schemas for all ActiveADAPTER operations
  • Sample orchestrations and example XML input
  • Complete documentation

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