Set Up Smart Card Redirection on a RHEL 7.9 Virtual Machine

To configure smart card redirection on a RHEL 7.9 virtual machine (VM), install the libraries on which the feature depends and the root Certificate Authority (CA) certificate required for authentication. In addition, you must edit some configuration files to complete the authentication setup.

To set up smart card redirection on a RHEL 7.9 VM, use the following procedure.

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.

Note: If you use the vSphere console to log in to a RHEL 7.9. VM that has Horizon Agent installed and smart card redirection enabled, you might experience a delayed logout time of two minutes or longer. This delayed logout only occurs from the vSphere console. The RHEL 7.9 logout experience from Horizon Client is not affected.

Prerequisites

Integrate a RHEL 7.9 Virtual Machine with Active Directory for Smart Card Redirection

Procedure

1. Install the required libraries.

   sudo yum install nss-tools nss-pam-ldapd esc pam_pkcs11 pam_krb5 opensc pcsc-lite-ccid authconfig 
         authconfig-gtk krb5-libs krb5-workstation krb5-pkinit pcsc-lite pcsc-lite-libs
   
   

2. Install a root CA certificate.

   1. Download a root CA certificate and save it to /tmp/certificate.cer on your desktop. See How to Export Root Certification Authority Certificate.

   2. Locate the root CA certificate that you downloaded, and transfer it to a .pem file.

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

   3. Use the certutil command to install the root CA certificate to the system database /etc/pki/nssdb.

      Replace "root CA cert" in the following example command with the name of the root CA certificate in the system database.

      sudo certutil -A -d /etc/pki/nssdb -n "root CA cert" -t "CT,C,C" -i /tmp/certificate.pem
      

3. Navigate to Applications > Sundry > Authentication, select the Enable smart card support check box, and click Apply.

4. Edit the module setting in the /etc/pam_pkcs11/pam_pkcs11.conf configuration file, as shown in the following example.

   use_pkcs11_module = coolkey;
   ...
   pkcs11_module coolkey {
         module = libcoolkeypk11.so;                
         description = "Cool Key";
         slot_num = 0;
         nss_dir = /etc/pki/nssdb;
         cert_policy = ca, signature;
   }
   

5. Edit the /etc/pam_pkcs11/cn_map file so that it includes content similar to the following example. For the specific content to include, refer to the user information listed in the smart card certificate.

   user sc -> user-sc
   

6. Edit the /etc/krb5.conf/ configuration file, as shown in the following example.

   [libdefaults]
         dns_lookup_realm = false
         ticket_lifetime = 24h
         renew_lifetime = 7d
         forwardable = true
         rdns = false
         default_realm = MYDOMAIN.COM
         default_ccache_name = KEYRING:persistent:%{uid}
   
   [realms]
         MYDOMAIN.COM = {
               kdc = ads-hostname
               admin_server = ads-hostname
               default_domain = ads-hostname
               pkinit_anchors = FILE:/etc/pki/nssdb/certificate.pem
               pkinit_cert_match = <KU>digitalSignature
               pkinit_kdc_hostname = ads-hostname
         }
   
   [domain_realm]
         .mydomain.com = MYDOMAIN.COM
         mydomain.com = MYDOMAIN.COM
   

7. If the VM is running the MATE desktop environment, add the line auth include smartcard-auth to the beginning of the /etc/pam.d/mate-screensaver as shown in the following example.

   #%PAM-1.0
    
   # Fedora Core
   auth include smartcard-auth            
   auth       include      system-auth
   auth       optional     pam_gnome_keyring.so
   account    include      system-auth
   password   include      system-auth
   session    include      system-auth
   
   

   You must perform this configuration to ensure that users can unlock the screen when logging in with a smart card.

8. To support the smart card single sign-on (SSO) feature, configure the viewagent-greeter.conf file. See Setting Options in Configuration Files on a Linux Desktop.

9. Restart the PC/SC daemon.

   sudo chkconfig pcscd on
   sudo service pcscd start
   

10. Install the Horizon Agent package, with smart card redirection enabled.

    sudo ./install_viewagent.sh -m yes
    

    Note: If you get an error message instructing you to install the default PC/SC Lite library, uninstall the custom PC/SC Lite library that is currently present on the machine and install the default PC/SC Lite library using the following command.

    yum reinstall pcsc-lite-libs pcsc-lite
    

    You can then run the Horizon Agent installer.

11. If you are using a custom PC/SC Lite library, configure the pcscd.maxReaderContext and pcscd.readBody options in the config file.

    See Setting Options in Configuration Files on a Linux Desktop.

12. Restart the VM and log back in.