Background

Customizations allow Citrix customers to make web pages reflect company logos, color schemes, marketing styles, and sometimes, even security banners.  However, customizations require in-depth knowledge of the structure and coding behind each web site.

Some customers require that all levels of authentication (all logon pages) display security banners which outline the rights to privacy (or lack thereof) when accessing their sites.  In this case, a simple change to the web page code results in the addition of text – a security banner – near the authentication fields which is visible each time a user logs onto the site.

Some customizations are heavily documented – check out blogs like this one by Feng Huang – however, the addition of a security banner, or floating text, was not expressly discussed.

This article contains information about the customization of the logon page of StoreFront, Director, and Citrix License Server web pages.  Note that this is a basic banner configuration and changes to the specific size, font, and color can be made to fit custom requirements.

After working with members of the CCS team who have implemented various customizations in the past, we have consolidated our findings into a single reference point.  I would like to give a special thank you to Wonmin Lee, William Elvington, Steven Krueger, Dan Morgan, Felipe Bernal, and Kelsey Kempler for their help in the creation of this blog.  

Customizing the Logon Page for StoreFront Servers

This section explains how to customize the banner on Citrix StoreFront 2.x servers. The following configurations within the contrib folder will propagate the changes to all StoreFront servers.

  1. On a StoreFront server, navigate to C:/inetpub/wwwroot/Citrix/<StoreName>Web/contrib.
  2. Locate and create a copy of the custom.script file in the same location as backup – in the case that the changes need to be reverted, the copy can be used to replace the custom.script file to return to the original code.
    custom.script – Copy.js
     
  3. Open the custom.script file in Notepad (as Administrator).
  4. Enter the following text as shown and click Save:
    $(document).ready(function() {
    var $markup = $(‘<div id=”bottom”><p class=”_ctxstxt_BANNER”></p></div>’);
    $markup.insertAfter(‘#logonbelt-bottomshadow’);
    });

  5.  
    *Note that if copying and pasting code directly from this blog, the single and double quote symbols may not paste correctly and may require manually erasing and re-typing those symbols in Notepad. This applies to all code snippets throughout this blog.
     

  6. Locate and create a copy of the custom.style file in the same location as backup – in the case that the changes need to be reverted, the copy can be used to replace the custom.style file to return to the original code.
    custom.style – Copy.css

  7. Open the custom.style file in Notepad (as Administrator).
  8. Enter the following text as shown to add the CSS rules and click Save:
    #bottom p {
    text-align: center;
    color: white;
    }

  9. Locate and create a copy of the custom.wrstrings.en file in the same location as backup – in the case that the changes need to be reverted, the copy can be used to replace the custom.wrstrings.en file to return to the original code.
    custom.wrstrings.en – Copy.js
  10. Open the custom.wrstrings.en file in Notepad (as Administrator).
  11. Enter the following text as shown to add the custom string and click Save:
    BANNER: ‘CUSTOM BANNER TEXT HERE’

  12. Navigate to the StoreFront logon page, and the banner should be displayed below the authentication fields as shown:

Customizing the Logon Page for Director Servers

This section explains how to customize the banner on Citrix Director 7.x servers. The following configurations must be configured on each Director server that needs the customized banner.

  1. On each Director server, navigate to C:/inetpub/wwwroot/Director.
  2. Locate and create a copy of the LogOn.aspx file in the same location as backup– in the case that the changes need to be reverted, the copy can be used to replace the LogOn.aspx file to return to the original code.
    LogOn – Copy.aspx
  3. Open the LogOn.aspx file with Notepad (as Administrator).
  4. Find the following text, enter the bolded banner text as shown, and click Save:
    </asp:Table>
    <p style=”font-family:Segoe UI,Helvetica Neue,Helvetica,SefoeUI; margin:auto; width:1000px; color:white; text-align:center”>CUSTOM BANNER TEXT HERE</p>
    </div>

  5. Navigate to the Director logon page, and the banner should be displayed below the authentication fields as shown:
     

Customizing the Logon Page for Citrix License Servers

This section explains how to customize the banner on Citrix License Servers 11.x. The following configurations must be configured on each License Server that needs the customized banner.

  1. On each License Server, navigate to C:/Program Files (x86)/Citrix/Licensing/LS/web/strings/en.
  2. Create a copy of the default.xml file and move it to the C:/Program Files (x86)/Citrix/Licensing/LS/web/strings/ – note that the copy need only be saved in a different folder location, not necessarily the strings folder.  In the case that the changes need to be reverted, the copy can be used to replace the default.xml file to return to the original code.
    default – Copy.xml
  3. Open the default.xml file in Notepad (as Administrator).
  4. Find the following text and delete the bolded string:
    <s id=”IDS_ADMIN_LOGIN_MESSAGE”>You must login to the Administration area.  Click &lt;a href=”{href}”&gt;here&lt;/a&gt; to logon.</s>

  5. Enter the bolded banner text as shown and click Save:
    <s id=”IDS_ADMIN_LOGIN_MESSAGE”>CUSTOM BANNER TEXT HERE</s>

  6. Navigate to the License Server web page, click on the Administrators tab in the upper-right-hand corner and the banner should be displayed above and behind the authentication fields as shown:

Disclaimer:

The above mentioned sample code is provided to you as is with no representations, warranties or conditions of any kind. You may use, modify and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the sample code may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the sample code fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the sample code. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the code belongs to Citrix, any distribution of the code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.