build 980262fe | content blog-content@c8490fa · 338 posts | profiles 20 · corpus 208 | 0 skipped |
How-To · 2024-12-11

Securing the Horizon connection – part 2

Part 1 covered how locked.properties secures the connection between Horizon Connection Servers and clients, mainly through balancedHost. There are cases where that causes trouble.

2024-12-11Date
Raphael ThommenAuthor
2Min read
305words
no translation reviewed
Topics capabilities · idf weight Modern Workplace modern-workplace 2.20 Virtualization virtualization 1.59
Vendors vendors · idf weight Omnissa omnissa 2.76 VMware vmware 0.91

In the first part of this series I described how configuring locked.properties helps secure the connection between the Horizon Connection Servers and the clients and agents, mainly through the balancedHost parameter. Part 1 is here.

There are scenarios where that method causes trouble. This post looks at an alternative configuration and weighs it up.

The problem: no access to the Horizon admin console over the load-balanced DNS name

Even with the configuration in place, the Horizon admin console may be unreachable over the load-balanced DNS record, for example vdi.soultec.lab. This happens in particular when balancedHost is set in the configuration and the load balancer distributes traffic incorrectly.

Missing or incorrect configuration can cause this:

  • The administrator sees “Login Failed”, “404 Not Found” or “The page you requested is not available” when signing in to the console on the load balancer URL with /admin

The alternative: several portalHost entries

One way round it is to list every relevant URL explicitly as a portalHost in locked.properties. That includes:

  1. The load-balanced DNS record (for example vdi.soultec.lab).
  2. The individual Horizon Connection Servers (for example labhrzcs01.soultec.lab and labhrzcs02.soultec.lab).
  3. Any further hosts, such as Unified Access Gateways (UAGs).

Example configuration:

portalHost.1=vdi.soultec.lab
portalHost.2=labhrzcs01.soultec.lab
portalHost.3=labhrzcs02.soultec.lab

locked.properties lives at:
C:\Program Files\VMware\VMware View\Server\sslgateway\conf\locked.properties

This configuration covers every possible connection, which keeps access problems to a minimum.

Worth knowing

  • Every portalHost entry has to match the servers’ DNS names exactly.
  • Test the connection after every change.

Conclusion

Using portalHost entries is a flexible way to solve access problems on the Horizon admin console, particularly in environments with load balancers. It does mean checking the configuration regularly and making sure every relevant host is listed in locked.properties.

If you have further questions on this or need a hand, get in touch through our website.

You might also like