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

Document ID : KB000117812
Last Modified Date : 24/10/2018
Show Technical Document Details
Question:
Is it possible to configure the LDAP service in my Agile Central on-premises appliance to populate the first name, last name and display name fields in the user profile for Agile Central?
Answer:
Yes, it is possible to configure the Agile Central 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 Agile Central services in the control panel