• Support
• Documentation
• BuildMaster
• Security, Auditing, and Compliance
• Security
• LDAP Configuration

LDAP Configuration

BuildMaster can use any existing LDAP infrastructure. This guide will help you get the system set up.

Add LDAP Users to BuildMaster

Before switching BuildMaster over to LDAP authentication, you must first configure which LDAP users or groups will have permission to use BuildMaster. First, click on the Privileges link under Security & Permissions on the BuildMaster Administration Page.

You will be presented with a list of Principals currently recognized by BuildMaster. Click the directory filter and set it to show LDAP Principals:

Next, click the Add Privilege button and the Add Privilege dialog will be displayed. To ensure that you will be able to access BuildMaster after switching it over to LDAP, you may want to add your current LDAP user account and assign the BuildMaster role (BuildMaster is essentially an administrator):

After clicking the Save button, your LDAP user account/group should now be listed as a Principal in BuildMaster. You are now ready to switch the directory provider over to LDAP.

Configure IIS

To integrate with Active Directory, BuildMaster's web site in IIS must be configured to use Windows Authentication and to disable Anonymous Authentication. Upon installation, a BuildMaster web site will be created in IIS. To configure Windows Authentication on this site, follow the appropriate guide:

• For IIS 7 - [External Link]
• For IIS 6 - [External Link]

Enabling LDAP Integration

Click the Directory link under Integration Configuration on the BuildMaster Administration Page. Now, select LDAP from the Directory Provider drop-down:

Now just click Save Changes and BuildMaster will start using LDAP.

Troubleshooting

If you have set LDAP as your directory provider in BuildMaster and can no longer access it, you can go back to integrated authentication in one of two ways:

The easiest way is to use the BuildMaster Admin Tool, located in the "Service" subdirectory of the BuildMaster installation directory. Simply run the "BuildMaster.Configuration.AdminTool.exe" tool from the server that hosts the BuildMaster application and you can switch the directory provider.

You may also switch the provider by executing the following script against the BuildMaster database (for example, using SQL Server Management Studio):

USE BuildMasterUPDATE [Configuration]    
SET [Value_Text] = '1'    
WHERE [Scope_Name] = 'CoreEx'    
AND [Key_Name] = 'DirectoryProvider'

This will make BuildMaster accessible again, allowing you to correct the configuration.