Secure Mobile Access 12.4 Administration Guide

Adding Graphical Terminal Shortcuts to Individual Hosts

This section describes how to configure a graphical terminal shortcut to an individual Windows Terminal Services or Citrix host. For information about configuring graphical terminal shortcuts to Citrix server farms, see Adding Graphical Terminal Shortcuts to Server Farms.

To add a graphical terminal shortcut to an individual host

  1. In the AMC, navigate to User Access > WorkPlace.

  2. Click on the Shortcuts tab.

  3. Click the + (New) icon.

  4. Select Graphical terminal shortcut from the dropdown list. The Add Graphical Terminal Shortcut page displays.

  5. In the Position field, specify the position of the shortcut in the list.

  6. In the Resource drop-down menu, select the host or IP address resource to which this shortcut will be linked. This menu contains the available defined resources. (URL and Network share resources do not appear because they cannot have graphical terminal shortcuts associated with them.)

  7. Enter the hyperlink that users will click to access the resource and (optionally) a description of the link that will appear next to it. These entries can include variables:

    1. In the Link text field, type the text for the hyperlink users will see. For example, if the resource you selected was the Windows domain for users’ home directories, enter Home directory. Using a variable you can have the link be followed by the actual path: click {variable}, and then select {URL_REF_VALUE} from the list. Click Insert to add the variable to the link text, and then close the list by clicking {variable} again.
    2. In the Description field, type a descriptive comment about the shortcut. Although optional, a description helps users understand what the resource is. You can, for example, use a variable to be specific about the user’s identity. Here’s a sample entry for Description, followed by the explanatory text the user (in this case LGeorge) sees in WorkPlace:

      {Session.userName}’s user directory —> LGeorge’s user directory

  8. Click Finish to save the shortcut with the current settings, or click Next to display additional configuration settings. The Advanced tab of the Add Graphical Terminal Shortcut page displays.

  9. Under Session type, specify the type of session to initiate:

    • Click Windows Terminal Services to initiate a connection to a Windows Terminal Services host. In the Port field, type the port number for the Windows Terminal Services connection. Select the Automatically reconnect if session is interrupted checkbox for seamless reconnection attempts.

    • Click Citrix to initiate a connection to an individual Citrix host. In the Port field, type the port number for the connection. Optionally, you can specify a Custom ICA file by typing its path or clicking Browse to locate it. Custom ICA files contain additional configuration settings for the Citrix host.

  10. Under Single sign-on, specify how you want user credentials forwarded to the host. Forwarding user credentials prevents the user from needing to log in multiple times (once to get to the appliance, and again to access the host).

    • Click None to disable single sign-on and instead prompt the user for credentials.

    • Click Forward user’s session credentials to pass the username and password for authentication in WorkPlace along to the host.

    • Click Forward static credentials to forward the same username and password for all users. Type the static Username, Password, and Domain to be forwarded for all users.

  11. Specify Startup options if you want to automatically start an application when users click the graphical terminal shortcut.

    • In the Start application field, type the path to the application.

    • If the application requires a working directory, type its path in the Working directory box.

  12. Specify Display properties:

    • In the Screen resolution drop-down menu, select the appropriate resolution for the application. The default resolution is 1024 x 768 pixels. To set a custom resolution, select Custom..., and then type the desired pixel values (width x height) into the fields that appear to the right. The minimum supported resolution is 640x480 and the maximum is 4096x2048 pixels.

    • For Terminal Services shortcuts, select the Allow users to select a different resolution checkbox to give users control over their screen resolution. Users will be able to select their own resolution from a list box on the shortcut itself in Workplace. This checkbox is disabled for Citrix shortcuts.

    • In the Color depth list, select the color depth. The default setting is Lowest (8-bit).

      Higher color depth settings can affect performance.

  13. Specify Resource redirection settings as needed:

    • Select the Allow access to local drives checkbox to enable users to access local drives during the session.

    • Select the Allow access to local printers checkbox to enable users to access local printers during the session.

    • Select the Bring remote audio to local computer checkbox to enable users to access remote audio during the session. Note that audio redirection is network intensive and can affect performance. The default is off.

    • Select the Share clipboard between local and remote computers checkbox to enable clipboard copy/paste in both directions for the user. The default is to allow this feature.

  14. Click Finish.

  • Enabling single sign-on for shortcuts to Citrix hosts causes users’ authentication credentials to be forwarded to the client, which can potentially compromise security.

  • The Java open-source version of the Windows Terminal Services agent does not support any Resource redirection options.

  • Enabling clipboard sharing is not appropriate for shortcut that provides read-only access to applications and sets of data.

Was This Article Helpful?

Help us to improve our support portal

Techdocs Article Helpful form

Techdocs Article NOT Helpful form

  • Still can't find what you're looking for? Try our knowledge base or ask our community for more help.