Configure True SSO for RHEL and Rocky Linux 9.x/8.x Desktops

To support True SSO on a RHEL or Rocky Linux 9.x/8.x desktop, you must first integrate the base virtual machine (VM) with your Active Directory (AD) domain. Then you must modify certain configurations on the system to support the True SSO feature.

Note: To ensure that an existing True SSO configuration continues to work after a Horizon 8 upgrade, you may need to modify /etc/sssd/sssd.conf. For more information, see Upgrading to Omnissa Horizon 8 2412 and Later.

Some examples in the procedure use placeholder values to represent entities in your network configuration, such as the DNS name of your AD domain. Replace the placeholder values with information specific to your configuration, as described in the following table.

Prerequisites

• Configure True SSO for Omnissa Access and Horizon Connection Server.

• Verify that the Active Directory (AD) server is resolvable by DNS on the base VM.

• Configure the host name of the VM.

• Configure the Network Time Protocol (NTP) on the VM.

• Get a root Certificate Authority (CA) certificate and save it to /tmp/certificate.cer on the VM. See How to Export Root Certification Authority Certificate.

  If a subordinate CA is also an issuing authority, then get the entire chain of root and subordinate CA certificates and save it to /tmp/certificate.cer on the VM.

• To use True SSO in FIPS mode, ensure that you have completed all the steps described in Configure a FIPS-compliant Linux Machine. You must add the trusted CA certificate for BlastServer to /etc/omnissa/ssl/rui.crt and add the key paired with rui.crt to /etc/omnissa/ssl/rui.key.

Procedure

1. On the base VM, verify the network connection to Active Directory.

   sudo dnf install -y realmd
   sudo realm discover *mydomain.com*
   

2. Install the required dependency packages.

   sudo yum install oddjob oddjob-mkhomedir sssd sssd-tools adcli samba-common-tools krb5-pkinit
   

3. Join the AD domain.

   sudo realm join --verbose *mydomain.com* -U administrator
   

4. Install the root CA certificate or certificate chain.

   1. Locate the root CA certificate or certificate chain that you downloaded, and transfer it to a PEM file.

      sudo openssl x509 -inform der -in /tmp/certificate.cer -out /tmp/certificate.pem
      
      

   2. Copy the certificate to the /etc/sssd/pki/sssd_auth_ca_db.pem file.

      sudo cp /tmp/certificate.pem /etc/sssd/pki/sssd_auth_ca_db.pem
      

5. Modify the /etc/sssd/sssd.conf configuration file, as shown in the following example.

   [sssd]
   domains = *mydomain.com*
   config_file_version = 2
   services = nss, pam
    
   [domain/mydomain.com]
   ad_domain = *mydomain.com*
   krb5_realm = *MYDOMAIN.COM*
   realmd_tags = manages-system joined-with-adcli
   cache_credentials = True
   id_provider = ad
   krb5_store_password_if_offline = True
   default_shell = /bin/bash
   ldap_id_mapping = True
   use_fully_qualified_names = False             #Use short name for user
   fallback_homedir = /home/%u@%d
   access_provider = ad
   ad_gpo_map_interactive = +gdm-hzncred         #Add this line for SSO
    
   [pam]                                         #Add pam section for certificate logon
   pam_cert_auth = True                          #Add this line to enable certificate logon for system
   pam_p11_allowed_services = +gdm-hzncred       #Add this line to enable certificate logon for Horizon Agent
    
   [certmap/*mydomain.com*/truesso]                #Add this section and following lines to set match and map rule for certificate user
   matchrule = <EKU>msScLogin
   maprule = (|(userPrincipal={subject_principal})(samAccountName={subject_principal.short_name}))
   domains = *mydomain.com*
   priority = 10
   

6. Modify the /etc/krb5.conf configuration file by setting the mode equal to 644.

   Note: If you do not modify /etc/krb5.conf as specified, the True SSO feature might not work.

7. (RHEL or Rocky Linux 9.x) To ensure that TrueSSO works properly with instant-clone desktop pools, modify the following configurations.

   Note: You can skip these configurations if you are not using the VM for an instant-clone desktop pool.

   1. Run the command to explicitly allow the SHA-1 cryptographic policy.

      sudo update-crypto-policies --set DEFAULT:SHA1
      

   2. Locate the root CA certificate or certificate chain that you downloaded earlier, and copy it to /etc/pki/ca-trust/source/anchors/ca_cert.pem. Then use the update-ca-trust command to enable legacy applications to read the trusted certificates.

      sudo cp /tmp/certificate.pem /etc/pki/ca-trust/source/anchors/ca_cert.pem
      sudo update-ca-trust
      

   3. Modify the /etc/krb5.conf file, as shown in the following example.

      [realms]
           MYDOMAIN.COM = {
                kdc =  dnsserver.mydomain.com
                admin_server =  dnsserver.mydomain.com
                pkinit_anchors = DIR:/etc/pki/ca-trust/source/anchors
                pkinit_kdc_hostname =  dnsserver.mydomain.com
                pkinit_eku_checking = kpServerAuth
           }
      [domain_realm]
           .mydomain.com = MYDOMAIN.COM
           mydomain.com = MYDOMAIN.COM
      

8. Install the Horizon Agent package, with True SSO enabled.

   sudo ./install_viewagent.sh -T yes
   

9. Modify the /etc/omnissa/viewagent-custom.conf configuration file so that it includes the following line.

   NetbiosDomain = *MYDOMAIN*
   

10. Restart the VM and log back in.