Q100067: [Connections] Active Directory

The Active Directory Connection is a definition which tells a module, how to connect to and communicate an Active Directory user account. Connections can either be entered directly into the parameter in the module, or can be managed through the global connections tool. If you will be using the same connection in different modules, it is much easier to manage the connection information by creating a single global connection. Whether you use a locally defined value in each Active Directory module, or use the global definitions for your Active Directory modules, the format of the connection value is the same for both.

If you use the global connection manager, you will see that as soon as you create a new entry, it will provide you a template for starting your Active Directory Connection. It would look like the example below.

Domain=<domainname>;Username=<username>;Password=<password>

Here we see that there are multiple values specified in this single parameter. Each value is a single name-value pair. You should notice that each of the name-value entries consists of a name on one side, followed by an equals sign (=), followed by the value, and finally terminated by a semicolon. Thus if we breakdown the example above, the list of name-value pairs might appear a little more legible if we look at them this way.

Domain=<domainname>;
Username=<username>;
Password=<password>

Formatted this way, it is much easier to read. The name is on the left of the equals sign, while the value is on the right. Where each value is, you would edit it to use the value which is specific for your installation. In the template, the value on the right side would be replaced by the setting specific for the Active Directoy Connection you are configuring. In the example below, we have configured what a real connection might look like.

Domain=MyCorp;Username=MyAdUsername;Password=MyAdPassword