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 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.

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 automatically redirects from HTTP to HTTPS, the URL Content Redirection feature will work 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

Become familiar with vdmutil command-line interface options and requirements and verify that you have sufficient privileges to run the the vdmutil command. See Using the vdmutil Command-Line Utility.

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 application. You must include the protocol prefix. 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 redirected to the remote desktop or application. If you type .* (dot star), all URLs are redirected to the remote desktop or 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 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.