Use these configurations in Horizon Cloud to define URL handling rules where the Horizon Client redirects URLs from the end user's client machine to a desktop or application provided by your Horizon Cloud environment. A URL redirection configuration gives the Horizon Client information about which URLs should be handled by one of the end user's assigned Horizon Cloud desktops or applications instead of being opened by the user's local system.

Note: The Horizon Cloud Administration Console provides a user interface for you to configure client-to-agent URL redirection. To configure agent-to-client URL redirection, you must use group policy settings as described in Configuring Agent-to-Client Redirection. The steps below are for configuring client-to-agent URL redirection.

The Horizon Client fetches an end user's assigned URL redirection configurations when the user logs in to the Horizon Client on their local device. Then when that user attempts to open a link in a local document or file and the link matches a URL pattern rule in the configuration, Horizon Client determines the appropriate handler to use. The handlers are specified opens the user's assigned desktop or application to handle the URL link, as determined by the appropriate handler you specified in the URL redirection configuration. If the URL redirection handler specifies to use a desktop, the desktop's default application for the link's specified protocol processes the URL. If the handler specifies to use an application, the user's 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 have specified Strict Match as No for the handler.

In the scenario where Strict Match is set to No, the system locates a resource to use based on this 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 handler's Resource Type is set to Application, 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 handler's Scheme field.
    Note: This step in the fall-back behavior only applies for applications. If the Resource Type is set to Desktops, this step is skipped.
  3. If the system cannot locate a resource in the user's assignments that can handle the protocol, Horizon Client displays a message to the user.
Important: The user's Horizon Client must be installed with the URL_FILTERING_ENABLED=1 option to give the client the capability to handle the URL redirection feature. For details, see the Installing Horizon Client for Windows with the URL Content Redirection Feature topic in the VMware Horizon 7 documentation.

When your environment is integrated with VMware Identity Manager™, the user must have opened at least one application using Horizon Client before the URL redirection feature can work for that user. By opening at least one application using the Open in Client option, the user's assigned URL redirection configuration is loaded into the client device's registry where Horizon Client can get the configuration values.

A user can be assigned more than one URL redirection configuration, where those configurations have the Active toggle set to Yes. To avoid potential conflicts between rules from different configurations, when the user logs in to Horizon Client, the system:

  • Sets only one configuration in effect, even when that user has more than one active assigned configuration.
  • Uses the URL redirection configuration that is alphabetically first as the configuration in effect for the user.


Verify that you have met the following prerequisites before using the Administration Console to create a URL redirection configurations:

  • 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 session desktops and remote applications that you intend to use in the configuration.


  1. On the Assignments page, click URL Redirection.
    The New URL Redirection Configuration wizard opens to its first step.
  2. In the Definition step's General Settings section, configure the general settings and then scroll to the Rules section.
    Option Description
    Name Enter a friendly name for this configuration.
    Active Select Yes to make this configuration active.
    Description Optionally enter a description for the configuration.
  3. In the Rules section, create a list of URL patterns that this configuration will tell Horizon Client to intercept on the client system.
    1. In the URL Pattern field, type a quoted string that specifies the URL matching pattern to be intercepted.
      You must include the protocol prefix, like https://. You can use wildcards to specify a URL pattern that matches multiple URLs.

      For example:

      • If you type "http://google.*", all URLs that include the text google are intercepted.
      • If you type .* (period asterisk), all URLs are intercepted (matches all).
      • If you type "mailto://.*" all URLs that contain the text mailto://.* are intercepted.
    2. Click Add to add the URL pattern to the list of rules.
    1. Repeat the steps to add more URL matching patterns.
  4. Click Next to proceed to the next wizard step.
  5. On the Configuration step, define the set of handlers that determine which target inventory resource should handle various protocols.
    A handler defines which of the user's entitled desktops or applications should handle that specific protocol. For example, if the user opens a Microsoft Word document that has a mailto hypertext link and the user clicks on that link in the document, the handler defines what entitled application should handle the request, such as Microsoft Outlook or Mozilla Thunderbird.
    1. Click New.
    2. In the handler window, configure the settings and click Save.
      Option Description
      Name Enter a name for the handler.
      Scheme Enter the protocol to which this handler applies, such as http, https, mailto, callto, and so on.
      Resource Type Select whether a desktop or application is to handle the specified protocol.
      Target Resource Enter the name of the target resource in your Horizon Cloud inventory that you want handling the protocol specified in the Scheme field.
      Strict Match Select Yes to force an exact match between the name specified in the Target Resource field and the names of the user's available entitled session desktops or remote applications.

      Select No if you want the system to use its fall-back behavior to support the situation where an end user does not have an assignment for a resource with the exact name specified in the Target Resource field.

      For example, when the Resource Type is set to Applications and you specify Microsoft Outlook as the target resource to handle the mailto protocol, but the user does not have an assignment for any Microsoft Outlook applications, when Strict Match is set to No, the system will search for a compatible application assigned to that user to handle the mailto protocol, such as Mozilla Thunderbird.

    3. Repeat the steps to add more handlers.
  6. Click Next to proceed to the next wizard step.
  7. Search for and select the users and groups for this URL redirection assignment and click Next.
  8. Review the summarized information and click Submit.