VMware Horizon True SSO configuration - pt.1

horizon-saml-true-sso-setup-pt1-01

VMware Horizon True SSO configuration is used to eliminate the credential requests from Active Directory while accessing Horizon virtual desktops and published applications.

After the user login to VMware Horizon with an Identity Provider using UAG, with the True SSO (single sign-on) feature enabled the user is not prompted to enter the Active Directory credentials twice to use VDI or published apps.

UAGs can be configured to leverage SAML capability to enable the communication between Identity Providers (Azure for example) and Horizon using secure tokens with no need to share credentials. This security tokens are SSO certificates generated for each user by the CA and requested by the Horizon Enrollment Server. Bear in mind that SAML doesn't provide any password to Horizon.

horizon-saml-true-sso-setup-pt1-02

 

Blog series

VMware Horizon True SSO configuration - pt.1
VMware Horizon True SSO configuration - pt.2
VMware Horizon True SSO configuration - pt.3

 

Firewall ports for Horizon True SSO

The following ports must be open in the Firewall to allow the correct traffic flow.

  • TCP 443 - mainly used for the authentication traffic flow.
  • TCP 135 - used by the Enrollment Server for the initial communication with the CA then a random port from 1024 – 5000 and 49152 -65535.
  • TCP 32111 - used by the Connection Server to use the Enrollment Server.

horizon-saml-true-sso-setup-pt1-03

 

Install the Enrollment Server

To deploy the True SSO service, a VMware Horizon Enrollment Server must be installed on a Windows machine with at least 4 GB RAM.

The Enrollment Server is used to request a short-lived certificate on behalf of the user that is authenticating against Horizon. This certificate is what True SSO uses to avoid requesting the user to enter the credentials also for Active Directory.

At least one Enrollment Server must be installed to perform True SSO but it is recommended to have two servers for redundancy (active-passive cluster) and it cannot be installed on the same server as the Connection Server. The Enrollment Server can be installed in the same server as the CA and to optimize the performance it should be configured to prefer using the local CA.

To install the Enrollment Server you need a Windows Server VM and the same installer file used for the Connection Server.

horizon-saml-true-sso-setup-pt1-04

Run the installation wizard and click Next.

horizon-saml-true-sso-setup-pt1-05

Accept the EULA and click Next.

horizon-saml-true-sso-setup-pt1-06

Leave default Destination Folder and click Next.

horizon-saml-true-sso-setup-pt1-07

From the drop-down menu select Horizon Enrollment Server option and click Next.

horizon-saml-true-sso-setup-pt1-08

Select Configure Windows Firewall automatically and click Next.

horizon-saml-true-sso-setup-pt1-09

Click Install to proceed with the installation.

horizon-saml-true-sso-setup-pt1-10

The software is being installed.

horizon-saml-true-sso-setup-pt1-11

When the installation has been completed successfully, click Finish to exit the wizard.

horizon-saml-true-sso-setup-pt1-12

 

Setup a Certification Authority

If a CA is not available in your network, you must install the CA before going ahead with the procedure. The Certificate Authority must be an Enterprise CA type and can be installed on the same server as the Enrollment Server.

 

Install the CA

Login to a Windows-based machine and from the Server Manager click the Add roles and features link to install the Certification Authority role. Since the installation procedure is straightforward (just click Next), only the key steps are shown.

horizon-saml-true-sso-setup-pt1-13

Select Active Directory Certificate Services role and click Next.

horizon-saml-true-sso-setup-pt1-14

For True SSO purposes, you only need to select Certification Authority option as Role Services.

horizon-saml-true-sso-setup-pt1-15

During the configuration wizard procedure, make sure to specify the CA as Enterprise CA.

horizon-saml-true-sso-setup-pt1-16

If you don't have any CA installed in your infrastructure, select Root CA as CA type to install.

horizon-saml-true-sso-setup-pt1-17

 

Configure CA in the same server

If the CA is installed on the same server as the Enrollment Server, run regedit in the Enrollment Server and navigate to HKLM\Software\VMware, Inc.\VMware VDM. Right click VMware VDM and select New > Key.

horizon-saml-true-sso-setup-pt1-18

For the new key enter the name Enrollment Service. Then right click the new created key and select New > String Value to create a new String (REG_SZ).

horizon-saml-true-sso-setup-pt1-19

Specify PreferLocalCa as key name then right click the created key and select Modify. Enter TRUE in the Value Data field and click OK to save the configuration.

horizon-saml-true-sso-setup-pt1-20

 

Configure the Certificate Authority

Once the Certification Authority has been installed, open the Command Prompt and run the following command to configure the CA for non-persistent certificate processing.

C:\> certutil -setreg DBFlags +DBFLAGS_ENABLEVOLATILEREQUESTS

horizon-saml-true-sso-setup-pt1-21

Then run the following command to ignore offline CRL (certificate revocation list) errors on the CA:

C:\> certutil -setreg ca\CRLFlags +CRLF_REVCHECK_IGNORE_OFFLINE

horizon-saml-true-sso-setup-pt1-22

Restart the service.

C:\> sc stop certsvc
C:\> sc start certsvc

horizon-saml-true-sso-setup-pt1-23

 

Configure the Certificate Template

Open the the Certification Authority and right click the Certificate Templates folder. Select Manage option.

horizon-saml-true-sso-setup-pt1-24

From the list, right click the Smartcard Logon template and select Duplicate Template.

horizon-saml-true-sso-setup-pt1-25

In the duplicated template, configure the following:

 

Compatibility

  • Select Windows Server 2008 R2 from the Certification Authority drop-down menu.

horizon-saml-true-sso-setup-pt1-26

  • Click OK to confirm.

horizon-saml-true-sso-setup-pt1-27

  • Select Windows 7 / Server 2008 R2 from the Certificate Recipient drop-down menu.

horizon-saml-true-sso-setup-pt1-28

  • Click OK to confirm.

horizon-saml-true-sso-setup-pt1-29

 

General

  • Specify a Template display name.
  • Set 1 day for the Validity period and 18 hours for the Renewal period.

horizon-saml-true-sso-setup-pt1-30

 

Request Handling

  • Select Signature and smartcard logon in the Purpose field.
  • Enable the option For automatic renewal of smart card certificates, use the existing key if a new key cannot be created.

horizon-saml-true-sso-setup-pt1-31

 

Cryptography

  • Select Key Storage Provider as Provider Category.

horizon-saml-true-sso-setup-pt1-32

 

Server

  • Enable the Do not store certificates and requests in the CA database option.
  • Uncheck Do not include revocation information in issued certificates option.

horizon-saml-true-sso-setup-pt1-33

 

Issuance Requirements

  • Check the This number of authorized signatures option and enter 1.
  • Select Application policy option from the drop-down menu Policy type required in signature.
  • Select Certificate Request Agent option from the drop-down menu Application policy.
  • Select Valid existing certificate option.

horizon-saml-true-sso-setup-pt1-34

 

Security

  • Click Add button and add the Enrollment Server previously created.
  • Select the added Enrollment Server and check Allow option for the Enroll permission.
  • Click OK to save the template configuration.

horizon-saml-true-sso-setup-pt1-35

The created certificate template.

horizon-saml-true-sso-setup-pt1-36

Now right click the Enrollment Agent (Computer) template and select Properties.

horizon-saml-true-sso-setup-pt1-37

In the Security tab, add your Enroll Server and check Allow option for the Enroll permission.

horizon-saml-true-sso-setup-pt1-38

Right-click Certificate Templates and select New > Certificate Template to Issue.

horizon-saml-true-sso-setup-pt1-39

Select the previously created template (True SSO in the example) and click OK.

horizon-saml-true-sso-setup-pt1-40

Right-click Certificate Templates and select New > Certificate Template to Issue once again.

horizon-saml-true-sso-setup-pt1-41

Select the Enrollment Agent (Computer) template and click OK.

horizon-saml-true-sso-setup-pt1-42

The configured certificate templates. If you have an existing CA in your network and you are configuring a subCA, delete all certificate templates except for the two new created templates.

horizon-saml-true-sso-setup-pt1-43

 

Install the certificate to the Enrollment Server

Now you need to import the certificate in your Enrollment Server.

Login to the Enrollment Server and from the Run window run the certlm.msc command to open the Certification console. Click OK.

horizon-saml-true-sso-setup-pt1-44

Right click Personal and select All Tasks > Request New Certificate.

horizon-saml-true-sso-setup-pt1-45

Click Next.

horizon-saml-true-sso-setup-pt1-46

Select Active Directory Enrollment Policy (default) and click Next.

horizon-saml-true-sso-setup-pt1-47

Select Enrollment Agent (Computer) and click Enroll.

horizon-saml-true-sso-setup-pt1-48

Click Finish.

horizon-saml-true-sso-setup-pt1-49

The certificate has been installed successfully.

horizon-saml-true-sso-setup-pt1-50

Part 2 will cover the export/import procedure of the certificate and the configuration of SAML authentication in the UAG.

signature

Leave a Reply