Citrix States:

Summary

This article describes how to specify a domain and optionally hide the domain field on the Desktop Appliance Connector Web Interface site for XenDesktop 2.0.

Requirements

You should be running XenDesktop 2.0. This document assumes that you have configured your XenDesktop environment and have a Citrix desktop appliance that uses the Desktop Appliance site for user authentication.

Background

XenDesktop 2.0 includes support for Citrix desktop appliances. These appliances connect into a special Desktop Appliance Connector Web Interface site that is created during the installation of the XenDesktop Desktop Delivery Controller.

Due to the special nature of this site, the ability to configure it through the Access Management Console Web Interface snap-in is not provided. The site comes preconfigured with the local Desktop Delivery Controller acting as the XML Broker to provide enumeration of any desktop groups.

By default, users who access the Desktop Appliance Connector site are presented with a logon form such as the one below:

This requires the end users to enter in their user names, passwords, and domains. In some environments, the users might not know their domain name or remember to type it in. This may generate unnecessary support calls to the help desk when users are unable to log on.

A solution to this issue would be to pre-populate the domain name and optionally, hide it from being displayed on the Desktop Appliance Connector logon page. This would normally be performed through the Access Management Console. As the Desktop Appliance Connector site is not intended to be modified easily, you must manually edit some files to achieve a logon page with the hidden domain field as shown below.

The procedure below can be used as a guide to modifying the relevant files so that this change can be implemented in your Desktop Appliance Connector site.

Procedure

1. Install XenDesktop 2.0 and configure it as needed (for example, create relevant desktop groups for user access).

2. Locate the lidpage.js file for the Desktop Appliance Web Interface site. Example file location: c:\inetpub\wwwroot\Citrix\DesktopAppliance\html\clientScripts\lidpage.js

3. Open the file in a text editor and locate the following section of code within the clearAllFields() function:

    $("#un").attr("value","");
    $("#pw").attr("value","");
    $("#dm").attr("value","");
    setDisabled($("#dm"), false);

4. Modify the #dm line (which is line 376 by default) so it reads as follows:

    $("#dm").attr("value","domain");

Where domain is the domain name you wish to authenticate your users against (for example, win2003ad).

5. Save the file.

This will now populate the domain name field with the specified domain when users access the Desktop Appliance Connector site. If you wish to also hide the domain field, complete the following procedure:

1. Locate the lidLogin.inc file for the DesktopAppliance Web Interface site. Example file location: c:\inetpub\wwwroot\Citrix\DesktopAppliance\app_data\include\lidLogin.inc

2. Open the file in a text editor and locate the following section of code:

        <tr>
          <td class="smallText">
             <span><%=wiContext.getString("Domain")%></span>
          </td>
          <td>
            <input title="<%=wiContext.getString("Domain")%>" tabindex="3" id="dm"
                   type="text" value="" maxlength="256" />
          </td>
        </tr>

Modify the section so it reads as follows (changes are in bold):

        <tr>
          <td class="smallText">
<!--             <span><%=wiContext.getString("Domain")%></span>  -->
          </td>
          <td>
            <input title="<%=wiContext.getString("Domain")%>" tabindex="3" id="dm"
                   type="hidden" 
value="" maxlength="256" />
          </td>
        </tr>

The changes are as follows:

Line 36 – Comment this line out so the "Domain" text is not shown.

Line 40 – Change the type attribute from text to hidden so that the field is not shown on the page.

3. Save the file.

4. Run the iisreset command or restart Internet Information Services (IIS) manually using the IIS Manager program or through the Services Microsoft Management Console (MMC) snap-in. This is required so that the lidLogin.inc page is updated within the IIS cache.

Users should now only be required to enter a user name and password when logging on to the Desktop Appliance Connector site.

Note: If you have multiple domain names, the procedure above does not work as it only populates a single domain name. Additional customizations in the files mentioned above might achieve this functionality.

More Information

CTX117567 – How to Install Web Interface on a Standalone Web Server

CTX117425 – How to Apply Customizations to Multiple Web Interface Sites