How to customize the vRealize Automation login page

After my twitter feed went berserk after William Lam published his blog post about “How to customize the new vSphere 6.0 Web Client login UI“. I wondered if the same thing could be achieved for the vRealize Automation (vRA) SSO login page and while I was at it add a “disclaimer” to the login page, due to a question from a customer. Here is the result :

Before :

vRA-Branding-before

After :

vRealize Automation login page

So what do you think? My Cloudy Tenant login page looks a little bit different then before right? Who doesn’t want to log in here? 🙂

OK you want to know how I did this? Let me show you.

Disclaimer !! These modifications are not supported by VMware, and after updates or changes to the vCenter & Identity Appliances the logon page could switch back to default.

I found a cool blog post from Fabio Rapposelli about “Customize the tenant SSO login page“. He describes how you can brand the SSO login page per tenant by changing the vmwSTSBrandName property inside the SSO LDAP tree. For this he uses a LDAP browser to change the property, but I didn’t have the possibility at this time to use an external LDAP browser so I looked for other options. And suddenly I thought of the default LDAP modify tool that is shipped with the vCenter and Identity appliances, and yes it did the trick. Game on!

Where you have to make the changes depends on if you used the Identity Appliance or vCenter Appliance for the vRealize Automation SSO.

vCenter Appliance as SSO for vRA

Upload a background image with for example WinSCP to the following directory
/usr/lib/vmware-sso/webapps/websso/resources/img. In my example I used a jpg image named “cloudy-background.jpg” and changed the image file name in the code beneath.

To change the VMware logo in the top left corner of the login page change or replace the following file /usr/lib/vmware-sso/webapps/websso/resources/img/vmwareLogoBigger.png. In my example I did not replace the file but used a jpg image named “cloudy-logo.jpg” with 100×100 dimensions and changed the image file name in the code beneath.

Logon to the vCenter Appliance through SSH and create the file /tmp/changevrabranding which we are going to fill with the necessary information and that we are going to feed to the LDAP modify tool.

Add the following content to the file : /tmp/changevrabranding

Save and close the file and run the following CLI and fill in the SSO password :

Refresh the vRA SSO login page and voila!

Identity appliance as SSO for vRA

If you are using the Identity Appliance as SSO for vRA, you will have to do almost the same as for the vCenter Appliance. The only difference is that the LDAP port is different and the Identity Appliance uses another directory for the images than the vCenter Appliance.

Upload a background image with for example WinSCP to the following directory
/usr/lib/vmware-sts/webapps/websso/resources/img. In my example I used a jpg image named “cloudy-background.jpg” and changed the image file name in the code beneath.

To change the VMware logo in the top left corner of the login page change or replace the following file /usr/lib/vmware-sts/webapps/websso/resources/img/vmwareLogoBigger.png. In my example I did not replace the file but used a jpg image named “cloudy-logo.jpg” with 100×100 dimensions and changed the image file name in the code beneath.

Logon to the vCenter Appliance through SSH and create the file /tmp/changevrabranding which we are going to fill with the necessary information and that we are going to feed to the LDAP modify tool.

Add the following content to the file : /tmp/changevrabranding

Save and close the file and run the following command from the CLI and fill in the SSO password:

Refresh the vRA SSO login page and voila!

Marco van Baggum

Marco van Baggum

Marco is a Staff Consulting Architect at VMware. Want to learn more about Marco? Check out Marco's About page.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.