Rally On-premises: Can first and last name get auto filled at the time a new user is added in via LDAP?

Products

• Rally On-Premise
• Rally SaaS

Issue/Introduction

Is it possible to configure the LDAP service in my Rally on-premises appliance to populate the first name, last name and display name fields in the user profile?

Environment

Release:
Component: ACPREM

Resolution

Yes, it is possible to configure the Rally appliance to populate the Rally first name, last name and display name fields in the user profile.

Prerequisites

• root access to your Agile Central on-premises appliance
• The LDAP attribute names for the fields you are capturing

 

Root Access

In order to acquire root access please review the article on Requesting and updating the root password
 

LDAP Attributes

The specific LDAP attributes may vary from LDAP vendor to LDAP vendor.  In general Microsoft Windows Active directory will use the following attributes:

• givenName
• sn
• displayName

It is always best to check with your LDAP administrator to be certain you have the correct attributes. 
 

Procedure

1. ssh into the on-premises appliance using the root password set above

2. Edit the following file using your preferred Linux text editor (vi, nano, etc)

/var/www/html/controlpanel/actionfiles/ldap/default-rally-ldap.xml

3. Locate the line that reads: 

<!--Enter LDAP attribute name between each tag. Only used if provisioning new users in Rally -->

4. Below that line, populate the LDAP attribute names gathered above between their corresponding <RallyFirstName>, <RallyLastName>, <RallyDisplayName> tags.  For example:

  <RallyFirstName>givenName</RallyFirstName>
  <RallyLastName>sn</RallyLastName>
  <RallyDisplayName>displayname</RallyDisplayName>

 

5. Save the file
6. Edit the following file using your preferred Linux text editor:

/opt/RallyOnPrem/web/var/www/html/controlpanel/actionfiles/ldap/LdapServiceConnector.php

7. Change line 34 to remove references to RallyFirstName, RallyLastName and RallyDisplayName as shown below:

Before:

var $_ldapblanks = array('RallyFirstName','RallyLastName','RallyDisplayName','LdapEncryptedPassword','RallyEncryptedPassword','RunInterval'); 

After:

var $_ldapblanks = array('LdapEncryptedPassword','RallyEncryptedPassword','RunInterval'); 

8. Save the file

9. Restart the Rally services in the control panel