If you have a Cloud Pod Architecture environment, you can create a global URL content redirection setting that redirects specific URLs to open on a remote desktop or published application in any pod in the pod federation.

About this task

A global URL content redirection setting is visible across the pod federation. When you create a global URL content redirection setting, you can redirect URLs to global resources, such as global desktop entitlements and global application entitlements.

You can configure any number of protocols, including HTTP, HTTPS, mailto, and callto. The callto protocol is not supported for redirection with the Chrome browser.

As a best practice, configure the same redirection settings for the HTTP and HTTPS protocols. That way, if a user types a partial URL into Internet Explorer, such as mycompany.com, and that site redirects from HTTP to HTTPS automatically, the URL Content Redirection feature works as expected. In this example, if you set a rule for HTTPS, but do not set the same redirection setting for HTTP, the partial URL that the user types is not redirected.

For complete information about configuring and managing a Cloud Pod Architecture environment, see the Administering Cloud Pod Architecture in Horizon 7 document.

To create a local URL content redirection setting, see Create a Local URL Content Redirection Setting.

Prerequisites

Procedure

  1. Log in to any Connection Server instance in the pod federation.
  2. Run the vdmutil command with the --createURLSetting option to create the URL content redirection setting.
    vdmutil --createURLSetting --urlSettingName value --urlRedirectionScope GLOBAL
    [--description value] [--urlScheme value] [--entitledApplication value | --entitledDesktop
    value] [--agentURLPattern value]

    Option

    Description

    --urlSettingName

    Unique name for the URL content redirection setting. The name can contain between 1 and 64 characters.

    --urlRedirectionScope

    Scope of the URL content redirection setting. Specify GLOBAL to make the setting visible across the pod federation.

    --description

    Description of the URL content redirection setting. The description can contain between 1 and 1024 characters.

    --urlScheme

    Protocol to which the URL content redirection setting applies, for example, http, https, mailto, or callto.

    --entitledApplication

    Display name of a global application entitlement to use to open the specified URLs.

    --entitledDesktop

    Display name of a global desktop entitlement to use to open the specified URLs, for example, GE-1.

    --agentURLPattern

    A quoted string that specifies the URL that should be opened on the remote desktop or published application.

  3. (Optional) Run the vdmutil command with the --updateURLSetting option to add more protocols, URLs, and global resources to the URL content redirection setting that you created.
    vdmutil --updateURLSetting --urlSettingName value --urlRedirectionScope GLOBAL
    [--description value][--urlScheme value][--entitledApplication value | --entitledDesktop
    value] [--agentURLPattern value]

    The options are the same as for the vdmutil command with the --createURLSetting option.

Configuring a Global URL Content Redirection Setting

The following example creates a global URL content redirection setting called Operations-Setting that redirects all client URLs that include the text http://google.* to the global application entitlement called GAE1.

vdmutil --createURLSetting --urlSettingName Operations-Setting --urlRedirectionScope GLOBAL 
--urlScheme http --entitledApplication GAE1 --agentURLPattern "http://google.*" --authAs johndoe 
--authDomain mydomain --authPassword secret

The following example updates the Operations-Setting setting to also redirect all URLs that contain the text https://google.* to the global application entitlement called GAE1.

vdmutil --updateURLSetting --urlSettingName Operations-Setting --urlRedirectionScope GLOBAL 
--urlScheme https --entitledApplication GAE1 --agentURLPattern "https://google.*" -authAs johndoe 
--authDomain mydomain --authPassword secret

The following example updates the Operations-Setting setting to redirect all URLs that contain the text "mailto://.*.mycompany.com" to the global application entitlement called GA2.

vdmutil --updateURLSetting --urlSettingName Operations-Setting --urlRedirectionScope GLOBAL
--urlScheme mailto --entitledApplication GAE2 --agentURLPattern "mailto://.*.mycompany.com" 
--authAs johndoe --authDomain mydomain --authPassword secret

What to do next

Assign the URL content redirection setting to a user or group. See Assign a URL Content Redirection Setting to a User or Group.