Skip to main content

August 24, 2026

Change the Port Number for HTTP Redirection to Omnissa Horizon Connection Server

If you replace the default port 443 on a Horizon Connection Server, and you want to allow HTTP redirection for Omnissa Horizon Clients that attempt to connect to port 80, you must configure the locked.properties file on the Horizon Connection Server.

Note: This procedure has no effect if you off-load SSL to an intermediate device. With SSL off-loading in place, the HTTP port on the Horizon Connection Server provides service to clients.

Prerequisites

Verify that you changed the default port number from 443. If you use the default values that are configured during installation, you do not have to perform this procedure to preserve the HTTP redirection rule.

Procedure

  1. Create or edit the locked.properties file in the gateway configuration folder on the Horizon Connection Server computer.

    For example: install_directory\Omnissa\Horizon\Server\sslgateway\conf\locked.properties

    The properties in the locked.properties file are case sensitive.

  2. Add the following lines to the locked.properties file:

    frontMappingHttpDisabled.1=1:/admin*:missing
    frontMappingHttpDisabled.2=1:/dct*:missing
    frontMappingHttpDisabled.3=1:/rest*:missing
    frontMappingHttpDisabled.4=1:/view-vlsi*:missing
    frontMappingHttpDisabled.5=3:/error/*:file:docroot
    frontMappingHttpDisabled.6=5:*:moved:https::port
    
    

    In the preceding lines, the variable port is the port number to which the client should connect.

    If you do not add the last of the lines above, redirection will continue to port 443. The other lines are necessary to block management traffic on the non-SSL web server instance, while still serving error pages.

  3. Restart the Horizon Connection Server service to make your changes take effect.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…