G: Assigning Customizations

G: Assigning Customizations

G1: About Customizations

You can configure assign settings to customize your end users' environments. One type of customization is URL redirection. You define URL handling rules so the Horizon Client redirects URLs from the end user's client machine to a desktop or application that is provided by your Horizon Cloud environment.

When the user logs in to their local Horizon Client, it fetches the user's assigned URL redirection rules. When the user clicks a link that matches a URL pattern rule, Horizon Client selects the handler that you configured, to process the link. Depending upon the circumstances, the process can vary:

  • If the handler specifies that a desktop be used, the desktop's default application for the link's specified protocol processes the URL.
  • If the handler specifies that an application be used, the assigned application processes the URL.
  • If the user is not entitled to the desktop or application specified in the handler, Horizon Client displays a message to the user (unless you set Strict Match to No.
  • If Strict Match is set to No, Horizon Client locates a resource to use, based on the following fall-back behavior:
    1. The system searches the user's assignments using a substring match of the target resource specified for the handler. If the system finds an assignment that matches the substring, that assigned desktop or application is used to open the link.
    2. When the Resource Type is set toApplication, if the search for a substring match fails, the system searches the user's application assignments for an assigned application that can handle the protocol specified in the Scheme field.
    3. Note: This applies only if the Resource Type is set to Applications. If the Resource Type is set to Desktops, this step is skipped.
    4. If the system cannot locate a resource that can handle the protocol, Horizon Client displays a message to the user.

Note: The Customization window is provided for you to configure client-to-agent URL redirection. For configuring agent-to-client URL redirection, you use a different procedure. For more information about agent-to-client URL redirection, see Configuring Agent-to-Client Redirection.

G2: Adding Redirection Customization

You can customize your end users' environments by making URL redirection assignments. You do this by configuring the client-to-agent URL redirection rules that tell the Horizon Client to redirect URLs from the end user's client machine to a desktop or application within your Horizon Cloud environment.

G2.1 Verify Prerequisites are Met

Verify that the following prerequisites must be met:

  • The user's Horizon Client must be installed with the URL_FILTERING_ENABLED=1 option so the client can handle URL redirection. For more information, see the Installing Horizon Client for Windows with the URL Content Redirection Feature topic in the VMware Horizon 7 documentation.
  • The Horizon agent in the base image used by the farm was installed using the URL_FILTERING_ENABLED=1 parameter on the command line.
  • Your Horizon Cloud inventory has the desktops and remote applications that you intend to use in the configuration.
  • If the customization has Strict Match set to Yes, assignments must exist that entitle the specific desktops and remote applications to the end users specified in the customization.

 

G2.2 Navigate to the Assignments Window

  1. In the navigation bar, select Assign.
  2. In the Assignments window, select New.

G2.3 Select Customization Option

  • In the New Assignment window, click Select.

G2.4 Provide an Assignment Name

  1. In the Definition tab of the New Customization Assignment window, enter an Assignment Name.
    Note: Provide a unique name to help you distinguish this URL redirection customization assignment from others in the system. It must start with a letter, and contains only letters, dashes, and numbers.
  2. In the lower right, click Next.

G2.5 Define URL Patterns to be Intercepted

  1. In the Configuration tab of the New Customization Assignment window, define the URL patterns to be intercepted.
    Note: In your URL patterns, you can use the following special characters:
    • To specify that all URLs be redirected for all schemes, enter the star symbol (*).
    • To specify that all http URLs be redirected, enter http://.*
    • Examples include: https://www.vmware.*, www.vmware.com, *vmware.com, and so on.
  2. On your keyboard, press Enter after each entry to save it and add multiple URL patterns.
  3. Enter as many additional URL patterns as you want.

G2.6 Define the Search Rules

  1. Under Rules, provide the following information:
    • Scheme: Enter the URL scheme type for the URL pattern you entered earlier. This specifies which schemes to consider when matching any scheme-less URL patterns defined earlier. For example, if there is any content for the URL patterns specified that uses or matches the http protocol, it is redirected.
    • Resource Type: Select one of the following options from the pop-up menu to indicate where the URL content should be redirected:
      • Desktop: The system searches the user's assignments, and if it finds a match, the desktop is used to open the link.
      • Application: The system searches the user's assignments, and if it finds a match, the application is used to open the link. If the search fails, the system searches for an application that can handle the protocol in the scheme.
    • Target Resource: Enter a target source for the type you selected. For example, an application or assignment name, or http or mailto, and so on.
    • Strict Match: Indicate whether to search for a strict match or a next best match:
      • Yes: Select Yes to search the Resource Type for the exact match to the Target Resource. For example, if Chrome is entered but the user is not entitled to use it, a message is displayed to the user.
      • No: Select No to search the Resource Type for the next best match to the Target Resource. For example, if Chrome is entered but is not installed on the desktop, a default browser is used.
  2. In the lower right, click Next.

G2.7 Start the Active Directory Search

  • In the Users tab of the New Customization Assignment window, click the Active Directory Search field to begin.

G2.8 Search for User Groups

  1. In the search hit list, select as many users or groups as you want to include.
  2. On your keyboard, press Enter to save your selections.

G2.9 Select User Groups

  • When you have selected all the users or groups that you want to include, click Next.

G2.10 Review the Summary

  1. Review the Summary window.
  2. In the lower right, click Submit.