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.
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.
2 Navigate to the Assignments Window
- In the navigation bar, select Assign.
- In the Assignments window, select New.
3 Select Customization Option
- In the New Assignment window, click Select.
4 Provide an Assignment Name
- 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. - In the lower right, click Next.
5 Define URL Patterns to be Intercepted
- 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, enterhttp://.*
- Examples include:
https://www.vmware.*
,www.vmware.com
,*vmware.com
, and so on.
- To specify that all URLs be redirected for all schemes, enter the star symbol (
- On your keyboard, press Enter after each entry to save it and add multiple URL patterns.
- Enter as many additional URL patterns as you want.
6 Define the Search Rules
- 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
ormailto
, 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.
-
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
- In the lower right, click Next.
7 Start the Active Directory Search
- In the Users tab of the New Customization Assignment window, click the Active Directory Search field to begin.
8 Search for User Groups
- In the search hit list, select as many users or groups as you want to include.
- On your keyboard, press Enter to save your selections.
9 Select User Groups
- When you have selected all the users or groups that you want to include, click Next.
10 Review the Summary
- Review the Summary window.
- In the lower right, click Submit.